Token - List (V3) Scroll

get

https://public-api.birdeye.so/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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

High-volume token crawl with scroll sessions.

Use this endpoint when normal offset pagination is not enough and you need to walk a large filtered token universe.
limit supports 1 to 5000 items per request.
Initial request: send your filters without scroll_id.
Subsequent requests: send only the returned scroll_id and continue the same crawl session.
Each account is limited by active scroll-session rules; an active scroll expires after about 30 seconds of inactivity, and an empty items page ends the session.

Compute Unit ⚙️

This endpoint consumes 400 CU per request.

Use Cases 💡

Crawl large token universes for offline indexing, warehousing, or scheduled refresh pipelines.
Export broad market slices that are too large for interactive offset pagination.
Build internal ranking datasets or research snapshots at chain scale.
Feed downstream enrichment jobs with token candidates from a consistent filtered population.

How to Use 🛠️

Set x-chain and send your initial filter set without scroll_id.
Store the returned next_scroll_id.
Continue by calling the same endpoint with that scroll_id.
Stop when items is empty, then start a new initial request if you need a fresh crawl.

Best Practices ✅

Treat scroll sessions as short-lived pipelines; consume pages promptly instead of leaving them idle.
Use stable filters for one crawl session so downstream datasets stay internally consistent.
Reserve this endpoint for backend jobs, not end-user UI pagination, because CU cost is high and session state is temporary.

Query Params

limit

integer

1 to 5000

Defaults to 5000

Number of items per page.

scroll_id

string

Assign scroll_id to continue fetching data from previous scroll request

sort_by

string

enum

required

Defaults to liquidity

Specify the sort field.

sort_type

string

enum

required

Defaults to desc

Specify the sort order.

Allowed:

min_liquidity

number

Specify the lower bound of liquidity. Filter for records with liquidity greater than the minimum liquidity value, including those with liquidity equal to the minimum.

max_liquidity

number

Specify the upper bound of liquidity. Filter for records with liquidity less than the maximum liquidity value, including those with liquidity equal to the maximum.

min_market_cap

number

Specify the lower bound of market cap. Filter for records with market cap greater than the minimum market cap value, including those with market cap equal to the minimum.

max_market_cap

number

Specify the upper bound of market cap. Filter for records with market cap less than the maximum market cap value, including those with market cap equal to the maximum.

min_fdv

number

Specify the lower bound of FDV. Filter for records with FDV greater than the minimum FDV value, including those with FDV equal to the minimum.

max_fdv

number

Specify the upper bound of FDV. Filter for records with FDV less than the maximum FDV value, including those with FDV equal to the maximum.

min_recent_listing_time

integer

1 to 10000000000

Specify the lower bound of recent listing time. Filter for records with recent listing time greater than the minimum recent listing time value, including those with recent listing time equal to the minimum.

max_recent_listing_time

integer

1 to 10000000000

Specify the upper bound of recent listing time. Filter for records with recent listing time less than the maximum recent listing time value, including those with recent listing time equal to the maximum.

min_last_trade_unix_time

integer

1 to 10000000000

Specify the lower bound of last trade time. Filter for records with last trade time greater than the minimum last trade time value, including those with last trade time equal to the minimum.

max_last_trade_unix_time

integer

1 to 10000000000

Specify the upper bound of last trade time. Filter for records with last trade time less than the maximum last trade time value, including those with last trade time equal to the maximum.

min_holder

integer

Specify the minimum number of holders. Filter for records with holder count greater than the minimum holder count value, including those with holder count equal to the minimum.

min_volume_1m_usd

number

Specify the minimum volume in the last minute. Filter for records with volume greater than the minimum volume value, including those with volume equal to the minimum.

min_volume_5m_usd

number

Specify the minimum volume in the last 5 minutes. Filter for records with volume greater than the minimum volume value, including those with volume equal to the minimum.

min_volume_30m_usd

number

Specify the minimum volume in the last 30 minutes. Filter for records with volume greater than the minimum volume value, including those with volume equal to the minimum.

min_volume_1h_usd

number

Specify the minimum volume in the last hour. Filter for records with volume greater than the minimum volume value, including those with volume equal to the minimum.

min_volume_2h_usd

number

Specify the minimum volume in the last two hours. Filter for records with volume greater than the minimum volume value, including those with volume equal to the minimum.

min_volume_4h_usd

number

Specify the minimum volume in the last four hours. Filter for records with volume greater than the minimum volume value, including those with volume equal to the minimum.

min_volume_8h_usd

number

Specify the minimum volume in the last eight hours. Filter for records with volume greater than the minimum volume value, including those with volume equal to the minimum.

min_volume_24h_usd

number

Specify the minimum volume in the last 24 hours. Filter for records with volume greater than the minimum volume value, including those with volume equal to the minimum.

min_volume_7d_usd

number

Specify the minimum volume in the last 7 days. Filter for records with volume greater than the minimum volume value, including those with volume equal to the minimum.

min_volume_30d_usd

number

Specify the minimum volume in the last 30 days. Filter for records with volume greater than the minimum volume value, including those with volume equal to the minimum.

min_global_fees_paid

number

Specify the minimum all-time global fee paid amount in SOL.

min_volume_1m_change_percent

number

Specify the minimum volume change percentage in the last minute. Filter for records with volume change percentage greater than the minimum volume change percentage value, including those with volume change percentage equal to the minimum.

min_volume_5m_change_percent

number

Specify the minimum volume change percentage in the last 5 minutes. Filter for records with volume change percentage greater than the minimum volume change percentage value, including those with volume change percentage equal to the minimum.

min_volume_30m_change_percent

number

Specify the minimum volume change percentage in the last 30 minutes. Filter for records with volume change percentage greater than the minimum volume change percentage value, including those with volume change percentage equal to the minimum.

min_volume_1h_change_percent

number

Specify the minimum volume change percentage in the last hour. Filter for records with volume change percentage greater than the minimum volume change percentage value, including those with volume change percentage equal to the minimum.

min_volume_2h_change_percent

number

Specify the minimum volume change percentage in the last two hours. Filter for records with volume change percentage greater than the minimum volume change percentage value, including those with volume change percentage equal to the minimum.

min_volume_4h_change_percent

number

Specify the minimum volume change percentage in the last four hours. Filter for records with volume change percentage greater than the minimum volume change percentage value, including those with volume change percentage equal to the minimum.

min_volume_8h_change_percent

number

Specify the minimum volume change percentage in the last eight hours. Filter for records with volume change percentage greater than the minimum volume change percentage value, including those with volume change percentage equal to the minimum.

min_volume_24h_change_percent

number

Specify the minimum volume change percentage in the last 24 hours. Filter for records with volume change percentage greater than the minimum volume change percentage value, including those with volume change percentage equal to the minimum.

min_volume_7d_change_percent

number

Specify the minimum volume change percentage in the last 7 days. Filter for records with volume change percentage greater than the minimum volume change percentage value, including those with volume change percentage equal to the minimum.

min_volume_30d_change_percent

number

Specify the minimum volume change percentage in the last 30 days. Filter for records with volume change percentage greater than the minimum volume change percentage value, including those with volume change percentage equal to the minimum.

min_price_change_1m_percent

number

Specify the minimum price change percentage in the last minute. Filter for records with price change percentage greater than the minimum price change percentage value, including those with price change percentage equal to the minimum.

min_price_change_5m_percent

number

Specify the minimum price change percentage in the last 5 minutes. Filter for records with price change percentage greater than the minimum price change percentage value, including those with price change percentage equal to the minimum.

min_price_change_30m_percent

number

Specify the minimum price change percentage in the last 30 minutes. Filter for records with price change percentage greater than the minimum price change percentage value, including those with price change percentage equal to the minimum.

min_price_change_1h_percent

number

Specify the minimum price change percentage in the last hour. Filter for records with price change percentage greater than the minimum price change percentage value, including those with price change percentage equal to the minimum.

min_price_change_2h_percent

number

Specify the minimum price change percentage in the last two hours. Filter for records with price change percentage greater than the minimum price change percentage value, including those with price change percentage equal to the minimum.

min_price_change_4h_percent

number

Specify the minimum price change percentage in the last four hours. Filter for records with price change percentage greater than the minimum price change percentage value, including those with price change percentage equal to the minimum.

min_price_change_8h_percent

number

Specify the minimum price change percentage in the last eight hours. Filter for records with price change percentage greater than the minimum price change percentage value, including those with price change percentage equal to the minimum.

min_price_change_24h_percent

number

Specify the minimum price change percentage in the last 24 hours. Filter for records with price change percentage greater than the minimum price change percentage value, including those with price change percentage equal to the minimum.

min_price_change_7d_percent

number

Specify the minimum price change percentage in the last 7 days. Filter for records with price change percentage greater than the minimum price change percentage value, including those with price change percentage equal to the minimum.

min_price_change_30d_percent

number

Specify the minimum price change percentage in the last 30 days. Filter for records with price change percentage greater than the minimum price change percentage value, including those with price change percentage equal to the minimum.

min_trade_1m_count

integer

Specify the minimum number of trades in the last minute. Filter for records with trade count greater than the minimum trade count value, including those with trade count equal to the minimum.

min_trade_5m_count

integer

Specify the minimum number of trades in the 5 minutes. Filter for records with trade count greater than the minimum trade count value, including those with trade count equal to the minimum.

min_trade_30m_count

integer

Specify the minimum number of trades in the last 30 minutes. Filter for records with trade count greater than the minimum trade count value, including those with trade count equal to the minimum.

min_trade_1h_count

integer

Specify the minimum number of trades in the last hour. Filter for records with trade count greater than the minimum trade count value, including those with trade count equal to the minimum.

min_trade_2h_count

integer

Specify the minimum number of trades in the last two hours. Filter for records with trade count greater than the minimum trade count value, including those with trade count equal to the minimum.

min_trade_4h_count

integer

Specify the minimum number of trades in the last four hours. Filter for records with trade count greater than the minimum trade count value, including those with trade count equal to the minimum.

min_trade_8h_count

integer

Specify the minimum number of trades in the last eight hours. Filter for records with trade count greater than the minimum trade count value, including those with trade count equal to the minimum.

min_trade_24h_count

integer

Specify the minimum number of trades in the last 24 hours. Filter for records with trade count greater than the minimum trade count value, including those with trade count equal to the minimum.

min_trade_7d_count

integer

Specify the minimum number of trades in the last 7 days. Filter for records with trade count greater than the minimum trade count value, including those with trade count equal to the minimum.

min_trade_30d_count

integer

Specify the minimum number of trades in the last 30 days. Filter for records with trade count greater than the minimum trade count value, including those with trade count equal to the minimum.

ui_amount_mode

string

enum

Defaults to scaled

Indicate whether to use the scaled amount for scaled ui amount tokens. Only support solana

Allowed:

Headers

x-chain

string

enum

Defaults to solana

Solana, Base, BSC, Ethereum, Monad, Fogo, Mantle, Hyperevm, Megaeth, Robinhood network.

Responses

200JSON object containing a list of token

400Bad Request

401Unauthorized. API key is missing or invalid

403Forbidden. Request is blacklisted or not whitelisted

429Too Many Requests. Rate limit reached

500Internal Server Error