Liquidity

One pool

The pool row plus its hourly series (the last 168 hours by default; hours up to 720), the top providers over 7 days, the health score with its parts and reasons, launch facts (who launched it, how much of the liquidity the launcher holds and has pulled), and mint — what a wallet needs to add liquidity here (the position manager, the pool key, Permit2, tick spacing).

Candles (open / high / low / close of each hour, in dollars per token like price): built from this pool's own swaps in block order, swaps under $0.10 left out. A swap whose price is more than 10× away from at least half of the five swaps before it AND half of the five after it in the same pool is a misprint and is not part of the candle (a launch, a rug or a pump that holds keeps its prices: the swaps after it agree with it). A candle whose open or close is still 10× away from the candles around it is dropped (its hour keeps vol and trades) and counted in candlesDropped. An hour without a candle has the four fields null: no priced swap, two tokens in the hour, or an hour rolled before candles existed (2026-10-19) whose swaps are no longer kept. price is the hour's last swap of any size, unfiltered.

get/lp/pools/{pool}

Request

  • Base URL: https://api.getchord.xyz/v1
  • URL: https://api.getchord.xyz/v1/lp/pools/{pool}
  • Auth: none declared

Path parameters

poolstring required

A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.

Query parameters

chain5042 | 4663 | 143 required

Chain id: 5042 Arc · 4663 Robinhood Chain · 143 Monad.

hoursinteger

Hours of the hourly series, 24 to 720 (default 168)

Response

poolstring

A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.

dexstring
kind'v2' | 'clmm' | 'v4'
feeBpsnumber nullable
hooksstring nullable

EVM address, hex, case-insensitive.

lpAccess'open' | 'hooked' | 'unknown'

hooked = a V4 hook can refuse adds.

tickSpacinginteger nullable
tokenSideinteger nullable

Which side is the non-anchor token (0 or 1).

tvlUsdnumber nullable
tvlSrcstring nullable

Where TVL came from (onchain, dexscreener, …).

tvlAtinteger nullable

Unix time, seconds, UTC.

aprPctnumber nullable

24h fee/TVL × 365 — a full-range yardstick, not a promise.

trades24hinteger
wallets24hinteger
priceUsdnumber nullable
lpAdd24hnumber
lpRemove24hnumber
providers24hinteger
firstSeenTsinteger

Unix time, seconds, UTC.

createdTsinteger nullable

Unix time, seconds, UTC.

lastTradeHourinteger
turnover24hnumber nullable

24h volume ÷ TVL.

suspectboolean

Wash or launch-farm printing (volume without traders, dust TVL under real volume, turnover no honest pool reaches). Hidden by default; flagged=1 shows them.

scoreinteger

0–100 health score (traders, TVL, yield sanity, LP flow, age, penalties).

marketCapUsdnumber nullable

The tracked token's price × its total supply on this chain (for a bridged token: what was bridged here). On the list only; null when the pool tracks neither side, the tracked side is the native coin, or the supply is not on record yet.

chaininteger
candlesDroppedinteger

Candles of the series left out as misprints (their hours keep volume and trades).

updatedAtinteger

Unix time, milliseconds — when the server built this answer.

Changes

No recorded changes to this operation across all 2 revisions of this API.