CRIUS Docs
API status Get API key
Holders & traders

Top traders

Top traders with PnL

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

Traders of the token ranked by PnL, realized PnL, volume, buys or ROI over a window (1h, 24h, 7d, all), with wallet tags: dev, sniper, whale, smart_account (EIP-7702 wallets), the app for app wallets (fomo), exchange, contract.

  • tag: only traders with any of these tags (comma list), e.g. tag=smart_account or tag=fomo.
  • exclude: leave out traders with any of these tags, e.g. exclude=dev,sniper,exchange for outside traders only.
  • Program contracts (bots, vaults, routers) are left out by default: top traders are wallets. include_contracts=true adds them back (or tag=contract for contracts only). Smart accounts are wallets and always included unless excluded.
Average cost; USD at trade time; unrealized at current price.

Path parameters

chainstringrequired

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

addressstringrequired

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

Query parameters

sortstring Default pnl

Sort order. One of pnl, realized_pnl, volume, buys, roi.

windowstring Default all

Stats window. One of 1h, 24h, 7d, all.

tagstring

Only wallets with this tag (sniper, bot, whale, fresh, dev, insider, bundler, top_trader). Only these tags, comma list: dev, sniper, whale, smart_account, fomo, exchange, contract, ….

excludestring

Comma list of holder classes to leave out, such as infra (pools, lockers, burn) or bots. Leave out these tags, comma list, e.g. dev,sniper,exchange.

include_contractsboolean Default false

Program contracts are excluded by default.

limitinteger Default 50

Maximum number of items to return.

cursorstring

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

Guides that use this endpoint

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.Find a token's top traders and their PnLRank the traders of any Robinhood Chain token by PnL, volume, buys or ROI, with wallet tags, gas and hold time. A real example with the PnL math explained.

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}/holders/historyHolder count historyStarter · 10 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