Token - List (V3)

get

https://public-api.birdeye.so/defi/v3/token/list

Retrieve a list of tokens on a specified chain.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Token screener and ranked list endpoint.

This is the richer token-list endpoint with filtering across liquidity, market cap, FDV, holder count, recent listing time, last trade time, volume, price change, trade counts, and global fees paid.
limit supports 1 to 100 items per request and offset supports up to 10,000.
Default ranking is sort_by=liquidity with descending order.
Use ui_amount_mode when downstream token-amount fields need chain-aware scaled values.
This endpoint is designed for interactive screening; use the scroll variant when you need deeper crawling beyond normal pagination.

Compute Unit ⚙️

This endpoint consumes 75 CU per request.

Use Cases 💡

Build token screeners ranked by liquidity, market cap, activity, holder count, or recent price momentum.
Discover tradable assets that satisfy quality floors such as minimum liquidity or volume.
Power leaderboard pages, research dashboards, and filtered market boards.
Shortlist candidates before running price, security, holder, or smart-money analysis.

How to Use 🛠️

Set x-chain for the target network.
Choose a ranking field in sort_by and a direction in sort_type.
Apply only the filters needed for the screen, such as min_liquidity, min_market_cap, min_volume_24h_usd, or min_trade_24h_count.
Page with offset and limit, keeping limit at 100 or below.

Best Practices ✅

Start with a narrow filter set and add thresholds incrementally so you can see which condition removes too much of the market.
Keep ranking and filtering aligned; for example, pair momentum filters with momentum sort fields, not unrelated liquidity ordering.
For app UIs, use this endpoint for the first few pages and reserve scroll-based crawling for back-office jobs.

Query Params

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

min_global_fees_paid

number

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

offset

integer

0 to 10000

Defaults to 0

Pagination start position. offset + limit <= 10000

limit

integer

1 to 100

Defaults to 100

Number of items per page.

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