API Endpoints

Liquidity OHLC - Token

get
https://public-api.birdeye.so/defi/v3/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.

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

Historical token liquidity OHLC on Solana.

  • This endpoint returns OHLC liquidity series for total liquidity, exit liquidity, and stable liquidity.
  • Supported resolution values are 1m, 4h, and 1D.
  • Maximum count is 100 records per request.
  • Historical liquidity data is available from January 1, 2024 onward.
Compute Unit ⚙️
  • CU is dynamic by resolution: base 20 CU for 1m, 50 CU for 4h, and 200 CU for 1D, with up to 100 requested records.
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 🛠️
  • Set x-chain=solana.
  • Pass the token mint in address.
  • Choose resolution based on the horizon you care about: 1m for event analysis, 4h or 1D for broader trends.
  • Use time, direction, and count to page through the history window you want.
Best Practices ✅
  • Use 1m only around narrow event windows; prefer 4h or 1D for 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 ⚠️
  • Solana only.

Query Params
string
required

The address of the token contract.

string
enum
Defaults to 1m

Liquidity candle resolution.

Allowed:
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 15 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 15 days ago

Did this page help you?