---
title: "Returns detailed information about requested pool"
method: GET
path: "/v1/yield/pool/{pool_address}"
tags: ["Yield"]
---

# Returns detailed information about requested pool

`GET /v1/yield/pool/{pool_address}`

## Path parameters

- `pool_address` string, required

## Response `200`

Detailed information about requested pool, with incentives and so on

- ApiYieldDetails
  - `pool_statistics` ApiPoolStatistics, required
    - `address` string, required
    - `tvl_usd` number, double, required
    - `volume_usd` number, double, required
    - `fee_usd` number, double, required
    - `apr` number, double, required
    - `lp_apr` number, double, required
    - `boost_apr` number, double, required
    - `locked_asset_amount` string
  - `pool` union, required
    - ApiYieldDetailsDex
      - `pool` ApiPool, required
        - `dex` string, required
        - `address` string, required
        - `type` 'public' | 'private' | 'slumbering' | 'invalid', required
        - `amm_type` 'constant_product' | 'cubic_stable' | 'curve_fi_stable' | 'concentrated_v3' | 'tonstakers' | 'weighted_constant_product' | 'weighted_stable' | 'bidask' | 'moon_dlmm' | 'bidask_damm' | 'dedust_v2', required
        - `amm_settings` ApiJson
        - `tokens` ApiToken[], required
          - `address` ApiTokenAddress, required
            - `blockchain` string, required
            - `address` string, required
          - `metadata` ApiTokenMetadata, required
            - `name` string, required
            - `symbol` string, required
            - `decimals` integer, required
            - `image_url` string
            - `listed` boolean, required
            - `verification` 'whitelisted' | 'blacklisted' | 'community' | 'unknown', required
        - `reserves` number[], required
        - `restrictions` ApiTokenRestrictions[]
          - `min_swap_amount` number, double
          - `max_swap_amount` number, double
        - `fees` ApiPoolFees, required
          - `average_gas` number, double, required
          - `divider` integer
          - `input` integer
          - `output` integer
          - `first_token` integer
          - `second_token` integer
        - `unavailable_until` integer — UTC unix timestamp in seconds
      - `boosts` ApiBoost[], required
        - `pool_address` string, required
        - `boost_factory` string
        - `boost_id` integer
        - `reward_token` ApiToken, required
          - `address` ApiTokenAddress, required
            - `blockchain` string, required
            - `address` string, required
          - `metadata` ApiTokenMetadata, required
            - `name` string, required
            - `symbol` string, required
            - `decimals` integer, required
            - `image_url` string
            - `listed` boolean, required
            - `verification` 'whitelisted' | 'blacklisted' | 'community' | 'unknown', required
        - `reward_rate_per_second` string, required
        - `start_seconds_unix` integer
        - `finish_seconds_unix` integer, required
        - `rewards_per_day_usd` number, required
        - `apr` number, required — Apr in percents
        - `lock_duration_seconds` integer
        - `excluded_addresses` string[]
      - `total_supply` string, required — Absolute value of total minted LP for this pool
    - ApiYieldDetailsDexCLMM
      - `pool` ApiPoolCLMM, required
        - `pool` ApiPool, required
          - `dex` string, required
          - `address` string, required
          - `type` 'public' | 'private' | 'slumbering' | 'invalid', required
          - `amm_type` 'constant_product' | 'cubic_stable' | 'curve_fi_stable' | 'concentrated_v3' | 'tonstakers' | 'weighted_constant_product' | 'weighted_stable' | 'bidask' | 'moon_dlmm' | 'bidask_damm' | 'dedust_v2', required
          - `amm_settings` ApiJson
          - `tokens` ApiToken[], required
            - `address` ApiTokenAddress, required
              - …
            - `metadata` ApiTokenMetadata, required
              - …
          - `reserves` number[], required
          - `restrictions` ApiTokenRestrictions[]
            - `min_swap_amount` number, double
            - `max_swap_amount` number, double
          - `fees` ApiPoolFees, required
            - `average_gas` number, double, required
            - `divider` integer
            - `input` integer
            - `output` integer
            - `first_token` integer
            - `second_token` integer
          - `unavailable_until` integer — UTC unix timestamp in seconds
        - `sqrtPriceX96` string, required — Current pool price in sqrtPriceX96 format
        - `liquidity` string, required — Current available liquidity in the pool
        - `tick` integer, required — Current pool tick
        - `ticks` ApiJson, required
        - `jetton0PriceUsd` number, double, required — Price of the first jetton in USD
        - `jetton1PriceUsd` number, double, required — Price of the second jetton in USD
      - `boosts` ApiBoost[], required
        - `pool_address` string, required
        - `boost_factory` string
        - `boost_id` integer
        - `reward_token` ApiToken, required
          - `address` ApiTokenAddress, required
            - `blockchain` string, required
            - `address` string, required
          - `metadata` ApiTokenMetadata, required
            - `name` string, required
            - `symbol` string, required
            - `decimals` integer, required
            - `image_url` string
            - `listed` boolean, required
            - `verification` 'whitelisted' | 'blacklisted' | 'community' | 'unknown', required
        - `reward_rate_per_second` string, required
        - `start_seconds_unix` integer
        - `finish_seconds_unix` integer, required
        - `rewards_per_day_usd` number, required
        - `apr` number, required — Apr in percents
        - `lock_duration_seconds` integer
        - `excluded_addresses` string[]
    - ApiYieldDetailsDexDLMM
      - `pool` ApiPoolDLMM, required
        - `pool` ApiPool, required
          - `dex` string, required
          - `address` string, required
          - `type` 'public' | 'private' | 'slumbering' | 'invalid', required
          - `amm_type` 'constant_product' | 'cubic_stable' | 'curve_fi_stable' | 'concentrated_v3' | 'tonstakers' | 'weighted_constant_product' | 'weighted_stable' | 'bidask' | 'moon_dlmm' | 'bidask_damm' | 'dedust_v2', required
          - `amm_settings` ApiJson
          - `tokens` ApiToken[], required
            - `address` ApiTokenAddress, required
              - …
            - `metadata` ApiTokenMetadata, required
              - …
          - `reserves` number[], required
          - `restrictions` ApiTokenRestrictions[]
            - `min_swap_amount` number, double
            - `max_swap_amount` number, double
          - `fees` ApiPoolFees, required
            - `average_gas` number, double, required
            - `divider` integer
            - `input` integer
            - `output` integer
            - `first_token` integer
            - `second_token` integer
          - `unavailable_until` integer — UTC unix timestamp in seconds
        - `current_sqrt_price` number, double, required — Current sqrt price
        - `active_bin` integer, required — Active bin index
        - `bin_step` integer, required — Bin step in basis points
        - `base_bin_step` integer, required — Base bin step coefficient (denominator)
        - `bins` object, required — Available bins
      - `boosts` ApiBoost[], required
        - `pool_address` string, required
        - `boost_factory` string
        - `boost_id` integer
        - `reward_token` ApiToken, required
          - `address` ApiTokenAddress, required
            - `blockchain` string, required
            - `address` string, required
          - `metadata` ApiTokenMetadata, required
            - `name` string, required
            - `symbol` string, required
            - `decimals` integer, required
            - `image_url` string
            - `listed` boolean, required
            - `verification` 'whitelisted' | 'blacklisted' | 'community' | 'unknown', required
        - `reward_rate_per_second` string, required
        - `start_seconds_unix` integer
        - `finish_seconds_unix` integer, required
        - `rewards_per_day_usd` number, required
        - `apr` number, required — Apr in percents
        - `lock_duration_seconds` integer
        - `excluded_addresses` string[]
    - ApiYieldDetailsLiquidStaking
      - `pool` ApiLiquidStakingPool, required
        - `protocol` string, required
        - `address` string, required
        - `base_token` ApiToken, required
          - `address` ApiTokenAddress, required
            - `blockchain` string, required
            - `address` string, required
          - `metadata` ApiTokenMetadata, required
            - `name` string, required
            - `symbol` string, required
            - `decimals` integer, required
            - `image_url` string
            - `listed` boolean, required
            - `verification` 'whitelisted' | 'blacklisted' | 'community' | 'unknown', required
        - `liquid_token` ApiToken, required
          - `address` ApiTokenAddress, required
            - `blockchain` string, required
            - `address` string, required
          - `metadata` ApiTokenMetadata, required
            - `name` string, required
            - `symbol` string, required
            - `decimals` integer, required
            - `image_url` string
            - `listed` boolean, required
            - `verification` 'whitelisted' | 'blacklisted' | 'community' | 'unknown', required
        - `supports_tx_building` boolean, required
      - `stats` ApiLiquidStakingPoolStats, required
        - `rate` number, double, required
        - `cycle_end` number, required
        - `tvl_usd` number, double, required
        - `apr` number, double, required
    - ApiYieldDetailsLending
      - `pool` ApiLendingPool, required
        - `protocol` string, required
        - `address` string, required
        - `token` ApiToken, required
          - `address` ApiTokenAddress, required
            - `blockchain` string, required
            - `address` string, required
          - `metadata` ApiTokenMetadata, required
            - `name` string, required
            - `symbol` string, required
            - `decimals` integer, required
            - `image_url` string
            - `listed` boolean, required
            - `verification` 'whitelisted' | 'blacklisted' | 'community' | 'unknown', required
        - `supports_tx_building` boolean, required
      - `stats` ApiLendingPoolStats, required
        - `available_liquidity` number, double, required
        - `liquidation_threshold` number, double, required
        - `liquidation_bonus` number, double, required
        - `collateral_factor` number, double, required
    - ApiYieldDetailsPerpetual
      - `pool` ApiPerpetualVaultPool, required
        - `protocol` string, required
        - `address` string, required
        - `quote_token` ApiToken, required
          - `address` ApiTokenAddress, required
            - `blockchain` string, required
            - `address` string, required
          - `metadata` ApiTokenMetadata, required
            - `name` string, required
            - `symbol` string, required
            - `decimals` integer, required
            - `image_url` string
            - `listed` boolean, required
            - `verification` 'whitelisted' | 'blacklisted' | 'community' | 'unknown', required
        - `lp_token` ApiToken, required
          - `address` ApiTokenAddress, required
            - `blockchain` string, required
            - `address` string, required
          - `metadata` ApiTokenMetadata, required
            - `name` string, required
            - `symbol` string, required
            - `decimals` integer, required
            - `image_url` string
            - `listed` boolean, required
            - `verification` 'whitelisted' | 'blacklisted' | 'community' | 'unknown', required
        - `exchange_rate` string, bigint, required
        - `normalizer` string, bigint, required
    - ApiYieldDetailsFarmixLending
      - `pool` ApiDefiLendingPool, required
        - `address` string, required
        - `token` ApiToken, required
          - `address` ApiTokenAddress, required
            - `blockchain` string, required
            - `address` string, required
          - `metadata` ApiTokenMetadata, required
            - `name` string, required
            - `symbol` string, required
            - `decimals` integer, required
            - `image_url` string
            - `listed` boolean, required
            - `verification` 'whitelisted' | 'blacklisted' | 'community' | 'unknown', required
        - `exchange_rate` string, bigint, required
        - `normalizer` string, bigint, required
        - `remaining_liquidity_to_supply` string, bigint
    - ApiYieldDetailsDaoLamaLending
      - `pool` ApiDefiLendingPool, required
        - `address` string, required
        - `token` ApiToken, required
          - `address` ApiTokenAddress, required
            - `blockchain` string, required
            - `address` string, required
          - `metadata` ApiTokenMetadata, required
            - `name` string, required
            - `symbol` string, required
            - `decimals` integer, required
            - `image_url` string
            - `listed` boolean, required
            - `verification` 'whitelisted' | 'blacklisted' | 'community' | 'unknown', required
        - `exchange_rate` string, bigint, required
        - `normalizer` string, bigint, required
        - `remaining_liquidity_to_supply` string, bigint

## Other responses

- `default` — Some error during request processing

---

[API](https://skmtc.net/swap/apis/swap-coffee-api.md) · [All operations](https://skmtc.net/swap/apis/swap-coffee-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/swap/swap-coffee-api/versions/fd1067547679/schema)