Get Token Holders

Returns a paginated list of all addresses holding a specific token, along with their balances.

GET /v2/{chain_name}/tokens/{token_address}/holders

Get Token Holders

cURL

curl --request GET \
  --url https://api.data.ormilabs.com/v2/{chain_name}/tokens/{token_address}/holders \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "holders": [
    {
      "address": "0x312e67b47a2a29ae200184949093d92369f80b53",
      "balance": 123123.1321321,
      "balance_raw": "1231231321321",
      "percentage": 40.12
    }
  ],
  "token": {
    "address": "0x312e67b47a2a29ae200184949093d92369f80b53",
    "decimals": 7,
    "name": "Bacacacac",
    "standard": "ERC-20",
    "symbol": "BAC"
  },
  "total_holders": 1000,
  "next_cursor": "ICJkYXNkYXMifQ=="
}

Authorizations

Authorization · string · header · required

Enter your API key in the format: Bearer <api_key>. Providing an API key may grant higher rate limits or access to additional features. The API will function without an API key for basic access.

Path Parameters

token_address · string · required

The token contract address.

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"

chain_name · enum<string> · required

The name or ID of the blockchain.

Available options: ethereum, apechain, arbitrum, avalanche, base, bsc, polygon

Example:

"ethereum"

Query Parameters

sort_by · enum<string> · default: most_holdings

Sort order for results.

Available options: most_holdings, least_holdings

limit · integer · default: 50

Maximum number of items to return.

Required range: 1 <= x <= 1000

cursor · string

Cursor for pagination to retrieve the next set of results.

Response

200

application/json

Successfully retrieved token holders.

holders · object[] · required

Show child attributes

token · object · required

Show child attributes

total_holders · integer<int64> · required

Example:

1000

next_cursor · string

Example:

"ICJkYXNkYXMifQ=="