API Endpoints

Token - List (V1)

get
https://public-api.birdeye.so/defi/tokenlist

Retrieve a list of tokens on a specified chain.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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.

Query Params
string
enum
required
Defaults to v24hUSD

Specify the sort field.

Allowed:
string
enum
required
Defaults to desc

Specify the sort order.

Allowed:
integer
Defaults to 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.

integer
1 to 50
Defaults to 50

Number of items per page.

number
≥ 0
Defaults to 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.

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.

string
enum
Defaults to scaled

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

Allowed:
Headers
string
enum
Defaults to solana

A chain name listed in supported networks.

Responses

Updated 15 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 15 days ago

Did this page help you?