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

# Get Liquidity Pool State

> Fetch the raw on-chain state of a liquidity pool by its mint address.

Returns the full deserialized `LiquidityPoolState` account data. Useful for advanced integrations that need access to all pool parameters.



## OpenAPI

````yaml /openapi.json post /data/pool-state
openapi: 3.1.0
info:
  title: heaven-tx-api
  description: ''
  license:
    name: ''
  version: 0.1.14
servers:
  - url: https://tx.api.heaven.xyz
security: []
tags:
  - name: heaven-api
    description: Heaven API
paths:
  /data/pool-state:
    post:
      tags:
        - Data API
      summary: Get Liquidity Pool State
      description: >-
        Fetch the raw on-chain state of a liquidity pool by its mint address.


        Returns the full deserialized `LiquidityPoolState` account data. Useful
        for advanced integrations that need access to all pool parameters.
      operationId: fetch_liquidity_pool_state
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FetchLiquidityPoolStateRequest'
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FetchLiquidityPoolStateResponse'
components:
  schemas:
    FetchLiquidityPoolStateRequest:
      type: object
      required:
        - program_id
        - mint
      properties:
        mint:
          type: string
          description: Mint address of the token
          default: LiGHtkg3uTa9836RaNkKLLriqTNRcMdRAhqjGWNv777
          example: LiGHtkg3uTa9836RaNkKLLriqTNRcMdRAhqjGWNv777
        program_id:
          type: string
          description: Program ID of the Heaven DEX program
          default: HEAVENoP2qxoeuF8Dj2oT1GHEnu49U5mJYkdeC8BAX2o
          example: HEAVENoP2qxoeuF8Dj2oT1GHEnu49U5mJYkdeC8BAX2o
    FetchLiquidityPoolStateResponse:
      type: object
      required:
        - data
      properties:
        data:
          type: string
          description: JSON encoded LiquidityPoolState struct

````