API Endpoints

Liquidity OHLC - Pair

get
https://public-api.birdeye.so/defi/v3/liquidity/ohlc/pair

A historical liquidity time-series API for Solana pools, converting raw on-chain pool states into OHLC data for TVL, token balances, and USD-denominated liquidity. It enables TradingView-style liquidity charting, deep liquidity analytics, pool-level liquidity provider tracking, abnormal liquidity event detection, manipulation and rug-risk surveillance, and quantitative backtesting of liquidity-driven strategies. Unlike traditional APIs limited to current snapshots or price/volume data, this dataset reveals the full historical evolution of pool liquidity structure over time, unlocking a new analytical layer for DeFi market intelligence and risk modeling. Maximum 100 records.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Historical liquidity candles for one Solana pool.

  • Pass a pool address and optionally anchor the query with time, direction, and count.
  • direction controls whether you page backward or forward from the anchor time.
  • Maximum count is 100 records per request.
  • Historical liquidity data is available from January 1, 2024 onward.
Compute Unit ⚙️
  • Liquidity OHLC pair requests use dynamic CU with a 20 CU base for the supported 1m resolution path.
Use Cases 💡
  • Chart how pool liquidity evolved around launches, migrations, or withdrawals.
  • Detect liquidity shocks, LP exits, or abrupt depth collapses.
  • Support pool-level risk dashboards and rug-surveillance workflows.
  • Study whether price moves were supported by real liquidity or happened into thin books.
How to Use 🛠️
  • Set x-chain=solana.
  • Pass the pool address in address.
  • Use time as the anchor point, direction to page backward or forward, and count up to 100.
  • Pair this endpoint with pair OHLCV when you want to compare price action and depth evolution side by side.
Best Practices ✅
  • Start from the event timestamp and page outward instead of pulling random windows.
  • Keep liquidity and price charts aligned to the same analysis window for easier diagnosis.
  • Use this on suspicious pools first, then expand to broader monitoring if the pattern proves useful.
Limitations ⚠️
  • Solana only.

Query Params
string
required

The address of a pair contract

integer
0 to 10000000000

Unix timestamp in seconds used as the anchor time for the liquidity candle window. Defaults to the latest available candle.

string
enum
Defaults to back

Direction to query candles from the anchor time. Use back for older candles and forward for newer candles.

Allowed:
integer
1 to 100
Defaults to 100

Maximum number of liquidity candles returned. Defaults to 100 and is capped at 100.

Headers
string
enum
Defaults to solana

Solana network only.

Allowed:
Responses

Updated 6 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 days ago

Did this page help you?