CRIUS Docs
API status Get API key
Holders & traders

Holder snapshot

Holders at a past point

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

Holders as they were at a past point, valued at that moment's price. compare_to=now adds each holder's balance change since then, which answers "who bought before $50k market cap, and are they still holding?".

Valued at that moment's price; compare_to=now adds change per holder.

Path parameters

chainstringrequired

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

addressstringrequired

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

Query parameters

atstring Default trading_open

The point in time to look at (see the forms above). One of block:N, ts:MS, mcap:USD, launch, trading_open, graduation, ath, now.

mcap_crossingstring Default first

Which crossing of the market cap level to use. One of first, last.

compare_tostring Default now

Add each holder's change since another point (now or any at form).

excludestring

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

min_usdnumber

Only items worth at least this many USD.

min_pctnumber

Minimum share of supply, in percent.

tagstring

Only wallets with this tag (sniper, bot, whale, fresh, dev, insider, bundler, top_trader).

limitinteger Default 100

Maximum number of items to return.

cursorstring

Pagination cursor from the previous response's meta.next_cursor.

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.Find holders who held through a run (holder cohorts)Find wallets that bought a Robinhood Chain token early and held through the run, with hold time, entry market cap, sells and PnL per wallet. Real example.What is the best Robinhood Chain data API? How to choose oneHow to choose a Robinhood Chain data API: nine criteria, from launchpads and realized taxes to WebSockets and free plans, and a sourced provider comparison.

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}/holdersLive holdersFree · 2 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