Skip to main content
GET
/
onchain
/
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": "2087.84394126108",
        "base_token_price_native_currency": "1.0",
        "base_token_balance": "21341.2567581564",
        "base_token_liquidity_usd": "44581759.9202084558888866184853251251371757144338",
        "quote_token_price_usd": "1.00206113475649",
        "quote_token_price_native_currency": "0.000479959386437488",
        "quote_token_balance": "54447706.143913",
        "quote_token_liquidity_usd": "54591030.8544913961746207304067005997478464613757298294624",
        "base_token_price_quote_token": "2083.509622392",
        "quote_token_price_base_token": "0.0004799593864",
        "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": "4706853532.94868",
        "market_cap_usd": "4714036496.09939",
        "price_change_percentage": {
          "m5": "0",
          "m15": "0.001",
          "m30": "0.339",
          "h1": "0.157",
          "h6": "0.64",
          "h24": "-1.403"
        },
        "transactions": {
          "m5": {
            "buys": 6,
            "sells": 5,
            "buyers": 6,
            "sellers": 4
          },
          "m15": {
            "buys": 39,
            "sells": 16,
            "buyers": 29,
            "sellers": 12
          },
          "m30": {
            "buys": 75,
            "sells": 52,
            "buyers": 44,
            "sellers": 34
          },
          "h1": {
            "buys": 101,
            "sells": 108,
            "buyers": 63,
            "sellers": 64
          },
          "h6": {
            "buys": 486,
            "sells": 514,
            "buyers": 221,
            "sellers": 288
          },
          "h24": {
            "buys": 2447,
            "sells": 2405,
            "buyers": 878,
            "sellers": 1000
          }
        },
        "volume_usd": {
          "m5": "169302.729000635",
          "m15": "1135682.71288074",
          "m30": "5933192.37924989",
          "h1": "7342742.90980712",
          "h6": "23039712.0227694",
          "h24": "126282664.514509"
        },
        "net_buy_volume_usd": {
          "m5": "-150936.4938119748",
          "m15": "124495.452251326",
          "m30": "1272049.71489431",
          "h1": "310733.1474086",
          "h6": "704731.2010502",
          "h24": "-4997173.0542116"
        },
        "buy_volume_usd": {
          "m5": "9183.1175943302",
          "m15": "630089.082566032",
          "m30": "3602621.04707209",
          "h1": "3826738.02860785",
          "h6": "11872221.6119098",
          "h24": "60642745.7301488"
        },
        "sell_volume_usd": {
          "m5": "160119.611406305",
          "m15": "505593.630314706",
          "m30": "2330571.33217778",
          "h1": "3516004.88119925",
          "h6": "11167490.4108596",
          "h24": "65639918.7843604"
        },
        "reserve_in_usd": "99172790.7747",
        "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"
      }
    },
    {
      "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "type": "token",
      "attributes": {
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "name": "USD Coin",
        "symbol": "USDC",
        "decimals": 6,
        "image_url": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602",
        "coingecko_coin_id": "usd-coin"
      }
    },
    {
      "id": "uniswap_v3",
      "type": "dex",
      "attributes": {
        "name": "Uniswap V3"
      }
    }
  ]
}

​
Notes

  • Addresses not found in GeckoTerminal will be ignored.
  • Supports up to 30 pool addresses per request. Analyst plan or above supports up to 50.
  • Unverified token market cap returns null — the displayed value on GeckoTerminal may match FDV and might not be accurate. Verified market cap is sourced from CoinGecko and may exceed FDV if it includes tokens on other networks.
  • Use include to return related attributes under the top-level included key.
  • locked_liquidity_percentage is updated daily.
  • Set include_composition=true to surface balance and liquidity of base and quote tokens.
  • Bonding curve pools (non-graduated launchpad pools) return a launchpad_details object with graduation status.

​
SDK Examples

const response = await client.onchain.networks.pools.multi.getAddresses('0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640', {
  network: 'eth',
});

console.log(JSON.stringify(response, null, 2));

Authorizations

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

Path Parameters

​
network
string
default:eth
required

Network ID. *refers to /onchain/networks.

​
addresses
string
default:0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640
required

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

Query Parameters

​
include
string

Attributes to include, comma-separated if more than one. 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

Multiple pools data

​
data
object[]
required
​
included
object[]

Included related resources, present when include parameter is specified