CRIUS Docs
API status Get API key
Holders & traders

Live holders

Live holder list

GET https://api.crius.sh/v1/{chain}/token/{address}/holders
Free and above 2 credits per call Updated Oct 28, 2026

The current holder list, ranked by balance, with each holder's share of supply, USD value and labels (pools, lockers, burn addresses, the dev). Also returns the holder count and top-10 concentration.

Path parameters

chainstringrequired

Chain slug (robinhood) or chain id (4663).

addressstringrequired

Contract or wallet address, any case (0x…, 20 bytes).

Query parameters

limitinteger Default 100

Maximum number of items to return. Up to 500.

excludestring

Comma list of holder classes to leave out, such as infra (pools, lockers, burn) or bots.

Key response fields

  • count, top10_pct
  • holders[]: rank, address, balance, pct, value_usd, value_eth, label

Guides that use this endpoint

Get the holders of a Robinhood Chain token (token holders API)Robinhood Chain token holders API: get any token's top holders in one call, with balance, share of supply, USD value, labels, holder count and top-10 share.Get a token's holders at a past block, time or market capGet a Robinhood Chain token's holders at any past block, time, market cap or launch stage, valued at that moment's price, with cost basis per holder.Track a token's holder count over timeChart a Robinhood Chain token's holder count over time: min, max, new and exited holders per interval, with your own definition of a holder. Real example.Move from raw RPC calls to the Crius API on Robinhood ChainReplace eth_getLogs scans, slot0 math and Transfer replays with Crius API calls on Robinhood Chain: a mapping table, before/after code and credit costs.Get wallet token balances on Robinhood Chain (balances API)Get every token balance of a Robinhood Chain wallet (USDG, tokenized stocks, ETH) in USD in one call, one token's balances across wallets, and batch prices.

Errors

Errors come back as { "error": { "code", "message" } } with the matching HTTP status: 400 bad parameter, 401 missing or invalid key, 403 endpoint above your plan, 404 unknown token or address, 429 rate limit or credits used up (with Retry-After). See Errors.

More holders & traders endpoints

GET/token/{address}/holders/snapshotHolder snapshotFree · 5 crGET/token/{address}/holders/cohortHolder cohortStarter · 10 crGET/token/{address}/holders/historyHolder count historyStarter · 10 crGET/token/{address}/tradersTop tradersFree · 5 cr

Get your free Crius API key

Every example on this page works with a free key: higher rate limits than the anonymous plan, holders, wallets and the WebSocket stream. No card needed.

Get a free API key See plans
  • Robinhood Chain (4663) only, from our own archive nodes
  • REST + WebSocket
  • Pay on-chain or by card