Search DEX pools and tokens
Search decentralized-exchange pools across networks by pool address, token address, name, or symbol.
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 '/routes/coingecko/crypto/dex-pool-search?query=USDC&page=1'
h402 call 'crypto/dex-pool-search' --provider 'coingecko' --method GET --query '{"query":"USDC","page":1}'Parameters & live test
pays real USDCFill 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 charsPool contract address, token contract address, token name, or token symbol.
networkstringoptionalOptional 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 charsComma-separated related resources to include. Supported values: base_token, quote_token, dex.
pageintegeroptional≥ 1default 11-based result page, 20 pools per page. CoinGecko documents that pages beyond 10 require Analyst entitlement but publishes no fixed parameter maximum for x402.
{
"query": "USDC",
"page": 1
}{ "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.
- Success
- 100%
- p50
- 3.34s
- Calls
- 2