liquidity-pools
get/v1/liquidity-pools

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

limitinteger

Items per page (1–100, default 20).

cursorstring

Opaque pagination cursor from a previous response.

filter[asset_code]string nullable

Free-text asset filter — case-insensitive substring of any leg's displayed code (input is trimmed before the query). The needle is matched literally: %, _ and regex metacharacters have no special meaning.

A / makes it a pair query: USDC/XLM requires both codes to be present on TWO DIFFERENT legs, and the typed order does not matter. Only the first / splits, so USDC/XLM/BTC searches for the literal second code XLM/BTC and therefore matches nothing.

Native legs match on XLM even though they store an empty code, so XLM returns the pools that actually hold native XLM. Note that it also returns credit assets minted under the code XLM — asset codes are not unique on Stellar, and this filter matches codes, not asset identity.

A pool IDENTIFIER is also accepted here — a classic pool's L… SEP-23 StrKey or a soroban pool's C… contract address — and selects that single pool instead of matching asset codes (task 0470). Previously an identifier was matched as a substring of an asset code, found nothing, and the list answered "no pools" about a pool that exists.

filter[pool_kind]string nullable

classic | soroban — which protocol built the pool.

Replaces the four per-leg POSITIONAL filters (filter[asset_a_code] + issuer, and the same for b). Those named a leg by its position in a pair, which a list of two-to-four legs has no equivalent for; filter[asset_code] answers the same question without pinning a position. No client used them — the frontend's only pool filter is the free-text code box.

An unknown value is rejected with 400 rather than ignored: a silently dropped filter returns a page that contradicts what was asked for.

filter[min_tvl]string nullable

Minimum TVL threshold as a decimal string (matches the underlying NUMERIC(28,7) column without an f64 round-trip).

Response

Paginated liquidity-pool list

Changes