Skip to main content
GET
/
networks
/
{network}
/
pools
/
{address}
Specific Pool Data by Pool Address
curl --request GET \
  --url https://api.coingecko.com/api/v3/onchain/networks/{network}/pools/{address} \
  --header 'x-cg-demo-api-key: <api-key>'
{
  "data": {
    "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
    "type": "pool",
    "attributes": {
      "base_token_price_usd": "4473.69429892668",
      "base_token_price_native_currency": "1.0",
      "base_token_balance": "5713.28147604894",
      "base_token_liquidity_usd": "25559474.76756355",
      "quote_token_price_usd": "0.997996963545633",
      "quote_token_price_native_currency": "0.000223037878108427",
      "quote_token_balance": "64636039.082111",
      "quote_token_liquidity_usd": "64494052.04397222",
      "base_token_price_quote_token": "4483.543371561",
      "quote_token_price_base_token": "0.0002230378781",
      "address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "name": "WETH / USDC 0.05%",
      "pool_name": "WETH / USDC",
      "pool_fee_percentage": "0.05",
      "pool_created_at": "2021-12-29T12:35:14Z",
      "fdv_usd": "11190873336.847",
      "market_cap_usd": "11195941219.2312",
      "price_change_percentage": {
        "m5": "0",
        "m15": "0.01",
        "m30": "0",
        "h1": "0",
        "h6": "-0.31",
        "h24": "0.06"
      },
      "transactions": {
        "m5": {
          "buys": 0,
          "sells": 4,
          "buyers": 0,
          "sellers": 4
        },
        "m15": {
          "buys": 7,
          "sells": 14,
          "buyers": 7,
          "sellers": 13
        },
        "m30": {
          "buys": 36,
          "sells": 36,
          "buyers": 30,
          "sellers": 31
        },
        "h1": {
          "buys": 72,
          "sells": 66,
          "buyers": 52,
          "sellers": 55
        },
        "h6": {
          "buys": 394,
          "sells": 374,
          "buyers": 270,
          "sellers": 306
        },
        "h24": {
          "buys": 1405,
          "sells": 1769,
          "buyers": 720,
          "sellers": 1312
        }
      },
      "volume_usd": {
        "m5": "14474.0609971508",
        "m15": "97230.627441051",
        "m30": "217572.719149789",
        "h1": "398012.377874174",
        "h6": "2624801.54967643",
        "h24": "14524209.5484025"
      },
      "net_buy_volume_usd": {
        "m5": "-14474.0609971508",
        "m15": "20088.5420905036",
        "m30": "112265.1687880188",
        "h1": "213181.8440453441",
        "h6": "39055.74647786",
        "h24": "-3562.19491886"
      },
      "buy_volume_usd": {
        "m5": "0.0",
        "m15": "58659.5847657773",
        "m30": "164918.943968904",
        "h1": "305597.110959759",
        "h6": "1331928.64807714",
        "h24": "7260323.6767418"
      },
      "sell_volume_usd": {
        "m5": "14474.0609971508",
        "m15": "38571.0426752737",
        "m30": "52653.7751808852",
        "h1": "92415.2669144149",
        "h6": "1292872.90159928",
        "h24": "7263885.87166066"
      },
      "reserve_in_usd": "90053526.8909",
      "locked_liquidity_percentage": "0.0"
    },
    "relationships": {
      "base_token": {
        "data": {
          "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "type": "token"
        }
      },
      "quote_token": {
        "data": {
          "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          "type": "token"
        }
      },
      "dex": {
        "data": {
          "id": "uniswap_v3",
          "type": "dex"
        }
      }
    }
  },
  "included": [
    {
      "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "type": "token",
      "attributes": {
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "name": "Wrapped Ether",
        "symbol": "WETH",
        "decimals": 18,
        "image_url": "https://coin-images.coingecko.com/coins/images/2518/large/weth.png?1696503332",
        "coingecko_coin_id": "weth"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Note

  • Addresses not found in GeckoTerminal will be ignored.
  • If the token’s market cap is not verified by the team, the API response will return null for its market cap value, even though it has a displayed value on GeckoTerminal, which might not be accurate as it often matches the Fully Diluted Valuation (FDV).
  • Market Cap can be verified by and sourced from CoinGecko, and the number may be higher than FDV as it may include Market Cap of tokens issued on other blockchain networks.
  • Attributes specified in the include param will be returned under the top-level “included” key.
  • locked_liquidity_percentage will be updated on a daily basis.
  • Set include_composition=true to surface the balance and liquidity value of the pool’s base and quote tokens.
  • Pools on a bonding curve (e.g. non-graduated pools from launchpads) will return launchpad_details object with their graduation status and migration details.
  • Cache / Update Frequency:
    • Every 60 seconds for Public API.
    • Every 10 seconds for Pro API (Basic, Analyst, Lite, Pro, Enterprise).

Authorizations

​
x-cg-demo-api-key
string
header
required

Path Parameters

​
network
string
default:eth
required

network ID *refers to /networks

Example:

"eth"

​
address
string
default:0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640
required

pool address

Example:

"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"

Query Parameters

​
include
string
default:base_token

attributes to include, comma-separated if more than one to include Available values: base_token, quote_token, dex

​
include_volume_breakdown
boolean

include volume breakdown, default: false

​
include_composition
boolean

include pool composition, default: false

Response

200 - application/json

Get specific pool on a network

​
data
object
​
included
object[]