Token - List (V3)

curl --request GET \
  --url https://public-api.birdeye.so/defi/v3/token/list \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/defi/v3/token/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "items": [
      {
        "address": "So11111111111111111111111111111111111111112",
        "logo_uri": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
        "name": "Wrapped SOL",
        "symbol": "SOL",
        "decimals": 9,
        "extensions": {
          "coingecko_id": "solana",
          "serum_v3_usdc": "9wFFyRfZBsuAha4YcuxcXLKwMxJR43S7fPfQLusDBzvT",
          "serum_v3_usdt": "HWHvQhFmJB3NUcu1aihKmrKegfVxBEHzwVX6yZCKEsi1",
          "website": "https://solana.com/",
          "telegram": null,
          "twitter": "https://twitter.com/solana",
          "description": "Wrapped Solana ",
          "discord": "https://discordapp.com/invite/pquxPsq",
          "medium": "https://medium.com/solana-labs"
        },
        "market_cap": 47804731539.07422,
        "fdv": 52235322779.27986,
        "total_supply": 620122784.8312707,
        "circulating_supply": 567524075.143289,
        "liquidity": 5022039892.110555,
        "last_trade_unix_time": 1770719861,
        "volume_1m_usd": 5391130.519996273,
        "volume_5m_usd": 28359800.05996658,
        "volume_30m_usd": 204986981.09311706,
        "volume_1m_change_percent": -7.179022227208377,
        "volume_5m_change_percent": -41.473980089148036,
        "volume_30m_change_percent": -27.375926305902265,
        "volume_1h_usd": 463249920.4345513,
        "volume_1h_change_percent": -10.711726491059386,
        "volume_2h_usd": 954270205.9201734,
        "volume_2h_change_percent": -6.883129860766711,
        "volume_4h_usd": 1952318583.0152369,
        "volume_4h_change_percent": -17.06915667365536,
        "volume_8h_usd": 4089123147.485524,
        "volume_8h_change_percent": -12.566952710315663,
        "volume_24h_usd": 12633047621.390213,
        "volume_24h_change_percent": -12.921308265029118,
        "volume_7d_usd": 106771633719.01566,
        "volume_7d_change_percent": 31.90021766177634,
        "volume_30d_usd": 391778461308.8114,
        "volume_30d_change_percent": 132.15573119504776,
        "trade_1m_count": 24331,
        "trade_5m_count": 119357,
        "trade_30m_count": 764052,
        "trade_1h_count": 1489737,
        "trade_2h_count": 3042558,
        "trade_4h_count": 6412259,
        "trade_8h_count": 12570622,
        "trade_24h_count": 36973993,
        "trade_7d_count": 258141842,
        "trade_30d_count": 1003628436,
        "buy_24h": 16481536,
        "buy_24h_change_percent": -0.9536171997725992,
        "volume_buy_24h_usd": 6302501622.213389,
        "volume_buy_24h_change_percent": -12.806383632452265,
        "buy_7d": 114379995,
        "buy_7d_change_percent": 7.715464699960623,
        "volume_buy_7d_usd": 53297726916.68083,
        "volume_buy_7d_change_percent": 32.49353523038235,
        "buy_30d": 431992822,
        "buy_30d_change_percent": 47.46342899958093,
        "volume_buy_30d_usd": 194545982041.11035,
        "volume_buy_30d_change_percent": 135.1685602170761,
        "sell_24h": 20492457,
        "sell_24h_change_percent": -2.2658535562879996,
        "volume_sell_24h_usd": 6330545999.176824,
        "volume_sell_24h_change_percent": -13.035405188202965,
        "sell_7d": 143761847,
        "sell_7d_change_percent": 2.7004638578022044,
        "volume_sell_7d_usd": 53473906802.33482,
        "volume_sell_7d_change_percent": 31.313993807692704,
        "sell_30d": 571635614,
        "sell_30d_change_percent": 42.041623270904104,
        "volume_sell_30d_usd": 197232479267.70108,
        "volume_sell_30d_change_percent": 129.25438596973004,
        "unique_wallet_24h": 1078316,
        "unique_wallet_24h_change_percent": 27.006090501244365,
        "price": 84.23383893802996,
        "price_change_1m_percent": 0.009695978575668942,
        "price_change_5m_percent": -0.11684480646276182,
        "price_change_30m_percent": -0.18244121670926866,
        "price_change_1h_percent": -0.4145320861606307,
        "price_change_2h_percent": 0.017801124275801165,
        "price_change_4h_percent": -1.4714631467113624,
        "price_change_8h_percent": -2.6402925798351617,
        "price_change_24h_percent": 1.3435381835763764,
        "price_change_7d_percent": -17.97571312121106,
        "price_change_30d_percent": -38.274858405973575,
        "holder": 5395501,
        "recent_listing_time": null,
        "global_fees_paid": 125.5,
        "is_scaled_ui_token": false,
        "multiplier": null
      }
    ],
    "hasNext": true
  }
}

GET

defi

token

list

Token - List (V3)

curl --request GET \
  --url https://public-api.birdeye.so/defi/v3/token/list \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/defi/v3/token/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "items": [
      {
        "address": "So11111111111111111111111111111111111111112",
        "logo_uri": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
        "name": "Wrapped SOL",
        "symbol": "SOL",
        "decimals": 9,
        "extensions": {
          "coingecko_id": "solana",
          "serum_v3_usdc": "9wFFyRfZBsuAha4YcuxcXLKwMxJR43S7fPfQLusDBzvT",
          "serum_v3_usdt": "HWHvQhFmJB3NUcu1aihKmrKegfVxBEHzwVX6yZCKEsi1",
          "website": "https://solana.com/",
          "telegram": null,
          "twitter": "https://twitter.com/solana",
          "description": "Wrapped Solana ",
          "discord": "https://discordapp.com/invite/pquxPsq",
          "medium": "https://medium.com/solana-labs"
        },
        "market_cap": 47804731539.07422,
        "fdv": 52235322779.27986,
        "total_supply": 620122784.8312707,
        "circulating_supply": 567524075.143289,
        "liquidity": 5022039892.110555,
        "last_trade_unix_time": 1770719861,
        "volume_1m_usd": 5391130.519996273,
        "volume_5m_usd": 28359800.05996658,
        "volume_30m_usd": 204986981.09311706,
        "volume_1m_change_percent": -7.179022227208377,
        "volume_5m_change_percent": -41.473980089148036,
        "volume_30m_change_percent": -27.375926305902265,
        "volume_1h_usd": 463249920.4345513,
        "volume_1h_change_percent": -10.711726491059386,
        "volume_2h_usd": 954270205.9201734,
        "volume_2h_change_percent": -6.883129860766711,
        "volume_4h_usd": 1952318583.0152369,
        "volume_4h_change_percent": -17.06915667365536,
        "volume_8h_usd": 4089123147.485524,
        "volume_8h_change_percent": -12.566952710315663,
        "volume_24h_usd": 12633047621.390213,
        "volume_24h_change_percent": -12.921308265029118,
        "volume_7d_usd": 106771633719.01566,
        "volume_7d_change_percent": 31.90021766177634,
        "volume_30d_usd": 391778461308.8114,
        "volume_30d_change_percent": 132.15573119504776,
        "trade_1m_count": 24331,
        "trade_5m_count": 119357,
        "trade_30m_count": 764052,
        "trade_1h_count": 1489737,
        "trade_2h_count": 3042558,
        "trade_4h_count": 6412259,
        "trade_8h_count": 12570622,
        "trade_24h_count": 36973993,
        "trade_7d_count": 258141842,
        "trade_30d_count": 1003628436,
        "buy_24h": 16481536,
        "buy_24h_change_percent": -0.9536171997725992,
        "volume_buy_24h_usd": 6302501622.213389,
        "volume_buy_24h_change_percent": -12.806383632452265,
        "buy_7d": 114379995,
        "buy_7d_change_percent": 7.715464699960623,
        "volume_buy_7d_usd": 53297726916.68083,
        "volume_buy_7d_change_percent": 32.49353523038235,
        "buy_30d": 431992822,
        "buy_30d_change_percent": 47.46342899958093,
        "volume_buy_30d_usd": 194545982041.11035,
        "volume_buy_30d_change_percent": 135.1685602170761,
        "sell_24h": 20492457,
        "sell_24h_change_percent": -2.2658535562879996,
        "volume_sell_24h_usd": 6330545999.176824,
        "volume_sell_24h_change_percent": -13.035405188202965,
        "sell_7d": 143761847,
        "sell_7d_change_percent": 2.7004638578022044,
        "volume_sell_7d_usd": 53473906802.33482,
        "volume_sell_7d_change_percent": 31.313993807692704,
        "sell_30d": 571635614,
        "sell_30d_change_percent": 42.041623270904104,
        "volume_sell_30d_usd": 197232479267.70108,
        "volume_sell_30d_change_percent": 129.25438596973004,
        "unique_wallet_24h": 1078316,
        "unique_wallet_24h_change_percent": 27.006090501244365,
        "price": 84.23383893802996,
        "price_change_1m_percent": 0.009695978575668942,
        "price_change_5m_percent": -0.11684480646276182,
        "price_change_30m_percent": -0.18244121670926866,
        "price_change_1h_percent": -0.4145320861606307,
        "price_change_2h_percent": 0.017801124275801165,
        "price_change_4h_percent": -1.4714631467113624,
        "price_change_8h_percent": -2.6402925798351617,
        "price_change_24h_percent": 1.3435381835763764,
        "price_change_7d_percent": -17.97571312121106,
        "price_change_30d_percent": -38.274858405973575,
        "holder": 5395501,
        "recent_listing_time": null,
        "global_fees_paid": 125.5,
        "is_scaled_ui_token": false,
        "multiplier": null
      }
    ],
    "hasNext": true
  }
}

Usage Note
Accessibility
Chain Supported

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

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

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

Available options:

solana,

base,

bsc,

ethereum,

monad,

fogo,

mantle,

hyperevm,

megaeth,

robinhood

Query Parameters

sort_by

enum<string>

default:liquidity

required

Specify the sort field.

Available options:

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

sort_type

enum<string>

default:desc

required

Specify the sort order.

Available options:

desc,

asc

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

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.

Required range: 1 <= x <= 10000000000

max_recent_listing_time

integer

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.

Required range: 1 <= x <= 10000000000

min_last_trade_unix_time

integer

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.

Required range: 1 <= x <= 10000000000

max_last_trade_unix_time

integer

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.

Required range: 1 <= x <= 10000000000

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

default:0

Pagination start position. offset + limit <= 10000

Required range: 0 <= x <= 10000

limit

integer

default:100

Number of items per page.

Required range: 1 <= x <= 100

ui_amount_mode

enum<string>

default:scaled

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

Available options:

raw,

scaled

Response

JSON object containing a list of token

success

boolean

required

Whether the request completed successfully.

data

object

required

Token-list payload with screener-style market, price, and activity metrics.

Show child attributes