Get Token Balances

List token balances.

This method will use 20 Compute Units.

---

List token balances

Returns a list of token balances given the id. This represents the Token supply distribution across the network

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/tokens/{tokenId}/balances

Path parameters

tokenId*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

Query parameters

Response

200400

OK

Body

application/json

timestampnullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

balancesTokenDistribution (array of object)

linksLinks (object)

Request

JavaScriptCurlPython

const response = await fetch('https://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/tokens/{tokenId}/balances', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "timestamp": "1586567700.453054000",
  "balances": [
    {
      "account": "0.15.2",
      "balance": 1000
    }
  ],
  "links": {
    "next": "/api/v1/transactions?timestamp=lt:1657598275.517984411"
  }
}