> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lpagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get top LPers for a pool

> 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`.




## OpenAPI

````yaml /api-reference/openapi.json get /pools/{poolId}/top-lpers
openapi: 3.0.0
info:
  title: LP Agent Open API
  version: 1.0.0
  description: |+
    Public API for LP Agent

    **Authentication**

    All endpoints require an API key passed via the `x-api-key` header.

servers:
  - url: https://api.lpagent.io/open-api/v1
    description: Production
security:
  - apiKeyAuth: []
tags: []
paths:
  /pools/{poolId}/top-lpers:
    get:
      tags:
        - Pools
      summary: Get top LPers for a pool
      description: >
        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`.
      parameters:
        - in: path
          name: poolId
          required: true
          schema:
            type: string
          description: Pool address
          example: 7d51qGEeAKiPakkxLoHda9egShXQLJcjFYpHEcX4d3EM
        - in: query
          name: order_by
          schema:
            type: string
          description: Column to sort by
        - in: query
          name: sort_order
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
          description: Sort direction
        - in: query
          name: page
          schema:
            type: integer
            minimum: 1
            default: 1
          description: Page number
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
          description: Page size
      responses:
        '200':
          description: Successfully retrieved LPers
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        pool:
                          type: string
                          description: Pool address
                        owner:
                          type: string
                          description: Wallet address
                        protocol:
                          type: string
                          example: meteora
                        token0:
                          type: string
                          description: Token X mint address
                        token1:
                          type: string
                          description: Token Y mint address
                        total_inflow:
                          type: number
                          description: Total USD deposited
                        avg_inflow:
                          type: number
                          description: Average USD inflow per LP
                        total_outflow:
                          type: number
                          description: Total USD withdrawn
                        total_fee:
                          type: number
                          description: Total fees earned (USD)
                        total_pnl:
                          type: number
                          description: Total PnL (USD)
                        total_inflow_native:
                          type: number
                          description: Total inflow in native token
                        avg_inflow_native:
                          type: number
                        total_outflow_native:
                          type: number
                        total_reward:
                          type: number
                          description: Total rewards (USD)
                        total_fee_native:
                          type: number
                        total_reward_native:
                          type: number
                        total_pnl_native:
                          type: number
                          description: Total PnL in native token
                        total_lp:
                          type: number
                          description: Total number of LP positions
                        avg_age_hour:
                          type: number
                          description: Average position age in hours
                        win_lp:
                          type: number
                          description: Number of winning positions (USD)
                        win_lp_native:
                          type: number
                        win_rate:
                          type: number
                          description: Win rate (USD)
                        win_rate_native:
                          type: number
                        fee_percent:
                          type: number
                          description: Fee as percentage of inflow
                        fee_percent_native:
                          type: number
                        apr:
                          type: number
                          description: Annualized return
                        roi:
                          type: number
                          description: Return on investment
                        first_activity:
                          type: string
                          format: date-time
                        last_activity:
                          type: string
                          format: date-time
                  pagination:
                    type: object
                    properties:
                      page:
                        type: integer
                      pageSize:
                        type: integer
                      totalCount:
                        type: integer
                      totalPages:
                        type: integer
                      hasNextPage:
                        type: boolean
        '400':
          description: Invalid parameters
        '401':
          description: Free plan not allowed — upgrade to Premium or Enterprise
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: >-
                      A Premium or Enterprise plan is required to access this
                      endpoint.
        '500':
          description: Internal server error
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````