Token - List (V1)

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

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

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

{
  "success": true,
  "data": {
    "updateUnixTime": 1754885276,
    "updateTime": "2025-08-11T04:07:56.945Z",
    "tokens": [
      {
        "isScaledUiToken": false,
        "multiplier": null,
        "address": "So11111111111111111111111111111111111111112",
        "decimals": 9,
        "price": 185.45023454574132,
        "lastTradeUnixTime": 1754885221,
        "liquidity": 23349538049.2037,
        "logoURI": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
        "mc": 100058305776.50261,
        "name": "Wrapped SOL",
        "symbol": "SOL",
        "v24hChangePercent": -1.4820129368250423,
        "v24hUSD": 9515832024.915321
      }
    ],
    "total": 298068
  }
}

GET

defi

tokenlist

Token - List (V1)

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

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

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

{
  "success": true,
  "data": {
    "updateUnixTime": 1754885276,
    "updateTime": "2025-08-11T04:07:56.945Z",
    "tokens": [
      {
        "isScaledUiToken": false,
        "multiplier": null,
        "address": "So11111111111111111111111111111111111111112",
        "decimals": 9,
        "price": 185.45023454574132,
        "lastTradeUnixTime": 1754885221,
        "liquidity": 23349538049.2037,
        "logoURI": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
        "mc": 100058305776.50261,
        "name": "Wrapped SOL",
        "symbol": "SOL",
        "v24hChangePercent": -1.4820129368250423,
        "v24hUSD": 9515832024.915321
      }
    ],
    "total": 298068
  }
}

Usage Note
Accessibility
Chain Supported

Legacy token directory list.

This is the lighter token-list endpoint for broad token browsing on one chain.
limit supports 1 to 50 items per request.
sort_by supports mc, v24hUSD, v24hChangePercent, and liquidity.
min_liquidity defaults to 100, which helps filter low-signal assets from the default result set.
ui_amount_mode affects token-amount fields where chain-specific scaled balances are relevant.

Compute Unit ⚙️

This endpoint consumes 30 CU per request.

Use Cases 💡

Build token registries, simple token explorers, and asset-picking dropdowns.
Power lightweight ranked lists by liquidity, market cap, or 24h volume.
Preload token identity and summary rows before deeper market-data calls.
Support simple browse flows where V3 screening would be overkill.

How to Use 🛠️

Set x-chain for the target network.
Choose sort_by and sort_type for the ranking you want.
Page with offset and limit, keeping limit at 50 or below.
Use min_liquidity and optional max_liquidity to bound the result set.

Best Practices ✅

Treat this as a browse endpoint, not a full screener; move to V3 when you need richer filters.
Keep min_liquidity explicit in production screens so result quality stays predictable.
Cache token-list pages briefly when multiple users are likely to hit the same leaderboard view.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

A chain name listed in supported networks.

Available options:

solana,

ethereum,

bsc,

base,

robinhood,

sui,

mantle,

hyperevm,

arbitrum,

avalanche,

optimism,

polygon,

zksync,

monad,

aptos,

fogo,

megaeth

Query Parameters

sort_by

enum<string>

default:v24hUSD

required

Specify the sort field.

Available options:

mc,

v24hUSD,

v24hChangePercent,

liquidity

sort_type

enum<string>

default:desc

required

Specify the sort order.

Available options:

desc,

asc

offset

integer

default:0

Specify the offset for pagination. Filter for records with offset greater than the specified offset value, including those with offset equal to the specified offset.

limit

integer

default:50

Number of items per page.

Required range: 1 <= x <= 50

min_liquidity

number

default:100

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

Required range: x >= 0

max_liquidity

number

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

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 tokens with certain fields

success

boolean

required

Whether the request completed successfully.

data

object

required

Paged token-list payload with ranking metadata and token rows.

Show child attributes