Liquidity

Pools ranked for a liquidity provider

Every indexed pool with volume by window, fees (volume × the pool's fee tier), TVL, fee/TVL and an annualised yardstick, LP adds / removes / providers in 24 hours, trader counts, and a 0–100 health score. Pools under $10k TVL are hidden unless small=1; wash and launch-farm pools are hidden unless flagged=1 (they come back with suspect: true). category=stocks keeps the pools with a tokenized stock or ETF on one side (Robinhood Chain only: 400 BAD_CATEGORY elsewhere, 503 CATEGORY_UNAVAILABLE while the token list cannot be read).

Use it for: an LP screener, "where are the fees on Arc", a pool picker for a token.

get/lp/pools

Request

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

Query parameters

chain5042 | 4663 | 143 required

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

sort'fee_tvl' | 'vol_24h' | 'vol_1h' | 'tvl' | 'fees_24h' | 'first_seen' | 'lp_net_24h' | 'trades_24h' | 'score'
interval'1h' | '6h' | '24h'

Window the fee/TVL sort uses.

minTvlnumber

Default 10000 unless small=1.

quotestring

Anchor symbol filter (e.g. USDC).

dexstring

Venue id filter.

searchstring

Symbol or address.

small0 | 1

1 = include pools under $10k TVL.

flagged0 | 1

1 = include suspect pools.

category'stocks'

Robinhood Chain (4663): pools with a tokenized stock or ETF on one side.

maxTvlnumber

Range filters: every bound is inclusive, unset = off, and a row whose figure the index does not have fails a set bound.

minVolnumber

Volume of the interval, dollars.

maxVolnumber
minFeesnumber

Fees of the interval, dollars.

maxFeesnumber
minAgeHnumber

Hours since the pool was created (since its first trade when the creation is unknown).

maxAgeHnumber
minFeePctnumber

Fee tier in percent (0.3 = 30 bps).

maxFeePctnumber
limitinteger
offsetinteger

Response

chaininteger
sortstring
intervalstring
minTvlnumber
flaggedboolean
categorystring

Present when the list was narrowed to a category.

hiddeninteger

Rows removed by the filters.

totalinteger
limitinteger
offsetinteger
updatedAtinteger

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

Changes

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