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
{
  "next_cursor": "ICJkYXNkYXMifQ==",
  "holders": [
    {
      "address": 2.807754160281623e+47,
      "balance": 123123.1321321,
      "balance_raw": "1231231321321",
      "percentage": 40.12
    }
  ],
  "token": {
    "address": 2.807754160281623e+47,
    "decimals": 7,
    "name": "Bacacacac",
    "standard": "ERC-20",
    "symbol": "BAC"
  },
  "total_holders": 1000
}

Authorizations

​
Authorization
string
header
required

(Optional) 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.

Example:

1.0970776880180083e+48

​
chain_name
enum<string>
required

The name or ID of the blockchain.

Available options:
ethereum
Example:

"ethereum"

Query Parameters

​
limit
integer
default:100

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.

The response is of type object.