---
title: "Specific Pool Data by Pool Address"
method: GET
path: "/onchain/networks/{network}/pools/{address}"
---

# Specific Pool Data by Pool Address

`GET /onchain/networks/{network}/pools/{address}`

To query the specific pool based on the provided network and pool address

## Path parameters

- `network` string, required
- `address` string, required

## Query parameters

- `include` string
- `include_volume_breakdown` boolean
- `include_composition` boolean

## Response `200`

Specific pool data

- PoolAddressData
  - `data` PoolAddressItem, required
    - `id` string, required — Pool identifier
    - `type` string, required — Resource type
    - `attributes` object, required
      - `base_token_price_usd` string, required — Base token price in USD
      - `base_token_price_native_currency` string, required — Base token price in native currency
      - `base_token_balance` string — Base token balance in pool
      - `base_token_liquidity_usd` string — Base token liquidity in USD
      - `quote_token_price_usd` string, required — Quote token price in USD
      - `quote_token_price_native_currency` string, required — Quote token price in native currency
      - `quote_token_balance` string — Quote token balance in pool
      - `quote_token_liquidity_usd` string — Quote token liquidity in USD
      - `base_token_price_quote_token` string, required — Base token price in quote token
      - `quote_token_price_base_token` string, required — Quote token price in base token
      - `address` string, required — Pool contract address
      - `name` string, required — Pool name with fee tier
      - `pool_name` string, required — Pool name without fee tier
      - `pool_fee_percentage` string, required — Pool fee percentage
      - `pool_created_at` string, required — Pool creation timestamp
      - `fdv_usd` string, nullable, required — Fully diluted valuation in USD
      - `market_cap_usd` string, nullable, required — Market cap in USD
      - `price_change_percentage` object, required — Price change percentage over various timeframes
        - `m5` string
        - `m15` string
        - `m30` string
        - `h1` string
        - `h6` string
        - `h24` string
      - `transactions` object, required — Transaction counts over various timeframes
        - `m5` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `m15` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `m30` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `h1` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `h6` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `h24` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
      - `volume_usd` object, required — Volume in USD over various timeframes
        - `m5` string
        - `m15` string
        - `m30` string
        - `h1` string
        - `h6` string
        - `h24` string
      - `net_buy_volume_usd` object — Net buy volume in USD over various timeframes
        - `m5` string
        - `m15` string
        - `m30` string
        - `h1` string
        - `h6` string
        - `h24` string
      - `buy_volume_usd` object — Buy volume in USD over various timeframes
        - `m5` string
        - `m15` string
        - `m30` string
        - `h1` string
        - `h6` string
        - `h24` string
      - `sell_volume_usd` object — Sell volume in USD over various timeframes
        - `m5` string
        - `m15` string
        - `m30` string
        - `h1` string
        - `h6` string
        - `h24` string
      - `reserve_in_usd` string, required — Total reserve in USD
      - `locked_liquidity_percentage` string, required — Locked liquidity percentage
    - `relationships` object, required — Related resources
      - `base_token` object
        - `data` object
          - `id` string
          - `type` string
      - `quote_token` object
        - `data` object
          - `id` string
          - `type` string
      - `dex` object
        - `data` object
          - `id` string
          - `type` string
  - `included` object[] — Included related resources, present when include parameter is specified
    - `id` string
    - `type` string
    - `attributes` object
      - `address` string
      - `name` string
      - `symbol` string
      - `decimals` integer
      - `image_url` string
      - `coingecko_coin_id` string

## Changes

- **2026-05-28** `11cc9e00fd86` — 1 breaking, 24 info
  - for the `query` request parameter `include`, default value `base_token` was removed
  - api tag `Pools` removed
  - the response property `data` became required for the status `200`
  - the response property `data/attributes` became required for the status `200`
  - …21 more
- **2026-04-30** `fb6b6a203ce6` — 4 breaking
  - the response property `data/attributes/fdv_usd` became nullable for the status `200`
  - the response property `data/attributes/locked_liquidity_percentage` became nullable for the status `200`
  - the response property `data/attributes/market_cap_usd` became nullable for the status `200`
  - the response property `data/attributes/pool_fee_percentage` became nullable for the status `200`
- **2025-09-22** `91c83447321b` — 1 breaking, 8 info
  - for the `query` request parameter `include`, default value `base_token` was added
  - added the new optional `query` request parameter `include_composition`
  - added the optional property `data/attributes/base_token_balance` to the response with the `200` status
  - added the optional property `data/attributes/base_token_liquidity_usd` to the response with the `200` status
  - …5 more
- …earlier changes not shown

[Full history](https://skmtc.dev/coingecko/apis/coingecko-api/changes/onchain/networks/:network/pools/:address/get.md)

---

[API](https://skmtc.dev/coingecko/apis/coingecko-api.md) · [All operations](https://skmtc.dev/coingecko/apis/coingecko-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coingecko/coingecko-api/revisions/006c13c1a566/schema)