CRIUS Docs
API status Get API key
Holders & traders

Holder count history

Holder count over time

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

Holder count over time at a chosen interval, with your own definition of a holder (min_balance or min_usd). Answers "what was the minimum and maximum number of holders during a period".

min / max / new / exited per interval.

Path parameters

chainstringrequired

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

addressstringrequired

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

Query parameters

intervalstring Default 1h

Bucket size. One of 1m, 5m, 15m, 1h, 4h, 1d.

fromstring

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

tostring

End of the window (same forms as from).

min_balancenumber

Minimum balance in token units.

min_usdnumber

Only items worth at least this many USD.

excludestring

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

Guides that use this endpoint

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.Robinhood Chain API for analytics dashboardsBuild Robinhood Chain dashboards with the Crius API: DEX volume without wash trades, TVL, launches per launchpad, hourly patterns and token charts.

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/cohortHolder cohortStarter · 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