Token - All Market List
curl --request GET \
--url https://public-api.birdeye.so/defi/v2/markets \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/defi/v2/markets"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://public-api.birdeye.so/defi/v2/markets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"items": [
{
"address": "Jito4APyf642JPZPx3hGc6WWJ8zPKtRbRs4P815Awbb",
"base": {
"address": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
"decimals": 9,
"symbol": "JitoSOL",
"icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fstorage.googleapis.com%2Ftoken-metadata%2FJitoSOL-256.png"
},
"createdAt": "2024-05-28T07:19:22.813Z",
"liquidity": 1733225301.1348372,
"name": "JitoSOL-SOL",
"price": null,
"quote": {
"address": "So11111111111111111111111111111111111111112",
"decimals": 9,
"icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
"symbol": "SOL"
},
"source": "Stake Pool",
"trade24h": 1021,
"trade24hChangePercent": 72.46621621621621,
"uniqueWallet24h": 382,
"uniqueWallet24hChangePercent": -13.769751693002258,
"volume24h": 7610352.270776577
}
],
"total": 1523
}
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}Token/Market List
Token - All Market List
Retrieve a list of markets for a specified token.
GET
/
defi
/
v2
/
markets
Token - All Market List
curl --request GET \
--url https://public-api.birdeye.so/defi/v2/markets \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/defi/v2/markets"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://public-api.birdeye.so/defi/v2/markets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"items": [
{
"address": "Jito4APyf642JPZPx3hGc6WWJ8zPKtRbRs4P815Awbb",
"base": {
"address": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
"decimals": 9,
"symbol": "JitoSOL",
"icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fstorage.googleapis.com%2Ftoken-metadata%2FJitoSOL-256.png"
},
"createdAt": "2024-05-28T07:19:22.813Z",
"liquidity": 1733225301.1348372,
"name": "JitoSOL-SOL",
"price": null,
"quote": {
"address": "So11111111111111111111111111111111111111112",
"decimals": 9,
"icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
"symbol": "SOL"
},
"source": "Stake Pool",
"trade24h": 1021,
"trade24hChangePercent": 72.46621621621621,
"uniqueWallet24h": 382,
"uniqueWallet24hChangePercent": -13.769751693002258,
"volume24h": 7610352.270776577
}
],
"total": 1523
}
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}- Usage Note
- Accessibility
- Chain Supported
Market list for a single token.
- Pass one token address to retrieve the markets or pools where that token trades.
limitsupports1to20items per request.sort_bysupportsliquidityandvolume24h.- Use this endpoint after token discovery when you need to inspect venue coverage for one asset.
- Standard
- Lite
- Starter
- Premium
- Business
- Enterprise
All chains ⛓️ ✨
Compute Unit ⚙️
Compute Unit ⚙️
- This endpoint consumes
20 CUper request.
Use Cases 💡
Use Cases 💡
- Discover where a token trades and which pools matter most.
- Compare markets by liquidity or 24h volume before charting or trade analysis.
- Support token detail pages that need a venue table or pool selector.
- Route users from token discovery into pair-level price, OHLCV, or liquidity analysis.
How to Use 🛠️
How to Use 🛠️
- Set
x-chainfor the target network. - Pass the token address in
address. - Choose
sort_by=liquidityorsort_by=volume24hdepending on whether depth or activity matters more. - Page with
offsetandlimit, keepinglimitat20or below.
Best Practices ✅
Best Practices ✅
- Start by sorting on liquidity for execution-focused workflows and on volume for attention-focused workflows.
- Join the selected market or pair into pair-level OHLCV and liquidity endpoints for deeper venue analysis.
- Cache venue tables briefly, since market composition changes more slowly than spot price.
Authorizations
API key for authentication
Headers
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
The address of the token contract.
Specify the sort order.
Available options:
desc, asc Specify the sort field.
Available options:
liquidity, volume24h 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.
Number of items per page.
Required range:
1 <= x <= 20Was this page helpful?

