GET
/
v2
/
datasets
/
top_tokenholders
Get the Top tokenholders dataset
curl --request GET \
  --url https://api.tokenterminal.com/v2/datasets/top_tokenholders \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "project_name": "<string>",
    "project_id": "<string>",
    "market_sector_id": "<string>",
    "market_sector_name": "<string>",
    "chain_id": "<string>",
    "chain_name": "<string>",
    "token_symbol": "<string>",
    "token_address": "<string>",
    "account_address": "<string>",
    "account_title": "<string>",
    "position_creation_timestamp": "<string>",
    "transaction_count_sum": 123,
    "ownership_percentage_ath": 123,
    "account_balance_native_ath": 123,
    "account_balance_usd_ath": 123,
    "ownership_percentage": 123,
    "account_balance_native": 123,
    "account_balance_usd": 123,
    "ownership_percentage_30d_change": 123,
    "account_balance_native_30d_change": 123,
    "account_balance_usd_30d_change": 123,
    "account_balance_rank": 123
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
project_ids
string[]

Allows you to select one or more of the projects available in the dataset. When including multiple projects, separate each one with a comma. Example: uniswap,aave.

​
chain_ids
string[]

Allows you to select one or more of the chains available in the dataset. When including multiple chains, separate each one with a comma. Example: ethereum,arbitrum.

​
market_sector_ids
string[]

Allows you to select one or more of the market sectors available in the dataset. When including multiple market sectors, separate each one with a comma. Example: exchange,lending.

​
order_by
string

Allows you to select a field by which the response array is sorted.

​
order_direction
string

Allows you to define order direction for the field selected in order_by. If no order_direction is selected, the response defaults to asc.

​
limit
number

Limit the number of results returned. Usage through API reference has max limit of 50.

Response

200 - application/json

OK

The response is of type object.