> ## 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



## 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
      parameters:
        - in: path
          name: poolId
          required: true
          schema:
            type: string
          description: The pool address
          example: 7d51qGEeAKiPakkxLoHda9egShXQLJcjFYpHEcX4d3EM
        - 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: Filter by platform
        - 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

````