---
title: "Get top LPers for a pool"
method: GET
path: "/pools/{poolId}/top-lpers"
tags: ["Pools"]
---

# Get top LPers for a pool

`GET /pools/{poolId}/top-lpers`

Retrieve ranked LP providers for a pool with pagination and sorting.

**Plan:** Requires an active **Premium** or **Enterprise** API key. Free-plan keys receive `401`.

## Path parameters

- `poolId` string, required

## Query parameters

- `order_by` string
- `sort_order` 'asc' | 'desc'
- `page` integer
- `limit` integer

## Response `200`

Successfully retrieved LPers

- object
  - `status` string
  - `data` object[]
    - `pool` string — Pool address
    - `owner` string — Wallet address
    - `protocol` string
    - `token0` string — Token X mint address
    - `token1` string — Token Y mint address
    - `total_inflow` number — Total USD deposited
    - `avg_inflow` number — Average USD inflow per LP
    - `total_outflow` number — Total USD withdrawn
    - `total_fee` number — Total fees earned (USD)
    - `total_pnl` number — Total PnL (USD)
    - `total_inflow_native` number — Total inflow in native token
    - `avg_inflow_native` number
    - `total_outflow_native` number
    - `total_reward` number — Total rewards (USD)
    - `total_fee_native` number
    - `total_reward_native` number
    - `total_pnl_native` number — Total PnL in native token
    - `total_lp` number — Total number of LP positions
    - `avg_age_hour` number — Average position age in hours
    - `win_lp` number — Number of winning positions (USD)
    - `win_lp_native` number
    - `win_rate` number — Win rate (USD)
    - `win_rate_native` number
    - `fee_percent` number — Fee as percentage of inflow
    - `fee_percent_native` number
    - `apr` number — Annualized return
    - `roi` number — Return on investment
    - `first_activity` string, date-time
    - `last_activity` string, date-time
  - `pagination` object
    - `page` integer
    - `pageSize` integer
    - `totalCount` integer
    - `totalPages` integer
    - `hasNextPage` boolean

## Other responses

- `400` — Invalid parameters
- `401` — Free plan not allowed — upgrade to Premium or Enterprise
- `500` — Internal server error

## Changes

- **2026-05-25** `f90fd69d221b` — 1 info
  - added the non-success response with the status `401`
- **2026-03-13** `23fdd2328560` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/lpagent/apis/lp-agent-open-api/changes/pools/:poolId/top-lpers/get.md)

---

[API](https://skmtc.dev/lpagent/apis/lp-agent-open-api.md) · [All operations](https://skmtc.dev/lpagent/apis/lp-agent-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lpagent/lp-agent-open-api/revisions/f90fd69d221b/schema)