Indexer
v1.0.0https://algo-index.nownodes.ioAlgorand ledger analytics API.
Authentication
api-keyAuthapiKeyAPI Key: api-key in header
Indexer
Health
Returns 200 if healthy.
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Response
(empty)
Unknown Error
Accounts
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Search for accounts.
Parameters
asset-idintegerqueryAsset ID
limitintegerqueryMaximum number of results to return. There could be additional pages even if the limit is not reached.
nextstringqueryThe next page of results. Use the next token provided by the previous results.
currency-greater-thanintegerqueryResults should have an amount greater than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.
include-allbooleanqueryInclude all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.
excludeArray<string>allassetscreated-assetsapps-local-statecreated-appsnonequeryExclude additional items such as asset holdings, application local data stored for this account, asset parameters created by this account, and application parameters created by this account.
currency-less-thanintegerqueryResults should have an amount less than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.
auth-addrstringqueryInclude accounts configured to use this spending key.
roundintegerqueryInclude results for the specified round. For performance reasons, this parameter may be disabled on some configurations. Using application-id or asset-id filters will return both creator and opt-in accounts. Filtering by include-all will return creator and opt-in accounts for deleted assets and accounts. Non-opt-in managers are not included in the results when asset-id is used.
application-idintegerqueryApplication ID
Response
(empty)
Response for errors
Response for errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Lookup account information.
Parameters
account-idstringrequiredpathaccount string
roundintegerqueryInclude results for the specified round.
include-allbooleanqueryInclude all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.
excludeArray<string>allassetscreated-assetsapps-local-statecreated-appsnonequeryExclude additional items such as asset holdings, application local data stored for this account, asset parameters created by this account, and application parameters created by this account.
Response
(empty)
Response for errors
Response for errors
Response for errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Lookup an account's asset holdings, optionally for a specific ID.
Parameters
account-idstringrequiredpathaccount string
application-idintegerqueryApplication ID
include-allbooleanqueryInclude all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.
limitintegerqueryMaximum number of results to return. There could be additional pages even if the limit is not reached.
nextstringqueryThe next page of results. Use the next token provided by the previous results.
Response
(empty)
Response for errors
Response for errors
Response for errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Lookup an account's asset holdings, optionally for a specific ID.
Parameters
account-idstringrequiredpathaccount string
asset-idintegerqueryAsset ID
include-allbooleanqueryInclude all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.
limitintegerqueryMaximum number of results to return. There could be additional pages even if the limit is not reached.
nextstringqueryThe next page of results. Use the next token provided by the previous results.
Response
(empty)
Response for errors
Response for errors
Response for errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Lookup an account's created application parameters, optionally for a specific ID.
Parameters
account-idstringrequiredpathaccount string
application-idintegerqueryApplication ID
include-allbooleanqueryInclude all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.
limitintegerqueryMaximum number of results to return. There could be additional pages even if the limit is not reached.
nextstringqueryThe next page of results. Use the next token provided by the previous results.
Response
(empty)
Response for errors
Response for errors
Response for errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Lookup an account's created asset parameters, optionally for a specific ID.
Parameters
account-idstringrequiredpathaccount string
asset-idintegerqueryAsset ID
include-allbooleanqueryInclude all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.
limitintegerqueryMaximum number of results to return. There could be additional pages even if the limit is not reached.
nextstringqueryThe next page of results. Use the next token provided by the previous results.
Response
(empty)
Response for errors
Response for errors
Response for errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Lookup account transactions. Transactions are returned newest to oldest.
Parameters
limitintegerqueryMaximum number of results to return. There could be additional pages even if the limit is not reached.
nextstringqueryThe next page of results. Use the next token provided by the previous results.
note-prefixstringquerySpecifies a prefix which must be contained in the note field.
tx-typestringpaykeyregacfgaxferafrzapplstpfquerysig-typestringsigmsiglsigquerySigType filters just results using the specified type of signature:
- sig - Standard
- msig - MultiSig
- lsig - LogicSig
txidstringqueryLookup the specific transaction by ID.
roundintegerqueryInclude results for the specified round.
min-roundintegerqueryInclude results at or after the specified min-round.
max-roundintegerqueryInclude results at or before the specified max-round.
asset-idintegerqueryAsset ID
before-timestring<date-time>queryInclude results before the given time. Must be an RFC 3339 formatted string.
after-timestring<date-time>queryInclude results after the given time. Must be an RFC 3339 formatted string.
currency-greater-thanintegerqueryResults should have an amount greater than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.
currency-less-thanintegerqueryResults should have an amount less than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.
account-idstringrequiredpathaccount string
rekey-tobooleanqueryInclude results which include the rekey-to field.
Response
(empty)
Response for errors
Response for errors
Applications
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Search for applications
Parameters
application-idintegerqueryApplication ID
creatorstringqueryFilter just applications with the given creator address.
include-allbooleanqueryInclude all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.
limitintegerqueryMaximum number of results to return. There could be additional pages even if the limit is not reached.
nextstringqueryThe next page of results. Use the next token provided by the previous results.
Response
(empty)
Response for errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Lookup application.
Parameters
application-idintegerrequiredpathinclude-allbooleanqueryInclude all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.
Response
(empty)
Response for errors
Response for errors
Get box information for a given application.
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Given an application ID and box name, returns base64 encoded box name and value. Box names must be in the goal app call arg form 'encoding:value'. For ints, use the form 'int:1234'. For raw bytes, encode base 64 and use 'b64' prefix as in 'b64:A=='. For printable strings, use the form 'str:hello'. For addresses, use the form 'addr:XYZ...'.
Parameters
application-idintegerrequiredpathnamestringrequiredqueryA box name in goal-arg form 'encoding:value'. For ints, use the form 'int:1234'. For raw bytes, use the form 'b64:A=='. For printable strings, use the form 'str:hello'. For addresses, use the form 'addr:XYZ...'.
Response
Box information
Response for errors
Response for errors
Response for errors
Get box names for a given application.
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Given an application ID, returns the box names of that application sorted lexicographically.
Parameters
application-idintegerrequiredpathlimitintegerqueryMaximum number of results to return. There could be additional pages even if the limit is not reached.
nextstringqueryThe next page of results. Use the next token provided by the previous results.
Response
Box names of an application
Response for errors
Response for errors
Response for errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Lookup application logs.
Parameters
application-idintegerrequiredpathlimitintegerqueryMaximum number of results to return. There could be additional pages even if the limit is not reached.
nextstringqueryThe next page of results. Use the next token provided by the previous results.
txidstringqueryLookup the specific transaction by ID.
min-roundintegerqueryInclude results at or after the specified min-round.
max-roundintegerqueryInclude results at or before the specified max-round.
sender-addressstringqueryOnly include transactions with this sender address.
Response
(empty)
Assets
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Search for assets.
Parameters
include-allbooleanqueryInclude all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.
limitintegerqueryMaximum number of results to return. There could be additional pages even if the limit is not reached.
nextstringqueryThe next page of results. Use the next token provided by the previous results.
creatorstringqueryFilter just assets with the given creator address.
namestringqueryFilter just assets with the given name.
unitstringqueryFilter just assets with the given unit.
asset-idintegerqueryAsset ID
Response
(empty)
Response for errors
Response for errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Lookup asset information.
Parameters
asset-idintegerrequiredpathinclude-allbooleanqueryInclude all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.
Response
(empty)
Response for errors
Response for errors
Response for errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Lookup the list of accounts who hold this asset
Parameters
include-allbooleanqueryInclude all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.
limitintegerqueryMaximum number of results to return. There could be additional pages even if the limit is not reached.
nextstringqueryThe next page of results. Use the next token provided by the previous results.
currency-greater-thanintegerqueryResults should have an amount greater than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.
currency-less-thanintegerqueryResults should have an amount less than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.
asset-idintegerrequiredpathResponse
(empty)
Response for errors
Response for errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Lookup transactions for an asset. Transactions are returned oldest to newest.
Parameters
limitintegerqueryMaximum number of results to return. There could be additional pages even if the limit is not reached.
nextstringqueryThe next page of results. Use the next token provided by the previous results.
note-prefixstringquerySpecifies a prefix which must be contained in the note field.
tx-typestringpaykeyregacfgaxferafrzapplstpfquerysig-typestringsigmsiglsigquerySigType filters just results using the specified type of signature:
- sig - Standard
- msig - MultiSig
- lsig - LogicSig
txidstringqueryLookup the specific transaction by ID.
roundintegerqueryInclude results for the specified round.
min-roundintegerqueryInclude results at or after the specified min-round.
max-roundintegerqueryInclude results at or before the specified max-round.
before-timestring<date-time>queryInclude results before the given time. Must be an RFC 3339 formatted string.
after-timestring<date-time>queryInclude results after the given time. Must be an RFC 3339 formatted string.
currency-greater-thanintegerqueryResults should have an amount greater than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.
currency-less-thanintegerqueryResults should have an amount less than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.
addressstringqueryOnly include transactions with this address in one of the transaction fields.
address-rolestringsenderreceiverfreeze-targetqueryCombine with the address parameter to define what type of address to search for.
exclude-close-tobooleanqueryCombine with address and address-role parameters to define what type of address to search for. The close to fields are normally treated as a receiver, if you would like to exclude them set this parameter to true.
asset-idintegerrequiredpathrekey-tobooleanqueryInclude results which include the rekey-to field.
Response
(empty)
Response for errors
Response for errors
Blocks
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Lookup block.
Parameters
round-numberintegerrequiredpathRound number
header-onlybooleanqueryHeader only flag. When this is set to true, returned block does not contain the transactions
Response
(empty)
Response for errors
Response for errors
Transactions
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Search for transactions. Transactions are returned oldest to newest unless the address parameter is used, in which case results are returned newest to oldest.
Parameters
limitintegerqueryMaximum number of results to return. There could be additional pages even if the limit is not reached.
nextstringqueryThe next page of results. Use the next token provided by the previous results.
note-prefixstringquerySpecifies a prefix which must be contained in the note field.
tx-typestringpaykeyregacfgaxferafrzapplstpfquerysig-typestringsigmsiglsigquerySigType filters just results using the specified type of signature:
- sig - Standard
- msig - MultiSig
- lsig - LogicSig
txidstringqueryLookup the specific transaction by ID.
roundintegerqueryInclude results for the specified round.
min-roundintegerqueryInclude results at or after the specified min-round.
max-roundintegerqueryInclude results at or before the specified max-round.
asset-idintegerqueryAsset ID
before-timestring<date-time>queryInclude results before the given time. Must be an RFC 3339 formatted string.
after-timestring<date-time>queryInclude results after the given time. Must be an RFC 3339 formatted string.
currency-greater-thanintegerqueryResults should have an amount greater than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.
currency-less-thanintegerqueryResults should have an amount less than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.
addressstringqueryOnly include transactions with this address in one of the transaction fields.
address-rolestringsenderreceiverfreeze-targetqueryCombine with the address parameter to define what type of address to search for.
exclude-close-tobooleanqueryCombine with address and address-role parameters to define what type of address to search for. The close to fields are normally treated as a receiver, if you would like to exclude them set this parameter to true.
rekey-tobooleanqueryInclude results which include the rekey-to field.
application-idintegerqueryApplication ID
Response
(empty)
Response for errors
Response for errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Lookup a single transaction.
Parameters
txidstringrequiredpathResponse
(empty)
Response for errors
Response for errors
Response for errors