Balances

get

Lookup the list of accounts who hold this asset

Path parameters

asset-idintegerRequired

Query parameters

include-allbooleanOptional

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

limitintegerOptional

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

nextstringOptional

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

currency-greater-thanintegerOptional

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

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

200

(empty)

application/json

400

Response for errors

application/json

500

Response for errors

application/json

get

HTTPcURLJavaScriptPython

GET /v2/assets/{asset-id}/balances HTTP/1.1
Host: algo-index.nownodes.io
Accept: */*

{
  "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"
}