CRIUS Docs
API status Get API key
Discovery & search

Token lists

Lists: new, bonding, graduating, graduated, trending, top_volume, top_gainers, top_losers, top_market_cap (tokens traded in the last 30 days by market cap;…

GET https://api.crius.sh/v1/{chain}/tokens
Anonymous and above (no key needed) 1 credit per call Runnable here Updated Oct 28, 2026

Lists: new, bonding, graduating, graduated, trending, top_volume, top_gainers, top_losers, top_market_cap (tokens traded in the last 30 days by market cap; prices from thin markets don't rank). Filter by launchpad, quote, min_liquidity_usd, min_volume_usd, min_market_cap_usd / max_market_cap_usd (e.g. min_market_cap_usd=100000) and created_after_ts; window picks the stats window. Up to 100 per page.

trending only lists clean tokens: no crash (price under 90% below its peak in the window), $1,000+ liquidity, real holders (20+, and at least 10% of the window's traders), no insider or wallet-farm launch, no bot distribution, no single wallet holding 40%+ of the liquidity unlocked. clean=true applies the same checks to any other list, e.g. list=top_volume&clean=true for volume leaders without rugs or wash trading.

trending ranks real demand: a token needs a price less than 90% below its peak in the window (rugs drop out), $1,000+ liquidity, 20+ holders, and holders at least 10% of the window's traders (wash trading spreads volume over wallets that don't keep the token), no insider launch (one wallet sniping 50%+ of supply in the first 10 blocks, or a wallet farm holding the supply), no bot distribution (25+ of the top 100 holders with near-identical balances), and no single wallet holding 40%+ of the liquidity unlocked (it could pull the market); see /security launch.

Path parameters

chainstringrequired

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

Query parameters

liststring Default trending

Which list to return. One of new, bonding, graduating, graduated, trending, top_volume, top_gainers, top_losers, top_market_cap.

windowstring

Stats window. From 1s to 24h.

launchpadstring

Launchpad id, such as pons or flap (see /launchpads).

quotestring

Quote asset of the token's main pool. One of eth, usdg.

min_liquidity_usdnumber

Only tokens with at least this much liquidity (USD).

min_volume_usdnumber

Only tokens with at least this much volume in the window (USD).

min_market_cap_usdnumber

E.g. 100000.

max_market_cap_usdnumber
created_after_tsinteger

Only tokens created after this time (unix ms).

cleanboolean Default false

Trending's quality filters on any list (no rugs, wash trading or insider launches)

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

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 discovery & search endpoints

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.

  • Robinhood Chain (4663) only, from our own archive nodes
  • REST + WebSocket
  • Pay on-chain or by card