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​

{
  "1hour": -10,
  "2hours": -15,
  "4hours": -22,
  "12hours": -24,
  "1day": 39,
  "3days": 13,
  "7days": -211,
  "14days": 200,
  "30days": 59
}

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

Individual Holder Stats​

Returns holder statistics for a specific wallet

Request units: 30

GET /v0/{chain_id}/tokens/{token_address}/stats/{wallet_address}

Success Response​

{
    "amount": 1164453,
    "holder_category": "whale",
    "avg_time_held": 11879064,
    "holding_breakdown": {
        "diamond": 917511,
        "gold": 246941,
        "silver": 0,
        "bronze": 0,
        "wood": 0
    },
    "unrealized_pnl": -21326.3697592433,
    "realized_pnl": 0
}