curl --request GET \
--url https://public-api.birdeye.so/defi/v3/liquidity/history/token \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/defi/v3/liquidity/history/token"
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/v3/liquidity/history/token', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"items": [
{
"unix_time": 1778112000,
"liquidity_usd": 76897848464.11568,
"exit_liquidity_usd": 76315406.4596759,
"stable_liquidity_usd": 79315782724.2839,
"total_pairs": 11782972
}
],
"direction": "prev",
"limit": 100,
"next_cursor": null,
"prev_cursor": 1778097600,
"has_more": true
}
}{
"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"
}Liquidity History - Token
A historical liquidity time-series API for Solana tokens, returning snapshot liquidity data from the open value of each liquidity candle. Supports 1m, 4h, and 1D resolutions. Maximum 100 records.
curl --request GET \
--url https://public-api.birdeye.so/defi/v3/liquidity/history/token \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/defi/v3/liquidity/history/token"
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/v3/liquidity/history/token', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"items": [
{
"unix_time": 1778112000,
"liquidity_usd": 76897848464.11568,
"exit_liquidity_usd": 76315406.4596759,
"stable_liquidity_usd": 79315782724.2839,
"total_pairs": 11782972
}
],
"direction": "prev",
"limit": 100,
"next_cursor": null,
"prev_cursor": 1778097600,
"has_more": true
}
}{
"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
Historical token liquidity snapshots on Solana.
- This endpoint returns snapshot liquidity values from the open of each liquidity candle rather than full OHLC candle structure.
- Supported
resolutionvalues are1m,4h, and1D. - Maximum
countis100records per request. - Historical liquidity data is available from January 1, 2024 onward.
- Lite
- Starter
- Premium
- Business
- Enterprise
Solana
Compute Unit ⚙️
Compute Unit ⚙️
- CU is dynamic by resolution: base
20 CUfor1m,50 CUfor4h,200 CUfor1D, with depth and lookback multipliers applied.
Use Cases 💡
Use Cases 💡
- Build a clean liquidity time series without needing full OHLC candle fields.
- Track how token depth changed across launches, incentives, or LP exits.
- Support risk, treasury, and market-health dashboards focused on liquidity levels.
- Join liquidity history with price, holder, or smart-money timelines for richer narratives.
How to Use 🛠️
How to Use 🛠️
- Set
x-chain=solana. - Pass the token mint in
address. - Choose
resolutionand page withtime,direction, andcount. - Use the OHLC token liquidity endpoint instead when you need open/high/low/close structure, not just snapshots.
Best Practices ✅
Best Practices ✅
- Prefer this endpoint over OHLC liquidity when the consumer only needs level snapshots.
- Align liquidity history windows with the same resolution used by your price or holder charts.
- Use coarser resolutions for multi-week or multi-month views to avoid over-dense series.
Limitations ⚠️
Limitations ⚠️
- Solana only.
Authorizations
API key for authentication
Headers
Solana network only.
solana Query Parameters
The address of the token contract.
Liquidity candle resolution.
1m, 4h, 1D Unix timestamp in seconds used as the anchor time for the liquidity candle window. Defaults to the latest available candle.
0 <= x <= 10000000000Direction to query candles from the anchor time. Use back for older candles and forward for newer candles.
back, forward Maximum number of liquidity candles returned. Defaults to 100 and is capped at 100.
1 <= x <= 100Was this page helpful?

