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).

POST /data/pool-info

Get Liquidity Pool Info

cURL

curl --request POST \
  --url https://tx.api.heaven.xyz/data/pool-info \
  --header 'Content-Type: application/json' \
  --data '
{
  "mint": "LiGHtkg3uTa9836RaNkKLLriqTNRcMdRAhqjGWNv777",
  "program_id": "HEAVENoP2qxoeuF8Dj2oT1GHEnu49U5mJYkdeC8BAX2o"
}
'

200

{
  "data": {
    "creator": "G2pX3b4Y8m7v5xX9L5f6y7z8A9B0C1D2E3F4G5H6I7J8K",
    "current_base_reserve": 123,
    "current_buy_fee_pct": 123,
    "current_creator_fee_claim_by_creator": 123,
    "current_creator_fee_claim_status": "Unclaimed, Submitted, Processed",
    "current_creator_fee_collected_sol": 123,
    "current_creator_fee_collected_usd": 123,
    "current_creator_fee_distribution": "Community, Creator, Blocked, Shared",
    "current_creator_fee_recipient": "G2pX3b4Y8m7v5xX9L5f6y7z8A9B0C1D2E3F4G5H6I7J8K",
    "current_market_cap_usd": 123,
    "current_quote_reserve": 123,
    "current_sell_fee_pct": 123,
    "current_sol_price_usd": 123,
    "current_trading_volume_usd": 123,
    "is_creator_fee_claimable": true,
    "is_migrated": true,
    "migration_market_cap_threshold": 1,
    "protocol_config_version": 1,
    "trading_volume_threshold_usd": 123
  }
}

Body

application/json

mint · string · default: LiGHtkg3uTa9836RaNkKLLriqTNRcMdRAhqjGWNv777 · required

Mint address of the token

Example:

"LiGHtkg3uTa9836RaNkKLLriqTNRcMdRAhqjGWNv777"

program_id · string · default: HEAVENoP2qxoeuF8Dj2oT1GHEnu49U5mJYkdeC8BAX2o · required

Program ID of the Heaven DEX program

Example:

"HEAVENoP2qxoeuF8Dj2oT1GHEnu49U5mJYkdeC8BAX2o"

Response

200 - application/json

data · object · required

Detailed pool information object.

Show child attributes