Get Token Balances
List token balances.
This method will use 20
Compute Units.
Returns a list of token balances given the id. This represents the Token supply distribution across the network
Path parameters
tokenIdstring | nullableRequiredExample:
Network entity ID in the format of shard.realm.num
0.1.2
Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$
Query parameters
account.balancestringOptionalExample:
The optional balance value to compare against
{"summary":"--","value":""}
Pattern: ^((gte?|lte?|eq|ne)\:)?\d{1,10}$
account.idstringOptionalExample:
The ID of the account to return information for
{"summary":"--","value":""}
Pattern: ^((gte?|lte?|eq|ne)\:)?(\d{1,10}\.\d{1,10}\.)?\d{1,10}$
account.publickeystringOptionalExample:
The account's public key to compare against
3c3d546321ff6f63d701d2ec5c277095874e19f4a235bee1e6bb19258bf362be
limitinteger · int32 · min: 1 · max: 100OptionalDefault:
The maximum number of items to return
25
Example: 2
orderundefined · enumOptionalDefault:
The order in which items are listed
asc
Example: desc
Possible values: timestampstring[]OptionalExample:
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
{"summary":"--","value":""}
Responses
200
OK
application/json
400
Invalid parameter
application/json
get
GET /v1/YOUR_API_KEY/api/v1/tokens/{tokenId}/balances HTTP/1.1
Host: mainnet.hedera.validationcloud.io
Accept: */*
{
"timestamp": "1586567700.453054000",
"balances": [
{
"account": "0.15.2",
"balance": 1000
}
],
"links": {
"next": "/api/v1/transactions?timestamp=lt:1657598275.517984411"
}
}
Last updated
Was this helpful?