{"uid":"cap_iPRhDwk4B33cQCrBugX3W","slug":"2s-io-dex-token-pools-lookup-6c938c44","name":"2s.io DEX Token Pools Lookup","description":"All DEX pools trading a given token, by contract address (via GeckoTerminal, free/keyless). Returns each pool's pair, on-chain USD price, FDV/market cap, liquidity reserve, 24h volume + price change, and buys/sells — the on-chain price + liquidity picture for any token across a network's DEXes.","url":"https://2s.io/api/crypto/dex-token-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","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["network","address"],"properties":{"limit":{"type":"integer","maximum":50,"minimum":1},"address":{"type":"string","maxLength":120,"minLength":1,"description":"Token contract address."},"network":{"type":"string","maxLength":40,"minLength":1,"description":"Network slug, e.g. eth, bsc, base, solana."}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0036","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.0036/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_STHxsM3Ibj1vBmBWGXwuu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0036","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all DEX pools trading a given token (by contract address and network), including pair info, on-chain USD price, FDV, market cap, liquidity, 24h volume, price change, and buy/sell counts via GeckoTerminal.","exampleAgentPrompt":"Show me all DEX pools trading the PEPE token on Ethereum — its contract address is 0x6982508145454ce325ddbe47a25d4ec3d2311933 — I want to see each pool's on-chain price, liquidity, 24h volume, and buy/sell activity, top 10 pools.","exampleUseCases":null,"resultDescription":"A list of DEX pools trading the specified token, each containing the trading pair name, exchange/DEX name, on-chain USD price, fully diluted valuation, market cap, liquidity reserve in USD, 24-hour trading volume, 24-hour price change percentage, and the number of buys and sells in the last 24 hours.","failureModes":["Invalid or unrecognized contract address returns empty pool list or 404","Unsupported network slug causes a validation error or empty result","Token with no DEX pools returns an empty array","Exceeding limit parameter bounds (>50 or <1) returns a validation error","GeckoTerminal upstream unavailability causes 502 or timeout","Rate limiting or payment failure returns 402 or 429"],"whenToPreferThis":"Use this endpoint when you need on-chain DEX pool data for a specific token by contract address, including liquidity, volume, and trade activity across multiple DEXes on a given network. Prefer this over CEX price APIs when you want decentralized, pool-level granularity rather than aggregate order-book prices. Ideal for DeFi research, token due diligence, arbitrage analysis, or liquidity monitoring across networks like Ethereum, BSC, Base, and Solana.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:10:23.240Z","isFirstParty":false}