Skip to main content
GET
/
networks
/
{network}
/
pools
/
multi
/
{addresses}
Multiple Pools Data by Pool Addresses
curl --request GET \
  --url https://api.coingecko.com/api/v3/onchain/networks/{network}/pools/multi/{addresses} \
  --header 'x-cg-demo-api-key: <api-key>'
{
  "data": [
    {
      "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "type": "pool",
      "attributes": {
        "base_token_price_usd": "4459.91960575582",
        "base_token_price_native_currency": "1.0",
        "base_token_balance": "5783.57638014946",
        "base_token_liquidity_usd": "25794285.689214855",
        "quote_token_price_usd": "0.998614899014123",
        "quote_token_price_native_currency": "0.000223861979768972",
        "quote_token_balance": "64655288.355199",
        "quote_token_liquidity_usd": "64552255.7925259",
        "base_token_price_quote_token": "4467.038132299",
        "quote_token_price_base_token": "0.0002238619798",
        "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": "11160006028.1758",
        "market_cap_usd": "11166433701.589",
        "price_change_percentage": {
          "m5": "0",
          "m15": "0.027",
          "m30": "0.028",
          "h1": "0.039",
          "h6": "-0.435",
          "h24": "-0.221"
        },
        "transactions": {
          "m5": {
            "buys": 0,
            "sells": 4,
            "buyers": 0,
            "sellers": 4
          },
          "m15": {
            "buys": 9,
            "sells": 27,
            "buyers": 9,
            "sellers": 23
          },
          "m30": {
            "buys": 23,
            "sells": 43,
            "buyers": 18,
            "sellers": 37
          },
          "h1": {
            "buys": 86,
            "sells": 104,
            "buyers": 56,
            "sellers": 79
          },
          "h6": {
            "buys": 383,
            "sells": 524,
            "buyers": 212,
            "sellers": 388
          },
          "h24": {
            "buys": 1517,
            "sells": 1828,
            "buyers": 740,
            "sellers": 1302
          }
        },
        "volume_usd": {
          "m5": "37399.6069733459",
          "m15": "288043.30450079",
          "m30": "365553.90171076",
          "h1": "2801120.82868497",
          "h6": "5475445.24298699",
          "h24": "16190877.4119214"
        },
        "net_buy_volume_usd": {
          "m5": "-37399.6069733459",
          "m15": "-106958.58061148",
          "m30": "-32014.899699526",
          "h1": "66459.25132413",
          "h6": "-336894.73878909",
          "h24": "-165843.81722825"
        },
        "buy_volume_usd": {
          "m5": "0.0",
          "m15": "90542.361944655",
          "m30": "166769.501005617",
          "h1": "1433790.04000455",
          "h6": "2569275.25209895",
          "h24": "8012516.79734659"
        },
        "sell_volume_usd": {
          "m5": "37399.6069733459",
          "m15": "197500.942556135",
          "m30": "198784.400705143",
          "h1": "1367330.78868042",
          "h6": "2906169.99088804",
          "h24": "8178360.61457484"
        },
        "reserve_in_usd": "90346541.3306",
        "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"

​
addresses
string
default:0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640
required

pool contract address, comma-separated if more than one pool contract address

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 multiple pools on a network

​
data
object[]
​
included
object[]