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"
      }
    }
  ]
}

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[]