---
title: "A pool's providers by profit"
method: GET
path: "/lp/pools/{pool}/lps"
tags: ["Liquidity"]
---

# A pool's providers by profit

`GET /lp/pools/{pool}/lps`

## Request

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

The wallets that provided to one pool, most profitable first. Profit is the wallet board's: value out + fees − value in on closed positions, plus the fees of open ones. Scored like the board: positions of `minIn` dollars or more, none that opened and closed inside a minute, none the tape could not reconcile. `total` counts the wallets with a scored position in the pool.

**Use it for**: "who earns in this pool", a provider table on a pool page.

## Path parameters

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

## Query parameters

- `chain` 5042 | 4663 | 143, required
- `limit` integer

## Response `200`

- object
  - `chain` integer
  - `pool` string: A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.
  - `minIn` number: Dollars in under this are not scored.
  - `total` integer: Wallets with a scored position in the pool.
  - `rows` object[]
    - `wallet` string: EVM address, hex, case-insensitive.
    - `positions` integer
    - `open` integer
    - `closed` integer
    - `wins` integer
    - `winRatePct` number, nullable: Null with no closed position.
    - `profitUsd` number
    - `feesUsd` number
    - `inUsd` number: Dollars the wallet put into the pool, summed over its positions.
    - `avgAgeHours` number, nullable
    - `lastTs` integer: Unix time, seconds, UTC.
  - `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`, …).

---

[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)