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...",
            "spl_token_account": "xrR31s...",
            "amount": 19451200,
            "rank": 1
        },
        {
            "address": "HeK2s1...",
            "spl_token_account": "L83sHb...",
            "amount": 18200400,
            "rank": 2
        },
    ]
}

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

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
    }
}