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
Retrieve the latest total, exit, and stable liquidity with the latest price for Solana token addresses. Lite packages can request one address. Starter and higher packages can request up to 100 addresses.
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?

