> ## 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 positions for a specific pool

> Retrieve all positions associated with a specific pool along with position state and pricing info. Works on Solana (Meteora DLMM, DAMM V2) and Robinhood Chain (Uniswap V3, Uniswap V4); pass `chain=ROBINHOOD` for a Robinhood pool.

On `ROBINHOOD`, `positionState` is always an empty array and `activeBin` is omitted: both are Meteora DLMM bin data.




## OpenAPI

````yaml /api-reference/openapi.json get /pools/{poolId}/positions
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}/positions:
    get:
      tags:
        - Pools
      summary: Get positions for a specific pool
      description: >
        Retrieve all positions associated with a specific pool along with
        position state and pricing info. Works on Solana (Meteora DLMM, DAMM V2)
        and Robinhood Chain (Uniswap V3, Uniswap V4); pass `chain=ROBINHOOD` for
        a Robinhood pool.


        On `ROBINHOOD`, `positionState` is always an empty array and `activeBin`
        is omitted: both are Meteora DLMM bin data.
      parameters:
        - in: path
          name: poolId
          required: true
          schema:
            type: string
          description: >-
            The pool ID. On Solana, the Meteora pool address. On Robinhood
            Chain, the Uniswap V3 pool address or the Uniswap V4 pool ID
            (32-byte `0x` hash), in any letter case.
          example: 7d51qGEeAKiPakkxLoHda9egShXQLJcjFYpHEcX4d3EM
        - in: query
          name: chain
          schema:
            type: string
            enum:
              - SOL
              - ROBINHOOD
            default: SOL
          description: >-
            Blockchain network the pool lives on. `SOL` returns Meteora (DLMM /
            DAMM v2) positions; `ROBINHOOD` returns Uniswap V3 and V4 positions
            on Robinhood Chain (EVM, chain id 4663). Unrecognised values fall
            back to `SOL`, so a Robinhood pool sent without `chain` is looked up
            on Solana and not found.
        - in: query
          name: owner
          schema:
            type: string
          description: Filter by position owner
        - in: query
          name: status
          schema:
            type: string
            enum:
              - Open
              - Close
          description: Filter by position status
        - in: query
          name: page
          schema:
            type: integer
            minimum: 1
            default: 1
          description: Page number for pagination
        - in: query
          name: pageSize
          schema:
            type: integer
            minimum: 1
            maximum: 20
            default: 20
          description: Number of items per page
        - in: query
          name: order_by
          schema:
            type: string
            default: inputNative
          description: Field to order results by
        - in: query
          name: sort_order
          schema:
            type: string
            default: desc
          description: Sort order direction (asc or desc)
        - in: query
          name: platform
          schema:
            type: string
          description: >-
            Comma-separated protocols to filter by, on `SOL` only: `meteora` or
            `meteora_damm_v2`. On `ROBINHOOD` it is ignored, since the pool's
            own protocol (`uniswap_v3` or `uniswap_v4`) is always used.
          example: meteora,meteora_damm_v2
        - in: query
          name: pnl_threshold
          schema:
            type: number
          description: Filter by PNL threshold
        - in: query
          name: pnl_native_threshold
          schema:
            type: number
          description: Filter by native PNL threshold
      responses:
        '200':
          description: Successfully retrieved pool positions
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      pagination:
                        type: object
                        properties:
                          page:
                            type: integer
                          pageSize:
                            type: integer
                          total:
                            type: integer
                          totalPages:
                            type: integer
                      positions:
                        type: array
                        description: Array of position objects
                        items:
                          type: object
                      positionState:
                        type: array
                        description: Bin data for each position (DLMM pools only)
                        items:
                          type: object
                          properties:
                            positionId:
                              type: string
                            positionData:
                              type: array
                              items:
                                type: object
                                properties:
                                  binId:
                                    type: integer
                                  price:
                                    type: string
                                  pricePerToken:
                                    type: string
                                  binXAmount:
                                    type: string
                                  binYAmount:
                                    type: string
                                  positionXAmount:
                                    type: string
                                  positionYAmount:
                                    type: string
                                  feeX:
                                    type: string
                                  feeY:
                                    type: string
                      activeBin:
                        type: object
                        description: Active bin info (DLMM pools only)
                        properties:
                          binId:
                            type: integer
                          price:
                            type: string
                          pricePerToken:
                            type: string
                      prices:
                        type: object
                        description: Token prices map (tokenAddress -> priceInUsd)
                        additionalProperties:
                          type: number
        '400':
          description: Invalid request parameters
        '500':
          description: Internal server error
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````