---
title: "Token - List (V3) Scroll"
method: GET
path: "/defi/v3/token/list/scroll"
tags: ["Token/Market List"]
---

# Token - List (V3) Scroll

`GET /defi/v3/token/list/scroll`

Retrieve up to 5,000 tokens per batch. For the first request, apply any filter parameters except scroll_id. For subsequent requests, provide only the scroll_id parameter using the next_scroll_id value returned previously. Limited to 1 scroll_id per account per 30 seconds.

## Query parameters

- `limit` integer
- `scroll_id` string
- `sort_by` 'liquidity' | 'market_cap' | 'fdv' | 'recent_listing_time' | 'last_trade_unix_time' | 'holder' | 'volume_1m_usd' | 'volume_5m_usd' | 'volume_30m_usd' | 'volume_1h_usd' | 'volume_2h_usd' | 'volume_4h_usd' | 'volume_8h_usd' | 'volume_24h_usd' | 'volume_7d_usd' | 'volume_30d_usd' | 'volume_1m_change_percent' | 'volume_5m_change_percent' | 'volume_30m_change_percent' | 'volume_1h_change_percent' | 'volume_2h_change_percent' | 'volume_4h_change_percent' | 'volume_8h_change_percent' | 'volume_24h_change_percent' | 'volume_7d_change_percent' | 'volume_30d_change_percent' | 'price_change_1m_percent' | 'price_change_5m_percent' | 'price_change_30m_percent' | 'price_change_1h_percent' | 'price_change_2h_percent' | 'price_change_4h_percent' | 'price_change_8h_percent' | 'price_change_24h_percent' | 'price_change_7d_percent' | 'price_change_30d_percent' | 'trade_1m_count' | 'trade_5m_count' | 'trade_30m_count' | 'trade_1h_count' | 'trade_2h_count' | 'trade_4h_count' | 'trade_8h_count' | 'trade_24h_count' | 'trade_7d_count' | 'trade_30d_count' | 'global_fees_paid', required
- `sort_type` 'desc' | 'asc', required
- `min_liquidity` number
- `max_liquidity` number
- `min_market_cap` number
- `max_market_cap` number
- `min_fdv` number
- `max_fdv` number
- `min_recent_listing_time` integer
- `max_recent_listing_time` integer
- `min_last_trade_unix_time` integer
- `max_last_trade_unix_time` integer
- `min_holder` integer
- `min_volume_1m_usd` number
- `min_volume_5m_usd` number
- `min_volume_30m_usd` number
- `min_volume_1h_usd` number
- `min_volume_2h_usd` number
- `min_volume_4h_usd` number
- `min_volume_8h_usd` number
- `min_volume_24h_usd` number
- `min_volume_7d_usd` number
- `min_volume_30d_usd` number
- `min_global_fees_paid` number
- `min_volume_1m_change_percent` number
- `min_volume_5m_change_percent` number
- `min_volume_30m_change_percent` number
- `min_volume_1h_change_percent` number
- `min_volume_2h_change_percent` number
- `min_volume_4h_change_percent` number
- `min_volume_8h_change_percent` number
- `min_volume_24h_change_percent` number
- `min_volume_7d_change_percent` number
- `min_volume_30d_change_percent` number
- `min_price_change_1m_percent` number
- `min_price_change_5m_percent` number
- `min_price_change_30m_percent` number
- `min_price_change_1h_percent` number
- `min_price_change_2h_percent` number
- `min_price_change_4h_percent` number
- `min_price_change_8h_percent` number
- `min_price_change_24h_percent` number
- `min_price_change_7d_percent` number
- `min_price_change_30d_percent` number
- `min_trade_1m_count` integer
- `min_trade_5m_count` integer
- `min_trade_30m_count` integer
- `min_trade_1h_count` integer
- `min_trade_2h_count` integer
- `min_trade_4h_count` integer
- `min_trade_8h_count` integer
- `min_trade_24h_count` integer
- `min_trade_7d_count` integer
- `min_trade_30d_count` integer
- `ui_amount_mode` 'raw' | 'scaled'

## Headers

- `x-chain` 'solana' | 'base' | 'bsc' | 'ethereum' | 'monad' | 'fogo' | 'mantle' | 'hyperevm' | 'megaeth' | 'robinhood'

## Response `200`

JSON object containing a list of token

- DefiTokenListV3ScrollResponse
  - `success` boolean, required
  - `data` object, required
    - `next_scroll_id` string
    - `scroll_time` string
    - `items` object[]
      - `address` string
      - `name` string
      - `symbols` string
      - `decimals` integer
      - `logo_uri` string
      - `market_cap` number
      - `fdv` number
      - `liquidity` number
      - `price` number
      - `holder` integer
      - `volume_1h_usd` number
      - `volume_1h_change_percent` number
      - `price_change_1h_percent` number
      - `trade_1h_count` integer
      - `volume_2h_usd` number
      - `volume_2h_change_percent` number
      - `price_change_2h_percent` number
      - `trade_2h_count` integer
      - `volume_4h_usd` number
      - `volume_4h_change_percent` number
      - `price_change_4h_percent` number
      - `trade_4h_count` integer
      - `volume_8h_usd` number
      - `volume_8h_change_percent` number
      - `price_change_8h_percent` number
      - `trade_8h_count` integer
      - `volume_24h_usd` number
      - `volume_24h_change_percent` number
      - `price_change_24h_percent` number
      - `trade_24h_count` integer
      - `recent_listing_time` integer
      - `global_fees_paid` number, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized. API key is missing or invalid
- `403` — Forbidden. Request is blacklisted or not whitelisted
- `429` — Too Many Requests. Rate limit reached
- `500` — Internal Server Error

---

[API](https://skmtc.net/birdeye/apis/birdeye-data-api.md) · [All operations](https://skmtc.net/birdeye/apis/birdeye-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/birdeye/birdeye-data-api/revisions/fcaba926a089/schema)