Liquidity Latest - Token
curl --request POST \
--url https://public-api.birdeye.so/defi/v3/liquidity/latest/token \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"addresses": [
"2RaLR1kY37bbNfqWTK49AiCbPtdF27497jZ6DatKpump"
]
}
'import requests
url = "https://public-api.birdeye.so/defi/v3/liquidity/latest/token"
payload = { "addresses": ["2RaLR1kY37bbNfqWTK49AiCbPtdF27497jZ6DatKpump"] }
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({addresses: ['2RaLR1kY37bbNfqWTK49AiCbPtdF27497jZ6DatKpump']})
};
fetch('https://public-api.birdeye.so/defi/v3/liquidity/latest/token', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"items": [
{
"token": "2RaLR1kY37bbNfqWTK49AiCbPtdF27497jZ6DatKpump",
"liquidity_usd": 0.431778300255171,
"exit_liquidity_usd": 0.143926100085057,
"stable_liquidity_usd": 0.287852200170114,
"price": 0.00002468
}
]
}
}{
"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"
}Price & OHLCV
Liquidity Latest - Token
Latest total, exit, and stable liquidity, plus price, for Solana tokens. Lite plans can request one address; Starter and above can request up to 100.
POST
/
defi
/
v3
/
liquidity
/
latest
/
token
Liquidity Latest - Token
curl --request POST \
--url https://public-api.birdeye.so/defi/v3/liquidity/latest/token \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"addresses": [
"2RaLR1kY37bbNfqWTK49AiCbPtdF27497jZ6DatKpump"
]
}
'import requests
url = "https://public-api.birdeye.so/defi/v3/liquidity/latest/token"
payload = { "addresses": ["2RaLR1kY37bbNfqWTK49AiCbPtdF27497jZ6DatKpump"] }
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({addresses: ['2RaLR1kY37bbNfqWTK49AiCbPtdF27497jZ6DatKpump']})
};
fetch('https://public-api.birdeye.so/defi/v3/liquidity/latest/token', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"items": [
{
"token": "2RaLR1kY37bbNfqWTK49AiCbPtdF27497jZ6DatKpump",
"liquidity_usd": 0.431778300255171,
"exit_liquidity_usd": 0.143926100085057,
"stable_liquidity_usd": 0.287852200170114,
"price": 0.00002468
}
]
}
}{
"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
Latest liquidity snapshot for one or many Solana tokens.
- Send token mints in the POST body under
addresses. - The request accepts
1to100addresses after deduplication. - Lite plans can request only one address; multi-address requests require Starter or higher.
- This endpoint returns the latest total, exit, and stable liquidity together with the latest price context.
- Lite
- Starter
- Premium
- Business
- Enterprise
Solana
Compute Unit ⚙️
Compute Unit ⚙️
- Batch CU is calculated as
ceil(5 * token_count^0.8).
Use Cases 💡
Use Cases 💡
- Fetch the newest liquidity snapshot for one or many tokens before ranking or screening them.
- Power token tables that need current liquidity alongside current price.
- Detect sudden drops in exit liquidity or stable liquidity before they show up in slower dashboards.
- Pre-check market depth quality before routing further analysis or trading actions.
How to Use 🛠️
How to Use 🛠️
- Set
x-chain=solana. - Send
addressesin the POST body. - Keep the body at
100addresses or fewer, and expect Lite plans to work only with a single address. - Use liquidity history or liquidity OHLC endpoints when you need a time series instead of the latest snapshot.
Best Practices ✅
Best Practices ✅
- Deduplicate token mints before sending the batch so you do not waste request capacity.
- Use this endpoint as a cheap liquidity prefilter before more expensive historical analysis.
- Surface total liquidity and exit liquidity separately in UI because they answer different risk questions.
Limitations ⚠️
Limitations ⚠️
- Solana only.
Authorizations
API key for authentication
Headers
Solana network only.
Available options:
solana Body
application/json
Lite packages can request one address. Starter and higher packages can request up to 100 addresses.
Required array length:
1 - 100 elementsExample:
[
"2RaLR1kY37bbNfqWTK49AiCbPtdF27497jZ6DatKpump"
]
Was this page helpful?

