Skip to main content

Holders

Token Holders​

Returns a paginated list of token holders for the specified token

Request units: 10

GET /v0/{chain_id}/tokens/{contract_address}/holders

Query Parameters​

  • min_amount: Minimum token amount filter
  • max_amount: Maximum token amount filter
  • limit: Number of results per page (default: 50. max 100)
  • offset: Pagination offset

Success Response​

{
    "holder_count": 2431,
    "total": 112,
    "holders": [
        {
            "address": "geYb1s...",
            "amount": 19451200,
            "rank": 1
        },
        {
            "address": "HeK2s1...",
            "amount": 18200400,
            "rank": 2
        },
    ]
}

holder_count is the total current number of token holders. total is the total filtered and paged token holders amount

note

Only the top 1000 holders are available via this method

Holder Deltas​

Returns holder changes over different time periods.

Request units: 20

GET /v0/{chain_id}/tokens/{token_address}/holders/deltas

Success Response​

{
    "7days": -12,
    "14days": 100,
    "30days": 150
}

Holder Breakdowns​

Returns holder statistics categorized by holding value.

Request units: 50

GET /v0/{chain_id}/tokens/{token_address}/holders/breakdowns

Success Response​

{
    "total_holders": 78395,
    "holders_over_10_usd": 47138,
    "holders_over_100_usd": 27229,
    "holders_over_1000_usd": 8494,
    "holders_over_10000_usd": 1857,
    "holders_over_100k_usd": 469,
    "holders_over_1m_usd": 92,
    "categories": {
        "shrimp": 31257,
        "crab": 19909,
        "fish": 18735,
        "dolphin": 6637,
        "whale": 1857
    }
}