Available lists
| List | What it surfaces | Refresh |
|---|---|---|
hot | Tokens with the fastest growth in unique buyers + volume in the last 1h / 24h | 1 min |
new | Freshly-created tokens passing minimum liquidity and holder checks | block-level |
migrated | Tokens that recently migrated from a launchpad to a full DEX | 1 min |
final-stretch | Launchpad tokens approaching migration thresholds | 1 min |
stock-like | Tokens with behaviour profiles similar to traditional equities (low vol, steady accumulation) | hourly |
top-gainers, top-losers | Price movers over 1h / 24h / 7d windows | 5 min |
Access
REST
/v2/ranking/{chain}/hottokens/{duration}, /v2/ranking/{chain}/newtokens, /v2/ranking/{chain}/migrated, /v2/ranking/{chain}/finalstretch, /v2/ranking/{chain}/stocks.WebSocket
dex-ranking-list:{chain}_{ranking_type} for membership; dex-ranking-token-stats-list:{chain}_{channelType} for live per-token stats. SDK: client.stream.subscribeRankingTokensList / subscribeRankingTokensStats.MCP
market_trending tool — common entry-point for discovery agents.CLI
chainstream market trending --chain solana --duration 24hCommon use cases
- “What’s hot right now?” home-page widget
- New-token sniper feeds
- Agent-driven daily-digest reports
- Seeding backtests with real historical lists (via the replay endpoint)
Billing
Each list call is 1 read unit regardless of list size (lists are capped).Next
Tokens
Look up each ranked token for full metadata and security.
Price-alert bot tutorial
Uses Rankings + WebSocket end-to-end.