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;…
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
chainstringrequiredChain 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