CRIUS

Token holders API

Robinhood Chain token holders API

Crius returns the holders of any token on Robinhood Chain, live or as they were at any past block, time or market cap, valued at that moment's price. It also answers the harder questions: who held through a window, who bought before a given market cap and is still holding, and how the holder count changed over time.

Get a free API key API reference
  • History from block 0
  • REST + WebSocket
  • Free plan: 1M credits / month
  • Robinhood Chain · chain ID 4663

Try it

Real requests, real responses

Captured from the live API, trimmed for length. Replace $CRIUS_API_KEY with your key; calls without that header work keyless at 2 requests a second.

Top holders of CHARGE right now Real response, trimmed
Request 
curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/holders?limit=3" \
  -H "x-api-key: $CRIUS_API_KEY"
Response 
{
  "data": {
    "count": 194,
    "distribution": {
      "top10_pct": 89.0087
    },
    "holders": [
      {
        "address": "0x8366a39cc670b4001a1121b8f6a443a643e40951",
        "balance": 609267303.9882199,
        "label": "uniswap_v4_pool_manager",
        "pct": 60.9267,
        "rank": 1,
        "value_eth": 1.4165,
        "value_usd": 3340.67
      },
      {
        "address": "0x267444d099b10fb5ed7c3cc7b7c767adca574952",
        "balance": 81632653.06122449,
        "label": "pons_v2_launch_locker",
        "pct": 8.16327,
        "rank": 2,
        "value_eth": 0.18979,
        "value_usd": 449.133
      },
      {
        "address": "0xcae68632857541d7b625f5af57149a77c80b15f7",
        "balance": 35961843.24134238,
        "label": null,
        "pct": 3.59618,
        "rank": 3,
        "value_eth": 0.0836087,
        "value_usd": 197.858
      }
    ]
  },
  "meta": {
    "block": 96714192,
    "block_ts": 1792839655000,
    "finalized_block": 96703786,
    "lag_ms": 121,
    "safe_block": 96707359
  }
}

Infrastructure is labeled (the Uniswap v4 PoolManager, the Pons launch locker), so you can tell real holders from contracts at a glance.

Holders at graduation, compared with now Real response, trimmed
Request 
curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/holders/snapshot?at=graduation&compare_to=now&limit=2" \
  -H "x-api-key: $CRIUS_API_KEY"
Response 
{
  "data": {
    "snapshot": {
      "at": "graduation",
      "block": 88461321,
      "ts": 1791990423100
    },
    "holders_count": 209,
    "price_at_snapshot": {
      "eth": 2.05843e-8,
      "eth_usd": 2428.34,
      "usd": 0.0000499856
    },
    "holders": [
      {
        "rank": 1,
        "address": "0x8366a39cc670b4001a1121b8f6a443a643e40951",
        "balance": 226984823.93388164,
        "pct": 22.6985,
        "label": "uniswap_v4_pool_manager",
        "compare": {
          "balance_now": 609267303.9882199,
          "change": 382282480.0543383,
          "change_pct": 168.418,
          "status": "increased",
          "to": "now"
        }
      },
      {
        "rank": 2,
        "address": "0x267444d099b10fb5ed7c3cc7b7c767adca574952",
        "balance": 81632653.06122449,
        "pct": 8.16327,
        "label": "pons_v2_launch_locker",
        "compare": {
          "balance_now": 81632653.06122449,
          "change": 0,
          "change_pct": 0,
          "status": "unchanged",
          "to": "now"
        }
      }
    ]
  }
}

at accepts block:N, ts:, mcap: (first, last or ATH crossing), launch, trading_open, graduation, ath and now.

What you get

Built for Robinhood Chain, not bolted on

  • Every ERC-20

    Balances for every token on the chain, rebuilt from transfers since block one and checked on-chain (balances: verified_onchain).

  • Snapshots anywhere in time

    Holders at a block, a timestamp, the moment market cap first crossed $50k, launch, graduation or the all-time high.

  • Diamond-hand cohorts

    Wallets that stayed above a size threshold for a whole window; filter by entry point and sort by hold time, balance or PnL.

  • Holder count history

    Holder count per interval with your own threshold (minimum balance or USD), for growth charts and min/max questions.

  • Labels, not just addresses

    Pools, lockers, burn addresses, the creator and infrastructure are labeled, and exclude=infra removes them.

  • Concentration

    Top-10 share with and without infrastructure, so a locked LP doesn't look like a whale.

Endpoints

The calls behind it

Base URL https://api.crius.sh, chain segment robinhood (or 4663). Every response is {data, meta} with the block it reflects.

EndpointReturnsPlanCredits
GET /v1/{chain}/token/{address}/holders Current holders ranked by balance, with labels and USD value Free+ 2
GET /v1/{chain}/token/{address}/holders/snapshot Holders at a past point (block, time, market cap, launch, graduation) Free+ 5
GET /v1/{chain}/token/{address}/holders/cohort Wallets that held through a window, with entry market cap and PnL Starter+ 10
GET /v1/{chain}/token/{address}/holders/history Holder count over time with your own holder definition Starter+ 10

Use cases

  • Holder pages in explorers and terminals
  • Airdrop and snapshot tooling
  • Distribution and concentration checks
  • Community and diamond-hand analysis
  • Due diligence before listing

Plans and limits

Live holders: Free plan, 2 credits. Snapshots: Free plan, 5 credits. Cohorts and holder history: Starter plan, 10 credits.

See pricing Plans, limits & credits

Questions about the Token holders API

Can I get the holders of a token at a past block?

Yes: /holders/snapshot with at=block:N (or ts:<ms>, mcap:<usd>, launch, graduation, ath). Balances are valued at that moment's price, and compare_to=now adds each holder's change since then.

How do I find wallets that bought early and still hold?

Use a snapshot at an early point (for example at=mcap:50000) with compare_to=now, or a cohort with entered_before=mcap:50000 to list wallets that held continuously since.

How is a holder defined for the history chart?

You choose: min_balance or min_usd, so dust wallets don't inflate the count.

Does it work for every token?

Yes, for every ERC-20 on Robinhood Chain, including tokenized stocks and launchpad tokens, with history back to each token's first transfer.

Are pools and lockers counted as holders?

They appear in the list with labels (pool, locker, burn, creator). Concentration is reported both with and without them, and exclude=infra removes them from snapshots.

Related APIs

Guides and articles

Documentation

Holders & traders reference → All Robinhood Chain APIs → Compare providers →

Start with the free plan

1,000,000 credits a month, no card. Your key in under a minute.

Get a free API key Try the playground