Skip to main content
GET
Liquidity OHLC - Pair

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.
  • CU is dynamic by resolution: base 20 CU for 1m, with depth and lookback multipliers applied.
  • 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.
  • 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.
  • 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.
  • Solana only.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Headers

x-chain
enum<string>
default:solana

Solana network only.

Available options:
solana

Query Parameters

address
string
required

The address of a pair contract

time
integer

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

Required range: 0 <= x <= 10000000000
direction
enum<string>
default:back

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

Available options:
back,
forward
count
integer
default:100

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

Required range: 1 <= x <= 100

Response

JSON object containing liquidity OHLC data of a pair

success
boolean
required

Whether the request completed successfully.

data
object
required

Liquidity OHLC candle series for the requested trading pair.