Liquidity

A wallet's positions

Every managed position a wallet holds or held: dollars in and out, fees collected, live value and uncollected fees (V3), in-range, PnL on the liquidity leg, age, and the JIT / unreconciled flags; with a summary (open, closed, wins, realized PnL, fees, open value).

get/lp/positions

Request

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

Query parameters

chain5042 | 4663 | 143 required

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

unit'usd' | 'native'

native = every money field of the answer in the chain's own coin (ETH on Robinhood Chain, MON on Monad; Arc's coin is USDC), each deposit, withdrawal and fee converted at the coin's price of its own hour, and live values at the price now. The fields keep their …Usd names; unit and unitSymbol in the answer say what they carry. The row rules (the $20 floor, the 20x bound) stay in dollars, so both units score the same positions. 503 UNIT_NOT_READY while a chain's ledger is being rebuilt with these figures; another value is 400 BAD_UNIT.

ownerstring required

EVM address, hex, case-insensitive.

status'open' | 'closed' | 'all'
tokenstring

EVM address, hex, case-insensitive.

Only positions holding this token.

poolstring

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

Only positions in this pool.

limitinteger
offsetinteger

Rows to skip, newest first: page through a wallet's closed positions. Out of range is 400 BAD_OFFSET.

Response

chaininteger
ownerstring

EVM address, hex, case-insensitive.

statusstring
updatedAtinteger

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

Changes

No recorded changes to this operation across all 1 revision of this API.