---
title: "One position"
method: GET
path: "/lp/position/{chain}/{manager}/{id}"
tags: ["Liquidity"]
---

# One position

`GET /lp/position/{chain}/{manager}/{id}`

## Request

- Base URL: `https://api.getchord.xyz/v1`
- URL: `https://api.getchord.xyz/v1/lp/position/{chain}/{manager}/{id}`
- Auth: none declared

A position by its NFT: the valued row, its events, and a hold-instead comparison (what the same tokens would be worth unpooled). `native` carries the same position in the chain's own coin (`nativeSymbol`): what went in, came out and was paid as fees, each event converted at the coin's price of its own hour, and the value and waiting fees at the coin's price now. It is null while the chain's ledger has no figures in its coin.

## Path parameters

- `chain` 5042 | 4663 | 143, required
- `manager` string, required: EVM address, hex, case-insensitive.
- `id` string, required

## Response `200`

- object
  - `chain` integer
  - `position` LpPosition
    - `manager` string: EVM address, hex, case-insensitive.
    - `tokenId` string
    - `pool` string, nullable: A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.
    - `dex` string, nullable
    - `kind` 'v3' | 'v4'
    - `owner` string, nullable: EVM address, hex, case-insensitive.
    - `token` string, nullable: EVM address, hex, case-insensitive.
    - `anchor` string, nullable: EVM address, hex, case-insensitive.
    - `tickLower` integer, nullable
    - `tickUpper` integer, nullable
    - `symbol` string, nullable
    - `anchorSymbol` string, nullable
    - `logo` string, nullable
    - `inUsd` number: Dollars added.
    - `outUsd` number: Dollars removed.
    - `feesUsd` number: Fees collected.
    - `adds` integer
    - `removes` integer
    - `collects` integer
    - `openedTs` integer, nullable: Unix time, seconds, UTC.
    - `lastTs` integer: Unix time, seconds, UTC.
    - `closedTs` integer, nullable: Unix time, seconds, UTC.
    - `burned` boolean
    - `status` 'open' | 'closed'
    - `valueUsd` number, nullable: Live value of the liquidity (open positions).
    - `uncollectedUsd` number, nullable: Uncollected fees (V3).
    - `inRange` boolean, nullable
    - `pnlUsd` number, nullable: Liquidity leg only.
    - `pnlPct` number, nullable
    - `ageHours` number, nullable
    - `edgePct` number, nullable: Distance from the price to the nearest range edge, percent.
    - `jit` boolean: Opened and closed within seconds — a swap trick, shown but not scored.
    - `unreconciled` boolean: Dollars out exceed dollars in by far — the tape missed an add; shown, never scored.
  - `events` object[]
    - `kind` string
    - `usd` number
    - `feeUsd` number
    - `tokenAmt` number
    - `anchorAmt` number
    - `tx` string: Transaction hash.
    - `ts` integer: Unix time, seconds, UTC.
    - `block` integer
  - `hold` object
    - `tokenIn` number
    - `anchorIn` number
    - `priceNowUsd` number, nullable
    - `holdValueUsd` number, nullable
    - `lpValueUsd` number, nullable
    - `lpVsHoldUsd` number, nullable
    - `basis` string
  - `native` object, nullable
    - `in` number: In, in the coin.
    - `out` number: Out, in the coin.
    - `fees` number: Fees paid out, in the coin.
    - `value` number, nullable: Value now at the coin's price now; null for a closed position.
    - `uncollected` number, nullable: Fees waiting, at the coin's price now.
    - `pnl` number, nullable: Closed: out + fees − in. Open: value + waiting + out + fees − in.
    - `pnlPct` number, nullable: `pnl` in percent of `in`.
  - `nativeSymbol` string, nullable: The chain's coin (`ETH`, `MON`, `USDC`); null with `native`.
  - `updatedAt` integer: Unix time, milliseconds — when the server built this answer.

## Other responses

- `400`: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).
- `404`: Nothing at this identity (`NOT_FOUND`, `UNKNOWN_TOKEN`, `NO_ROUTE`).

---

[API](https://skmtc.dev/getchord/apis/chord-api.md) · [All operations](https://skmtc.dev/getchord/apis/chord-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getchord/apis/chord-api/revisions/d3bc4640fea0?raw)