Skip to main content
GET
Liquidity History - Token

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.
  • CU is dynamic by resolution: base 20 CU for 1m, 50 CU for 4h, 200 CU for 1D, with depth and lookback multipliers applied.
  • 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.
  • 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.
  • 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.
  • 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 the token contract.

resolution
enum<string>
default:1m

Liquidity candle resolution.

Available options:
1m,
4h,
1D
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 historical liquidity snapshots of a token

success
boolean
required

Whether the request completed successfully.

data
object
required

Historical liquidity snapshots for the requested token.