Balances

Lookup the list of accounts who hold this asset

get

/v2/assets/{asset-id}/balances

Path parameters

asset-idintegerrequired

Query parameters

include-allboolean

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

limitinteger

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

nextstring

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

currency-greater-thaninteger

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

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.

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://algo-index.nownodes.io/v2/assets/{asset-id}/balances'

200

400

500

200

{
  "balances": [
    {
      "address": "text",
      "amount": 1,
      "deleted": true,
      "is-frozen": true,
      "opted-in-at-round": 1,
      "opted-out-at-round": 1
    }
  ],
  "current-round": 1,
  "next-token": "text"
}

(empty)