Skip to main content
The Rankings data product is a set of opinionated, continuously-recomputed token lists. Each list is a discovery surface: the logic behind it is documented so you can decide whether it fits your use case.

​
Available lists

See API Reference → Rankings for the full list of endpoints and parameters.

​
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 24h

​
Common 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.