Liquidity History - Token
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"
}Price & OHLCV
Liquidity History - Token
Historical liquidity snapshots for a Solana token, taken from each liquidity candle’s open value, at 1m, 4h, or 1D. Up to 100 records per request.
GET
/
defi
/
v3
/
liquidity
/
history
/
token
Liquidity History - Token
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.
Available options:
solana Query Parameters
The address of the token contract.
Liquidity candle resolution.
Available options:
1m, 5m, 15m, 30m, 1h, 4h, 1D Unix timestamp in seconds used as the anchor time for the liquidity data window. Defaults to the latest available data point.
Required range:
0 <= x <= 10000000000Direction to query liquidity records from the anchor time. Use back for older records and forward for newer records.
Available options:
back, forward Maximum number of liquidity records returned. Defaults to 100 and is capped at 100.
Required range:
1 <= x <= 100Was this page helpful?

