> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Rankings

> Curated token lists — hot, new, migrated, final-stretch, stock-like — ready for discovery UIs and agents.

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

| 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       |

See [API Reference → Rankings](/en/api-reference/endpoint/data/ranking/v2/ranking-chain-hottokens-duration-get) for the full list of endpoints and parameters.

## Access

<CardGroup cols={2}>
  <Card title="REST" icon="database" href="/en/api-reference/endpoint/data/ranking/v2/ranking-chain-hottokens-duration-get">
    `/v2/ranking/{chain}/hottokens/{duration}`, `/v2/ranking/{chain}/newtokens`, `/v2/ranking/{chain}/migrated`, `/v2/ranking/{chain}/finalstretch`, `/v2/ranking/{chain}/stocks`.
  </Card>

  <Card title="WebSocket" icon="bolt" href="/en/api-reference/endpoint/websocket/api">
    `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`.
  </Card>

  <Card title="MCP" icon="robot" href="/en/docs/ai-agents/mcp-server/introduction">
    `market_trending` tool — common entry-point for discovery agents.
  </Card>

  <Card title="CLI" icon="terminal" href="/en/docs/access-methods/cli">
    `chainstream market trending --chain solana --duration 24h`
  </Card>
</CardGroup>

## 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

<CardGroup cols={2}>
  <Card title="Tokens" icon="coins" href="/en/docs/data-products/tokens">
    Look up each ranked token for full metadata and security.
  </Card>

  <Card title="Price-alert bot tutorial" icon="graduation-cap" href="/en/docs/tutorials/build-price-alert-bot">
    Uses Rankings + WebSocket end-to-end.
  </Card>
</CardGroup>