{"uid":"cap_FM2OJ8yswdeqbdIfWrdyj","slug":"x-data-gateway-token-trading-pairs-lookup-bf469e36","name":"X Data Gateway — Token Trading Pairs Lookup","description":"Top liquidity pairs for a token address from DexScreener. e.g. GET /v1/token/pairs?address=0x...","url":"https://x-data-gateway.annushka1190.workers.dev/v1/token/pairs","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Token contract 0x..."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_f3oHYjI8wdTjPKqfNe1AA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches all trading pairs for a given Base token contract address, including DEX pair data and liquidity info","exampleAgentPrompt":"Look up all the trading pairs for the Base token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I want to see which DEXes it's listed on and what the liquidity looks like.","exampleUseCases":[{"title":"New token DEX coverage check","prompt":"I just heard about a new token on Base — can you pull all the trading pairs for contract 0x4200000000000000000000000000000000000006 so I can see which DEXes have it listed and how liquid it is?"},{"title":"Arbitrage opportunity research","prompt":"Check all the DEX pairs for the Base token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I want to know if there are price differences across different liquidity pools I could take advantage of."},{"title":"DeFi portfolio pair audit","prompt":"For the token contract 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base, fetch all trading pairs so I can see the full market structure before I invest."}],"resultDescription":"Returns a JSON object containing all known trading pairs for the specified token contract on Base, including DEX names, pair addresses, liquidity figures, price data, and volume metrics sourced from DexScreener.","failureModes":["Invalid or malformed contract address returns an error or empty result","Token not listed on any tracked DEX returns empty pairs array","Network timeout from upstream DexScreener data source","Missing required 'address' query parameter returns 400-level error","Non-Base EVM address may return no results or cross-chain confusion"],"whenToPreferThis":"Use this endpoint when you need comprehensive DEX pair coverage for a specific Base token contract — it aggregates all trading venues and liquidity pools in one call. Prefer it over spot-price endpoints when you need the full market structure (multiple pairs, multiple DEXes) rather than a single price quote. Ideal for DeFi research, liquidity analysis, and pre-trade market structure checks on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:45:00.362Z","isFirstParty":false}