Skip to main content
GET
/
v2
/
{chain_name}
/
tokens
/
{token_address}
/
holders
Get Token Holders
curl --request GET \
  --url https://api.data.ormilabs.com/v2/{chain_name}/tokens/{token_address}/holders \
  --header 'Authorization: Bearer <token>'
{
  "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

Successfully retrieved token holders.

​
holders
object[]
required
​
token
object
required
​
total_holders
integer<int64>
required
Example:

1000

​
next_cursor
string
Example:

"ICJkYXNkYXMifQ=="