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

# Get DLMM pool

> Requires key scope `read`.

Returns one pool with its active bin, which you need to choose a `dlmm/open` range. The data can be up to 3 seconds old. `maxActiveBinSlippage` on the build covers later drift.



## OpenAPI

````yaml /api-reference/openapi.json get /dlmm/pools/{lbPair}
openapi: 3.1.0
info:
  title: Hedgin manager bot API
  version: 1.0.0
  description: >-
    Versioned HTTP API for approved manager bots. Reads vault state and builds
    unsigned Solana transactions. The bot signs locally with the vault's current
    authority key. Runs only on Solana mainnet-beta.
servers:
  - url: https://hedgin.xyz/api/external/v1
    description: Production (Solana mainnet-beta)
security:
  - bearerAuth: []
tags:
  - name: Vault reads
  - name: Market reads
  - name: Jupiter transactions
  - name: Meteora DLMM transactions
  - name: Phoenix transactions
  - name: Vault and strategy transactions
  - name: Send and status
paths:
  /dlmm/pools/{lbPair}:
    get:
      tags:
        - Market reads
      summary: Get DLMM pool
      description: >-
        Requires key scope `read`.


        Returns one pool with its active bin, which you need to choose a
        `dlmm/open` range. The data can be up to 3 seconds old.
        `maxActiveBinSlippage` on the build covers later drift.
      operationId: getDlmmPool
      parameters:
        - name: lbPair
          in: path
          required: true
          description: Meteora DLMM pool (LB pair) address.
          schema:
            $ref: '#/components/schemas/PublicKey'
        - name: vault
          in: query
          required: true
          description: >-
            A vault this key may access. The server checks the allowlist and
            current on-chain authority before it reads.
          schema:
            $ref: '#/components/schemas/PublicKey'
      responses:
        '200':
          description: The vault address and the pool.
          content:
            application/json:
              schema:
                type: object
                required:
                  - vault
                  - data
                properties:
                  vault:
                    $ref: '#/components/schemas/PublicKey'
                  data:
                    $ref: '#/components/schemas/PoolInfo'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
components:
  schemas:
    PublicKey:
      type: string
      description: >-
        Base58 Solana public key. The server decodes it and rejects anything
        that is not 32 bytes.
      pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
      example: So11111111111111111111111111111111111111112
    PoolInfo:
      type: object
      properties:
        lbPair:
          $ref: '#/components/schemas/PublicKey'
        tokenX:
          $ref: '#/components/schemas/TokenInfo'
        tokenY:
          $ref: '#/components/schemas/TokenInfo'
        binStep:
          type: integer
        activeBinId:
          type: integer
        activePrice:
          type: string
          description: Token Y per token X.
    TokenInfo:
      type: object
      required:
        - mint
        - symbol
        - decimals
        - logo
        - priceUsd
      properties:
        mint:
          $ref: '#/components/schemas/PublicKey'
        symbol:
          type: string
        name:
          type: string
        decimals:
          type: integer
        logo:
          type:
            - string
            - 'null'
        priceUsd:
          type:
            - number
            - 'null'
          description: USD per whole token (base units / 10^decimals). Display only.
        uiMultiplier:
          type: number
          description: >-
            Token-2022 scaled UI amount multiplier. Absent for unscaled mints.
            Display only.
    Error:
      type: object
      description: >-
        Every error response uses this envelope. Responses with status 500, 502,
        or 503 always carry the message `Service temporarily unavailable`.
        Responses with status 422 always carry the message `Transaction rejected
        during simulation or preflight`. In both cases `code` still names the
        cause.
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              description: >-
                Stable machine-readable code, such as `Validation`, `Forbidden`,
                or a decoded program error name.
              example: Validation
            message:
              type: string
              description: Human-readable detail. Never contains provider logs.
              example: vault must be a public key
  responses:
    BadRequest:
      description: >-
        Invalid path, query, or body. Builder messages name the field, such as
        `amount: must be a non-negative integer string`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: Validation
              message: vault must be a public key
    Unauthorized:
      description: Missing, malformed, unknown, revoked, or expired API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: Unauthorized
              message: Invalid API key
    Forbidden:
      description: >-
        The key lacks the required scope, the vault is outside the key's
        allowlist, or the key's manager is not the vault's current on-chain
        authority.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: Forbidden
              message: Action is not enabled for this key
    NotFound:
      description: Unknown route, or the vault, mint, pool, or strategy does not exist.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: NotFound
              message: Vault not found
    TooManyRequests:
      description: A rate limit is exhausted.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: RateLimited
              message: Too many requests, slow down
    InternalError:
      description: >-
        Internal error, including a builder that returned an invalid transaction
        (`BuildFailed`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: Internal
              message: Service temporarily unavailable
    ServiceUnavailable:
      description: RPC, key store, or service configuration unavailable.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: RpcUnavailable
              message: Service temporarily unavailable
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: hv1_<id>_<secret>
      description: >-
        API key issued by a Hedgin administrator, in the form
        `hv1_<id>_<secret>`. `<id>` is 1 to 48 characters and `<secret>` is 32
        to 128 characters, both from `[A-Za-z0-9_-]`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.