Home

Indexer

v1.0.0
Base URL
https://algo-index.nownodes.io

Algorand ledger analytics API.

Authentication

api-keyAuthapiKey

API Key: api-key in header

Indexer

Health

Returns 200 if healthy.

GET
https://algo-index.nownodes.io/health

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

(empty)

default

Unknown Error

Accounts

GET
https://algo-index.nownodes.io/v2/accounts

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Search for accounts.

Parameters

asset-idintegerquery

Asset ID

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

currency-greater-thanintegerquery

Results 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-allbooleanquery

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

excludeArray<string>allassetscreated-assetsapps-local-statecreated-appsnonequery

Exclude 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-thanintegerquery

Results 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-addrstringquery

Include accounts configured to use this spending key.

roundintegerquery

Include 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-idintegerquery

Application ID

Response

200OK

(empty)

400Bad Request

Response for errors

500Internal Server Error

Response for errors

GET
https://algo-index.nownodes.io/v2/accounts/{account-id}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup account information.

Parameters

account-idstringrequiredpath

account string

roundintegerquery

Include results for the specified round.

include-allbooleanquery

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

excludeArray<string>allassetscreated-assetsapps-local-statecreated-appsnonequery

Exclude 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

200OK

(empty)

400Bad Request

Response for errors

404Not Found

Response for errors

500Internal Server Error

Response for errors

GET
https://algo-index.nownodes.io/v2/accounts/{account-id}/apps-local-state

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup an account's asset holdings, optionally for a specific ID.

Parameters

account-idstringrequiredpath

account string

application-idintegerquery

Application ID

include-allbooleanquery

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

Response

200OK

(empty)

400Bad Request

Response for errors

404Not Found

Response for errors

500Internal Server Error

Response for errors

GET
https://algo-index.nownodes.io/v2/accounts/{account-id}/assets

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup an account's asset holdings, optionally for a specific ID.

Parameters

account-idstringrequiredpath

account string

asset-idintegerquery

Asset ID

include-allbooleanquery

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

Response

200OK

(empty)

400Bad Request

Response for errors

404Not Found

Response for errors

500Internal Server Error

Response for errors

GET
https://algo-index.nownodes.io/v2/accounts/{account-id}/created-applications

Authorizations

ApiKeyAuthApiKeyAuth

api-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-idstringrequiredpath

account string

application-idintegerquery

Application ID

include-allbooleanquery

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

Response

200OK

(empty)

400Bad Request

Response for errors

404Not Found

Response for errors

500Internal Server Error

Response for errors

GET
https://algo-index.nownodes.io/v2/accounts/{account-id}/created-assets

Authorizations

ApiKeyAuthApiKeyAuth

api-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-idstringrequiredpath

account string

asset-idintegerquery

Asset ID

include-allbooleanquery

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

Response

200OK

(empty)

400Bad Request

Response for errors

404Not Found

Response for errors

500Internal Server Error

Response for errors

GET
https://algo-index.nownodes.io/v2/accounts/{account-id}/transactions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup account transactions. Transactions are returned newest to oldest.

Parameters

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

note-prefixstringquery

Specifies a prefix which must be contained in the note field.

tx-typestringpaykeyregacfgaxferafrzapplstpfquery
sig-typestringsigmsiglsigquery

SigType filters just results using the specified type of signature:

  • sig - Standard
  • msig - MultiSig
  • lsig - LogicSig
txidstringquery

Lookup the specific transaction by ID.

roundintegerquery

Include results for the specified round.

min-roundintegerquery

Include results at or after the specified min-round.

max-roundintegerquery

Include results at or before the specified max-round.

asset-idintegerquery

Asset ID

before-timestring<date-time>query

Include results before the given time. Must be an RFC 3339 formatted string.

after-timestring<date-time>query

Include results after the given time. Must be an RFC 3339 formatted string.

currency-greater-thanintegerquery

Results 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-thanintegerquery

Results 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-idstringrequiredpath

account string

rekey-tobooleanquery

Include results which include the rekey-to field.

Response

200OK

(empty)

400Bad Request

Response for errors

500Internal Server Error

Response for errors

Applications

GET
https://algo-index.nownodes.io/v2/applications

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Search for applications

Parameters

application-idintegerquery

Application ID

creatorstringquery

Filter just applications with the given creator address.

include-allbooleanquery

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

Response

200OK

(empty)

500Internal Server Error

Response for errors

GET
https://algo-index.nownodes.io/v2/applications/{application-id}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup application.

Parameters

application-idintegerrequiredpath
include-allbooleanquery

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

Response

200OK

(empty)

404Not Found

Response for errors

500Internal Server Error

Response for errors

Get box information for a given application.

GET
https://algo-index.nownodes.io/v2/applications/{application-id}/box

Authorizations

ApiKeyAuthApiKeyAuth

api-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-idintegerrequiredpath
namestringrequiredquery

A 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

200OK

Box information

400Bad Request

Response for errors

404Not Found

Response for errors

500Internal Server Error

Response for errors

Get box names for a given application.

GET
https://algo-index.nownodes.io/v2/applications/{application-id}/boxes

Authorizations

ApiKeyAuthApiKeyAuth

api-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-idintegerrequiredpath
limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

Response

200OK

Box names of an application

400Bad Request

Response for errors

404Not Found

Response for errors

500Internal Server Error

Response for errors

GET
https://algo-index.nownodes.io/v2/applications/{application-id}/logs

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup application logs.

Parameters

application-idintegerrequiredpath
limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

txidstringquery

Lookup the specific transaction by ID.

min-roundintegerquery

Include results at or after the specified min-round.

max-roundintegerquery

Include results at or before the specified max-round.

sender-addressstringquery

Only include transactions with this sender address.

Response

200OK

(empty)

Assets

GET
https://algo-index.nownodes.io/v2/assets

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Search for assets.

Parameters

include-allbooleanquery

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

creatorstringquery

Filter just assets with the given creator address.

namestringquery

Filter just assets with the given name.

unitstringquery

Filter just assets with the given unit.

asset-idintegerquery

Asset ID

Response

200OK

(empty)

400Bad Request

Response for errors

500Internal Server Error

Response for errors

GET
https://algo-index.nownodes.io/v2/assets/{asset-id}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup asset information.

Parameters

asset-idintegerrequiredpath
include-allbooleanquery

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

Response

200OK

(empty)

400Bad Request

Response for errors

404Not Found

Response for errors

500Internal Server Error

Response for errors

GET
https://algo-index.nownodes.io/v2/assets/{asset-id}/balances

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup the list of accounts who hold this asset

Parameters

include-allbooleanquery

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

currency-greater-thanintegerquery

Results 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-thanintegerquery

Results 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-idintegerrequiredpath

Response

200OK

(empty)

400Bad Request

Response for errors

500Internal Server Error

Response for errors

GET
https://algo-index.nownodes.io/v2/assets/{asset-id}/transactions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup transactions for an asset. Transactions are returned oldest to newest.

Parameters

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

note-prefixstringquery

Specifies a prefix which must be contained in the note field.

tx-typestringpaykeyregacfgaxferafrzapplstpfquery
sig-typestringsigmsiglsigquery

SigType filters just results using the specified type of signature:

  • sig - Standard
  • msig - MultiSig
  • lsig - LogicSig
txidstringquery

Lookup the specific transaction by ID.

roundintegerquery

Include results for the specified round.

min-roundintegerquery

Include results at or after the specified min-round.

max-roundintegerquery

Include results at or before the specified max-round.

before-timestring<date-time>query

Include results before the given time. Must be an RFC 3339 formatted string.

after-timestring<date-time>query

Include results after the given time. Must be an RFC 3339 formatted string.

currency-greater-thanintegerquery

Results 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-thanintegerquery

Results 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.

addressstringquery

Only include transactions with this address in one of the transaction fields.

address-rolestringsenderreceiverfreeze-targetquery

Combine with the address parameter to define what type of address to search for.

exclude-close-tobooleanquery

Combine 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-idintegerrequiredpath
rekey-tobooleanquery

Include results which include the rekey-to field.

Response

200OK

(empty)

400Bad Request

Response for errors

500Internal Server Error

Response for errors

Blocks

GET
https://algo-index.nownodes.io/v2/blocks/{round-number}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup block.

Parameters

round-numberintegerrequiredpath

Round number

header-onlybooleanquery

Header only flag. When this is set to true, returned block does not contain the transactions

Response

200OK

(empty)

404Not Found

Response for errors

500Internal Server Error

Response for errors

Transactions

GET
https://algo-index.nownodes.io/v2/transactions

Authorizations

ApiKeyAuthApiKeyAuth

api-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

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

note-prefixstringquery

Specifies a prefix which must be contained in the note field.

tx-typestringpaykeyregacfgaxferafrzapplstpfquery
sig-typestringsigmsiglsigquery

SigType filters just results using the specified type of signature:

  • sig - Standard
  • msig - MultiSig
  • lsig - LogicSig
txidstringquery

Lookup the specific transaction by ID.

roundintegerquery

Include results for the specified round.

min-roundintegerquery

Include results at or after the specified min-round.

max-roundintegerquery

Include results at or before the specified max-round.

asset-idintegerquery

Asset ID

before-timestring<date-time>query

Include results before the given time. Must be an RFC 3339 formatted string.

after-timestring<date-time>query

Include results after the given time. Must be an RFC 3339 formatted string.

currency-greater-thanintegerquery

Results 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-thanintegerquery

Results 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.

addressstringquery

Only include transactions with this address in one of the transaction fields.

address-rolestringsenderreceiverfreeze-targetquery

Combine with the address parameter to define what type of address to search for.

exclude-close-tobooleanquery

Combine 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-tobooleanquery

Include results which include the rekey-to field.

application-idintegerquery

Application ID

Response

200OK

(empty)

400Bad Request

Response for errors

500Internal Server Error

Response for errors

GET
https://algo-index.nownodes.io/v2/transactions/{txid}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup a single transaction.

Parameters

txidstringrequiredpath

Response

200OK

(empty)

400Bad Request

Response for errors

404Not Found

Response for errors

500Internal Server Error

Response for errors