Catalog
CryptoGETlive

Search DEX pools and tokens

Search decentralized-exchange pools across networks by pool address, token address, name, or symbol.

$0.01
per call
Success
100%
p50 latency
3.34s
p95 latency
3.93s
Calls (30d)
2

Provider contract

Call path
/routes/coingecko/crypto/dex-pool-search
Method
GET
Selected provider
coingeckodefault
Provider price
$0.01
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl '/routes/coingecko/crypto/dex-pool-search?query=USDC&page=1'
CLI
h402 call 'crypto/dex-pool-search' --provider 'coingecko' --method GET --query '{"query":"USDC","page":1}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

querystringrequired≥ 1 chars

Pool contract address, token contract address, token name, or token symbol.

e.g.
networkstringoptional

Optional CoinGecko onchain network ID from the complete official GeckoTerminal network list captured on 2026-07-13. Omit to search across all supported networks.

includestringoptional≥ 1 chars

Comma-separated related resources to include. Supported values: base_token, quote_token, dex.

e.g.
pageintegeroptional≥ 1default 1

1-based result page, 20 pools per page. CoinGecko documents that pages beyond 10 require Analyst entitlement but publishes no fixed parameter maximum for x402.

GET/routes/coingecko/crypto/dex-pool-search
Request query
{
  "query": "USDC",
  "page": 1
}

ResponseExample response
{
  "data": {
    "data": [
      {
        "id": "base_0xd0b53d9277642d899df5c87a3966a349a798f224",
        "type": "pool",
        "attributes": {
          "base_token_price_usd": "0.999971609552606",
          "base_token_price_native_currency": "0.000515504123867632",
          "quote_token_price_usd": "1936.19",
          "quote_token_price_native_currency": "1.0",
          "base_token_price_quote_token": "0.0005155041239",
          "quote_token_price_base_token": "1939.848691214",
          "address": "0xd0b53d9277642d899df5c87a3966a349a798f224",
          "name": "USDC / WETH 0.05%",
          "pool_created_at": "2024-03-23T12:55:07Z",
          "fdv_usd": "4205484419.53708",
          "market_cap_usd": "73186332565.8266",
          "price_change_percentage": {
            "m5": "0.14",
            "m15": "0.049",
            "m30": "-0.03",
            "h1": "0.142",
            "h6": "0.067",
            "h24": "0.003"
          },
          "transactions": {
            "m5": {
              "buys": 83,
              "sells": 68,
              "buyers": 42,
              "sellers": 54
            },
            "m15": {
              "buys": 153,
              "sells": 142,
              "buyers": 68,
              "sellers": 98
            },
            "m30": {
              "buys": 340,
              "sells": 269,
              "buyers": 126,
              "sellers": 173
            },
            "h1": {
              "buys": 887,
              "sells": 556,
              "buyers": 306,
              "sellers": 321
            },
            "h6": {
              "buys": 3449,
              "sells": 1919,
              "buyers": 613,
              "sellers": 640
            },
            "h24": {
              "buys": 9199,
              "sells": 6695,
              "buyers": 1318,
              "sellers": 1467
            }
          },
          "volume_usd": {
            "m5": "171360.820021405",
            "m15": "289863.242829301",
            "m30": "526959.041532473",
            "h1": "1451288.43943154",
            "h6": "3808425.98562975",
            "h24": "11715866.7540225"
          },
          "reserve_in_usd": "10483691.4995"
        },
        "relationships": {
          "base_token": {
            "data": {
              "id": "base_0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
              "type": "token"
            }
          },
          "quote_token": {
            "data": {
              "id": "base_0x4200000000000000000000000000000000000006",
              "type": "token"
            }
          },
          "dex": {
            "data": {
              "id": "uniswap-v3-base",
              "type": "dex"
            }
          }
        }
      },
      {
        "id": "base_0x3e66e55e97ce60096f74b7c475e8249f2d31a9fb",
        "type": "pool",
        "attributes": {
          "base_token_price_usd": "0.998113929591271",
          "base_token_price_native_currency": "0.000515504123867632",
          "quote_token_price_usd": "65713.1390739315",
          "quote_token_price_native_currency": "33.9394062948014",
          "base_token_price_quote_token": "0.00001518895526",
          "quote_token_price_base_token": "65837.3128815477",
          "address": "0x3e66e55e97ce60096f74b7c475e8249f2d31a9fb",
          "name": "USDC / cbBTC 1%",
          "pool_created_at": "2025-03-12T06:42:10Z",
          "fdv_usd": "4195736891.46169",
          "market_cap_usd": "73016700304.6522",
          "price_change_percentage": {
            "m5": "-0.592",
            "m15": "0.084",
            "m30": "0.089",
            "h1": "-0.096",
            "h6": "-0.662",
            "h24": "-0.27"
          },
          "transactions": {
            "m5": {
              "buys": 20,
              "sells": 34,
              "buyers": 17,
              "sellers": 31
            },
            "m15": {
              "buys": 41,
              "sells": 78,
              "buyers": 35,
              "sellers": 60
            },
            "m30": {
              "buys": 104,
              "sells": 144,
              "buyers": 66,
              "sellers": 90
            },
            "h1": {
              "buys": 272,
              "sells": 244,
              "buyers": 128,
              "sellers": 116
            },
            "h6": {
              "buys": 626,
              "sells": 669,
              "buyers": 190,
              "sellers": 192
            },
            "h24": {
              "buys": 1960,
              "sells": 1989,
              "buyers": 319,
              "sellers": 316
            }
          },
          "volume_usd": {
            "m5": "46004.4954945674",
            "m15": "93893.0648796541",
            "m30": "193014.623969833",
            "h1": "429929.049763352",
            "h6": "1135656.11694391",
            "h24": "3468735.12272417"
          },
          "reserve_in_usd": "5115420.7794"
        },
        "relationships": {
          "base_token": {
            "data": {
              "id": "base_0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
              "type": "token"
            }
          },
          "quote_token": {
            "data": {
              "id": "base_0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
              "type": "token"
            }
          },
          "dex": {
            "data": {
              "id": "aerodrome-slipstream",
              "type": "dex"
            }
          }
        }
      },
      {
        "id": "base_0x6c561b446416e1a00e8e93e221854d6ea4171372",
        "type": "pool",
        "attributes": {
          "base_token_price_usd": "1936.19",
          "base_token_price_native_currency": "1.0",
          "quote_token_price_usd": "0.998113270620311",
          "quote_token_price_native_currency": "0.000515504123867632",
          "base_token_price_quote_token": "1939.848691214",
          "quote_token_price_base_token": "0.0005155041239",
          "address": "0x6c561b446416e1a00e8e93e221854d6ea4171372",
          "name": "WETH / USDC 0.3%",
          "pool_created_at": "2023-11-18T05:59:09Z",
          "fdv_usd": "504235270.582061",
          "market_cap_usd": "509020259.618188",
          "price_change_percentage": {
            "m5": "0.294",
            "m15": "0.372",
            "m30": "0.417",
            "h1": "-0.167",
            "h6": "0.761",
            "h24": "0.493"
          },
          "transactions": {
            "m5": {
              "buys": 97,
              "sells": 3,
              "buyers": 59,
              "sellers": 3
            },
            "m15": {
              "buys": 100,
              "sells": 6,
              "buyers": 62,
              "sellers": 5
            },
            "m30": {
              "buys": 128,
              "sells": 18,
              "buyers": 80,
              "sellers": 13
            },
            "h1": {
              "buys": 424,
              "sells": 576,
              "buyers": 130,
              "sellers": 218
            },
            "h6": {
              "buys": 1035,
              "sells": 892,
              "buyers": 401,
              "sellers": 326
            },
            "h24": {
              "buys": 2379,
              "sells": 2739,
              "buyers": 726,
              "sellers": 736
            }
          },
          "volume_usd": {
            "m5": "2179290.02115588",
            "m15": "2180457.91824635",
            "m30": "2477619.5213398",
            "h1": "14195766.6741678",
            "h6": "27244082.6534617",
            "h24": "47683733.1730902"
          },
          "reserve_in_usd": "111554566.5033"
        },
        "relationships": {
          "base_token": {
            "data": {
              "id": "base_0x4200000000000000000000000000000000000006",
              "type": "token"
            }
          },
          "quote_token": {
            "data": {
              "id": "base_0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
              "type": "token"
            }
          },
          "dex": {
            "data": {
              "id": "uniswap-v3-base",
              "type": "dex"
            }
          }
        }
      }
    ],
    "included": [
      {
        "id": "base_0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "type": "token",
        "attributes": {
          "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
          "name": "USD Coin",
          "symbol": "USDC",
          "decimals": 6,
          "image_url": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602",
          "banner_image_url": null,
          "coingecko_coin_id": "usd-coin"
        }
      },
      {
        "id": "base_0x4200000000000000000000000000000000000006",
        "type": "token",
        "attributes": {
          "address": "0x4200000000000000000000000000000000000006",
          "name": "Wrapped Ether",
          "symbol": "WETH",
          "decimals": 18,
          "image_url": "https://coin-images.coingecko.com/coins/images/39810/large/weth.png?1724139790",
          "banner_image_url": null,
          "coingecko_coin_id": "l2-standard-bridged-weth-base"
        }
      },
      {
        "id": "uniswap-v3-base",
        "type": "dex",
        "attributes": {
          "name": "Uniswap V3 (Base)"
        }
      }
    ]
  },
  "h402": {
    "routeId": "crypto/dex-pool-search",
    "provider": "coingecko",
    "selectedCandidateId": "crypto/dex-pool-search/coingecko",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

coingecko
x402
100
Success
100%
p50
3.34s
Calls
2
100%
$0.01$0.010/call
Last successful call: 15d ago· Aggregated by h402 — not the source provider