{"uid":"cap_dWA5XcPZhUhzhnWKWB0t2","slug":"geckoterminal-dex-pool-search-142b462b","name":"GeckoTerminal DEX Pool Search","description":"Resolve any token name, symbol or address to its DEX pools (GeckoTerminal): pool address, network, dex, price, liquidity, volume. The lookup agents call before using pool endpoints. Params: query, network (optional).","url":"https://opportunity-api-production.up.railway.app/api/search-pools","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"token name, symbol or address"},"network":{"type":"string","description":"optional filter: base|eth|solana|bsc|arbitrum|polygon|optimism|avalanche"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BwTiYJa26AbTs4n234Uzu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a token name, symbol, or contract address to its DEX liquidity pools with price, liquidity, and volume data via GeckoTerminal.","exampleAgentPrompt":"Can you look up the DEX pools for PEPE on Ethereum — I need the pool address, price, and liquidity before I do anything else with it.","exampleUseCases":null,"resultDescription":"A list of DEX pools matching the query, each with pool address, network identifier, DEX name, current token price in USD, liquidity in USD, and 24h trading volume. Structured for downstream use with pool-specific endpoints.","failureModes":["Token not found on any DEX — empty pool list returned","Invalid or misspelled token name yields no results","Unsupported network filter value causes bad request or empty result","GeckoTerminal API unavailable — upstream error propagated","Rate limit exceeded — HTTP 429 or payment required response"],"whenToPreferThis":"Use this endpoint as the prerequisite lookup step before calling any pool-specific endpoint (OHLCV, recent swaps, etc.). Ideal when you have only a token name or symbol and need to resolve it to a concrete pool address and network. Prefer this over manual lookup when operating across multiple networks and needing liquidity/volume context to select the best pool.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:39:41.955Z","isFirstParty":false}