Skip to content

lookupAssetBalances

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

Lookup the list of accounts who hold this asset

asset-id
required
integer
include-all
boolean

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

limit
integer

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

next
string

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

currency-greater-than
integer

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-than
integer

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.

(empty)

object
balances
required
Array<object>

A simplified version of AssetHolding

object
address
required
string
amount
required
integer
deleted

Whether or not this asset holding is currently deleted from its account.

boolean
is-frozen
required
boolean
opted-in-at-round

Round during which the account opted into the asset.

integer
opted-out-at-round

Round during which the account opted out of the asset.

integer
current-round
required

Round at which the results were computed.

integer
next-token

Used for pagination, when making another request provide this token with the next parameter.

string

Response for errors

object
data
object
message
required
string

Response for errors

object
data
object
message
required
string