{"uid":"cap_OAyaev41rf8P6MZidY03s","slug":"x402-token-quotes-api-585d9e00","name":"x402 Token Quotes API","description":"USDC pay-per-call APIs for AI agents via the x402 protocol (v2, exact, Base mainnet). Send a request, receive HTTP 402 with payment requirements, pay with @x402/fetch or any x402 client, retry with the PAYMENT-SIGNATURE header.","url":"https://call402.com/api/token-quotes?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string","description":"Token contract address (EVM 0x... or Solana)"}}},"responseSchema":{"type":"json","example":{"meta":{"note":"Pairs where the token is the base asset rank first; price_usd is always the queried token's price.","source":"dexscreener","pairs_total":1},"found":true,"pairs":[{"dex":"aerodrome","url":"https://dexscreener.com/base/0x...","chain":"base","fdv_usd":null,"txns_24h":1200,"price_usd":1,"base_token":{"name":"USD Coin","symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"token_role":"base","pair_address":"0x...","quote_symbol":"WETH","liquidity_usd":5000000,"volume_1h_usd":40000,"market_cap_usd":null,"volume_24h_usd":900000,"pair_created_at":"2024-01-01T00:00:00.000Z"}],"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},"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_z52UZJDmvp-KwVcNAi47L","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":"Returns DEX trading pair data and current USD price for a given EVM or Solana token contract address, paid per-call via USDC over the x402 protocol.","exampleAgentPrompt":"What's the current USD price and DEX trading data for the token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?","exampleUseCases":[{"title":"Real-time token price check","prompt":"What's the current USD price of the token at contract address 0x6B175474E89094C44Da98b954EedeAC495271d0F and which DEX is it trading on?"},{"title":"DeFi portfolio liquidity audit","prompt":"Can you pull the liquidity and 24-hour volume for the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 so I can assess if it's safe to make a large trade?"},{"title":"New token market cap discovery","prompt":"I just found a new token on Base at address 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed — can you tell me its market cap, FDV, and which pairs it's trading in?"}],"resultDescription":"Returns a JSON object with a list of DEX trading pairs for the queried token, including: the token's current USD price, DEX name, chain, pair address, quote symbol, liquidity in USD, 1h and 24h volume in USD, 24h transaction count, FDV, market cap, pair creation date, and a DexScreener URL. Also includes metadata about the data source and total number of pairs found.","failureModes":["Invalid or malformed contract address returns an error or found:false","Token not listed on DexScreener returns empty pairs array","Solana address format may not be supported depending on DexScreener coverage","Payment failure via x402 results in HTTP 402 with payment requirements and no data returned","Network or upstream DexScreener outage may cause timeouts or incomplete data"],"whenToPreferThis":"Choose this endpoint when you need real-time DEX market data (price, liquidity, volume, pairs) for a specific EVM or Solana token contract address, and you are operating in an x402-compatible agent environment that can handle micropayments in USDC on Base mainnet. Prefer this over manual DexScreener scraping or other price feeds when you need structured, API-ready data with no API key management overhead — just pay $0.005 USDC per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:35:59.970Z","isFirstParty":false,"canonicalSlug":"x402-token-quotes-api-585d9e00"}