CRIUS Docs
API status Get API key
Holders & traders

Holder cohort

Who held through a window

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

Wallets that held through a window. A holder qualifies when it stayed above a size threshold (min_usd, min_balance or min_pct); with continuous=true it must hold for the whole window, and reset_on decides what breaks continuity (sell by default). entered_before=mcap:20000 keeps only wallets that first qualified before that point. Sort by hold time, balance or entry market cap (sort=hold_time|balance|entry_mcap).

Continuity with reset on sell / decrease / below threshold.

Path parameters

chainstringrequired

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

addressstringrequired

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

Query parameters

fromstring Default trading_open

Start of the window (block:, ts:, mcap: or a label).

tostring Default now

End of the window (same forms as from).

min_usdnumber Default 50

Only items worth at least this many USD.

min_balancenumber

Minimum balance in token units.

min_pctnumber

Minimum share of supply, in percent.

continuousboolean Default false

true: the holder must stay above the threshold for the whole window.

reset_onstring Default sell

One of sell, any_decrease, below_threshold, none.

min_hold_sinteger

Minimum continuous hold time inside the window, in seconds.

entered_beforestring

Only holders that first qualified before this point (e.g. mcap:20000).

excludestring

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

sortstring Default hold_time

Sort order. One of hold_time, balance, entry_mcap.

limitinteger Default 100

Maximum number of items to return.

Guides that use this endpoint

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.

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/snapshotHolder snapshotFree · 5 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