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

> Fetch detailed information about a liquidity pool including current reserves, fees collected, market cap, creator verification status, and migration state.

This is the primary endpoint for displaying pool data in a UI. It returns human-readable values (UI amounts with decimals applied).



## OpenAPI

````yaml /openapi.json post /data/pool-info
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-info:
    post:
      tags:
        - Data API
      summary: Get Liquidity Pool Info
      description: >-
        Fetch detailed information about a liquidity pool including current
        reserves, fees collected, market cap, creator verification status, and
        migration state.


        This is the primary endpoint for displaying pool data in a UI. It
        returns human-readable values (UI amounts with decimals applied).
      operationId: fetch_liquidity_pool_info
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FetchLiquidityPoolInfoRequest'
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FetchLiquidityPoolInfoResponse'
components:
  schemas:
    FetchLiquidityPoolInfoRequest:
      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
    FetchLiquidityPoolInfoResponse:
      type: object
      required:
        - data
      properties:
        data:
          $ref: '#/components/schemas/LiquidityPoolInfo'
          description: Detailed pool information object.
    LiquidityPoolInfo:
      type: object
      required:
        - creator
        - protocol_config_version
        - trading_volume_threshold_usd
        - current_buy_fee_pct
        - current_sell_fee_pct
        - current_trading_volume_usd
        - current_creator_fee_recipient
        - current_creator_fee_claim_status
        - current_creator_fee_distribution
        - is_creator_fee_claimable
        - current_market_cap_usd
        - current_base_reserve
        - current_quote_reserve
        - current_sol_price_usd
        - current_creator_fee_collected_sol
        - current_creator_fee_collected_usd
        - current_creator_fee_claim_by_creator
        - is_migrated
        - migration_market_cap_threshold
        - classification
      properties:
        classification:
          $ref: '#/components/schemas/TokenClassification'
          description: Token classification (Creator, Community, or Blocked).
        creator:
          type: string
          description: Creator of the liquidity pool
          example: G2pX3b4Y8m7v5xX9L5f6y7z8A9B0C1D2E3F4G5H6I7J8K
        current_base_reserve:
          type: number
          description: Current base reserve in UI amount
        current_buy_fee_pct:
          type: number
          description: Current buy fee percentage e.g. 1.5 for 1.5%
        current_creator_fee_claim_by_creator:
          type: number
          description: Current creator fee claimed by creator in SOL
        current_creator_fee_claim_status:
          type: string
          description: Current creator fee claim status
          example: Unclaimed, Submitted, Processed
        current_creator_fee_collected_sol:
          type: number
          description: Current creator fee collected in SOL
        current_creator_fee_collected_usd:
          type: number
          description: Current creator fee collected in USD
        current_creator_fee_distribution:
          type: string
          description: Current creator fee distribution
          example: Community, Creator, Blocked, Shared
        current_creator_fee_recipient:
          type: string
          description: Current creator fee recipient
          example: G2pX3b4Y8m7v5xX9L5f6y7z8A9B0C1D2E3F4G5H6I7J8K
        current_market_cap_usd:
          type: number
          description: Current FDV in USD
        current_quote_reserve:
          type: number
          format: Current quote reserve in UI amount
          description: Current SOL reserve in the pool (lamports).
        current_sell_fee_pct:
          type: number
          description: Current sell fee percentage e.g. 1.5 for 1.5%
        current_sol_price_usd:
          type: number
          description: Current SOL price in USD
        current_trading_volume_usd:
          type: number
          description: Current trading volume in USD
        is_creator_fee_claimable:
          type: boolean
          description: Indicates if the creator fee is claimable by the creator
        is_migrated:
          type: boolean
          description: Indicates if the pool has reached migration threshold
        migration_market_cap_threshold:
          type: integer
          description: Market cap threshold in USD for migration eligibility
          minimum: 0
        protocol_config_version:
          type: integer
          description: Protocol config version of the liquidity pool
          minimum: 0
        trading_volume_threshold_usd:
          type: number
          description: Trading volume threshold in USD for creator fee claim
    TokenClassification:
      type: string
      enum:
        - Community
        - Creator

````