Liquidity History - Token

A historical liquidity time-series API for Solana tokens, returning snapshot liquidity data from the open value of each liquidity candle. 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 snapshots on Solana.

  • This endpoint returns snapshot liquidity values from the open of each liquidity candle rather than full OHLC candle structure.
  • 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 💡
  • Build a clean liquidity time series without needing full OHLC candle fields.
  • Track how token depth changed across launches, incentives, or LP exits.
  • Support risk, treasury, and market-health dashboards focused on liquidity levels.
  • Join liquidity history with price, holder, or smart-money timelines for richer narratives.
How to Use 🛠️
  • Set x-chain=solana.
  • Pass the token mint in address.
  • Choose resolution and page with time, direction, and count.
  • Use the OHLC token liquidity endpoint instead when you need open/high/low/close structure, not just snapshots.
Best Practices ✅
  • Prefer this endpoint over OHLC liquidity when the consumer only needs level snapshots.
  • Align liquidity history windows with the same resolution used by your price or holder charts.
  • Use coarser resolutions for multi-week or multi-month views to avoid over-dense series.
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

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