Liquidity OHLC - Token
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"
}Price & OHLCV
Liquidity OHLC - Token
Historical OHLC liquidity for a Solana token: total, exit, and stable liquidity at 1m, 4h, or 1D resolution. Up to 100 records per request.
GET
/
defi
/
v3
/
liquidity
/
ohlc
/
token
Liquidity OHLC - Token
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.
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?

