{"uid":"cap_PSe0LvZdyeGeb_3ZcJNVh","slug":"token-pools-eb85dabd","name":"Token Pools","description":"Lists every DEX pool for a Base token (pair address, DEX, quote symbol, price, liquidity, 24h volume), sorted by liquidity. Tells agents where — and how deep — a token can be traded.","url":"https://402.com.tr/api/x402/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"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Token contract address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_C4vkT2PBy8VfKlAJKvOPr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Lists all DEX liquidity pools for a Base token, including pair address, DEX name, quote symbol, price, liquidity depth, and 24h volume, sorted by liquidity.","exampleAgentPrompt":"Show me all the DEX pools available for the Base token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, sorted by liquidity, so I can see where and how deeply it can be traded.","exampleUseCases":[{"title":"Pre-trade liquidity check","prompt":"Before I swap a large amount, can you pull up all the DEX pools for the Base token at 0x4200000000000000000000000000000000000006 and tell me which pool has the deepest liquidity?"},{"title":"Token due diligence for listing","prompt":"I'm evaluating this Base token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — can you list every DEX it's traded on, with the liquidity and 24h volume for each pool?"},{"title":"Arbitrage opportunity discovery","prompt":"Find all trading pools for the Base token 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb and show me the price on each DEX so I can spot any price discrepancies between pools."}],"resultDescription":"Returns a list of DEX liquidity pools for the given Base token, each entry containing the pair contract address, DEX name, quote token symbol, current token price, total liquidity (USD), and 24-hour trading volume, sorted from highest to lowest liquidity.","failureModes":["Invalid or non-existent token contract address returns empty pool list or error","Token exists on Base but has no DEX pools — returns empty array","Malformed address string causes validation error","Network or upstream data provider outage returns 5xx error","Payment not settled results in 402 response blocking data delivery"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive view of where a specific Base token is tradeable across all DEXes, including liquidity depth and volume data. Prefer this over general token price lookups when the goal is to assess tradability, compare DEX liquidity, identify the best execution venue, or perform pre-trade due diligence on slippage risk.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:32:02.996Z","isFirstParty":false}