Search Pools & Tokens

curl --request GET \
  --url https://api.coingecko.com/api/v3/onchain/search/pools \
  --header 'x-cg-demo-api-key: <api-key>'

{
  "data": [
    {
      "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "type": "pool",
      "attributes": {
        "base_token_price_usd": "2084.57214039429",
        "base_token_price_native_currency": "1.0",
        "quote_token_price_usd": "1.00359565004917",
        "quote_token_price_native_currency": "0.00048094599624371",
        "base_token_price_quote_token": "2079.235522928",
        "quote_token_price_base_token": "0.0004809459962",
        "address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
        "name": "WETH / USDC 0.05%",
        "pool_created_at": "2021-12-29T12:35:14Z",
        "fdv_usd": "4700091001.66103",
        "market_cap_usd": "4706648770.97887",
        "price_change_percentage": {
          "m5": "0",
          "m15": "0",
          "m30": "0",
          "h1": "0",
          "h6": "0.599",
          "h24": "-1.887"
        },
        "transactions": {
          "m5": {
            "buys": 1,
            "sells": 1,
            "buyers": 1,
            "sellers": 1
          },
          "m15": {
            "buys": 7,
            "sells": 24,
            "buyers": 7,
            "sellers": 18
          },
          "m30": {
            "buys": 21,
            "sells": 53,
            "buyers": 15,
            "sellers": 41
          },
          "h1": {
            "buys": 57,
            "sells": 123,
            "buyers": 39,
            "sellers": 88
          },
          "h6": {
            "buys": 431,
            "sells": 477,
            "buyers": 194,
            "sellers": 279
          },
          "h24": {
            "buys": 2436,
            "sells": 2385,
            "buyers": 863,
            "sellers": 989
          }
        },
        "volume_usd": {
          "m5": "2407.6289853096",
          "m15": "210244.509017768",
          "m30": "1067809.71712486",
          "h1": "2766027.68033409",
          "h6": "17336676.2757229",
          "h24": "122795216.58555"
        },
        "reserve_in_usd": "101050763.5099"
      },
      "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"
      }
    }
  ]
}

GET

onchain

pools

Search Pools & Tokens

curl --request GET \
  --url https://api.coingecko.com/api/v3/onchain/search/pools \
  --header 'x-cg-demo-api-key: <api-key>'

{
  "data": [
    {
      "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "type": "pool",
      "attributes": {
        "base_token_price_usd": "2084.57214039429",
        "base_token_price_native_currency": "1.0",
        "quote_token_price_usd": "1.00359565004917",
        "quote_token_price_native_currency": "0.00048094599624371",
        "base_token_price_quote_token": "2079.235522928",
        "quote_token_price_base_token": "0.0004809459962",
        "address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
        "name": "WETH / USDC 0.05%",
        "pool_created_at": "2021-12-29T12:35:14Z",
        "fdv_usd": "4700091001.66103",
        "market_cap_usd": "4706648770.97887",
        "price_change_percentage": {
          "m5": "0",
          "m15": "0",
          "m30": "0",
          "h1": "0",
          "h6": "0.599",
          "h24": "-1.887"
        },
        "transactions": {
          "m5": {
            "buys": 1,
            "sells": 1,
            "buyers": 1,
            "sellers": 1
          },
          "m15": {
            "buys": 7,
            "sells": 24,
            "buyers": 7,
            "sellers": 18
          },
          "m30": {
            "buys": 21,
            "sells": 53,
            "buyers": 15,
            "sellers": 41
          },
          "h1": {
            "buys": 57,
            "sells": 123,
            "buyers": 39,
            "sellers": 88
          },
          "h6": {
            "buys": 431,
            "sells": 477,
            "buyers": 194,
            "sellers": 279
          },
          "h24": {
            "buys": 2436,
            "sells": 2385,
            "buyers": 863,
            "sellers": 989
          }
        },
        "volume_usd": {
          "m5": "2407.6289853096",
          "m15": "210244.509017768",
          "m30": "1067809.71712486",
          "h1": "2766027.68033409",
          "h6": "17336676.2757229",
          "h24": "122795216.58555"
        },
        "reserve_in_usd": "101050763.5099"
      },
      "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

Search by pool address, token name, token symbol, or token contract address.
Returns up to 20 pools per page. Use the page param to navigate more results. Pagination beyond 10 pages requires Analyst plan or above.
Unverified token market cap returns null — the displayed value on GeckoTerminal may match FDV and might not be accurate.
Use include to return related attributes under the top-level included key.

SDK Examples

const response = await client.onchain.search.pools.get({
  query: 'weth',
});

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

response = client.onchain.search.pools.get(
  query="weth",
)

print(response.model_dump_json(indent=2))

Authorizations

x-cg-demo-api-key

string

header

required

Learn how to set up your API key

Query Parameters

query

string

default:weth

Search query: pool contract address, token name, token symbol, or token contract address.

network

string

Network ID. *refers to /onchain/networks.

include

string

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

page

integer

Page through results. Default value: 1

Response

200 - application/json

Pool search results

data

object[]

required

Show child attributes

included

object[]

Included related resources, present when include parameter is specified

Show child attributes

DEXs List by Network

CoinGecko API

Onchain API

Search Pools & Tokens

Notes

SDK Examples

Authorizations

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Query Parameters

Response

Notes

SDK Examples