curl --request GET \
--url https://public-api.birdeye.so/defi/v3/liquidity/ohlc/token \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/defi/v3/liquidity/ohlc/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/ohlc/token', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"items": [
{
"token": "8thqCqGi8z5hnyvK5ximYarxagYd6Rvzc5dUSiHdpump",
"timestamp": "2026-06-17T19:29:00Z",
"unix_time": 1781724540,
"open_liquidity_usd": 1062.1323768982022,
"high_liquidity_usd": 1062.5375387105653,
"low_liquidity_usd": 1056.0793845380088,
"close_liquidity_usd": 1058.687722615185,
"open_exit_liquidity_usd": 354.04412563273405,
"high_exit_liquidity_usd": 354.1791795701884,
"low_exit_liquidity_usd": 352.0264615126695,
"close_exit_liquidity_usd": 352.895907538395,
"open_stable_liquidity_usd": 708.0882512654681,
"high_stable_liquidity_usd": 708.3583591403768,
"low_stable_liquidity_usd": 704.052923025339,
"close_stable_liquidity_usd": 705.79181507679,
"total_pairs": 1
}
],
"direction": "prev",
"limit": 100,
"next_cursor": null,
"prev_cursor": 1781724480,
"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 OHLC - Token
A historical liquidity time-series API for Solana tokens, returning OHLC data for total token liquidity, exit liquidity, and stable liquidity. Supports 1m, 4h, and 1D resolutions. Maximum 100 records.
curl --request GET \
--url https://public-api.birdeye.so/defi/v3/liquidity/ohlc/token \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/defi/v3/liquidity/ohlc/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/ohlc/token', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"items": [
{
"token": "8thqCqGi8z5hnyvK5ximYarxagYd6Rvzc5dUSiHdpump",
"timestamp": "2026-06-17T19:29:00Z",
"unix_time": 1781724540,
"open_liquidity_usd": 1062.1323768982022,
"high_liquidity_usd": 1062.5375387105653,
"low_liquidity_usd": 1056.0793845380088,
"close_liquidity_usd": 1058.687722615185,
"open_exit_liquidity_usd": 354.04412563273405,
"high_exit_liquidity_usd": 354.1791795701884,
"low_exit_liquidity_usd": 352.0264615126695,
"close_exit_liquidity_usd": 352.895907538395,
"open_stable_liquidity_usd": 708.0882512654681,
"high_stable_liquidity_usd": 708.3583591403768,
"low_stable_liquidity_usd": 704.052923025339,
"close_stable_liquidity_usd": 705.79181507679,
"total_pairs": 1
}
],
"direction": "prev",
"limit": 100,
"next_cursor": null,
"prev_cursor": 1781724480,
"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 OHLC on Solana.
- This endpoint returns OHLC liquidity series for total liquidity, exit liquidity, and stable liquidity.
- 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 💡
- Track how token-level liquidity builds, peaks, and decays over time.
- Compare total liquidity against exit liquidity to understand sell-side depth quality.
- Build launch dashboards, post-TGE monitoring, and liquidity-health reports.
- Investigate whether market-cap growth was accompanied by durable liquidity growth.
How to Use 🛠️
How to Use 🛠️
- Set
x-chain=solana. - Pass the token mint in
address. - Choose
resolutionbased on the horizon you care about:1mfor event analysis,4hor1Dfor broader trends. - Use
time,direction, andcountto page through the history window you want.
Best Practices ✅
Best Practices ✅
- Use
1monly around narrow event windows; prefer4hor1Dfor routine trend monitoring. - Compare liquidity OHLC with price OHLCV to distinguish price momentum from real market depth support.
- Track exit liquidity separately when assessing liquidation or whale-exit risk.
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?

