{"uid":"cap_73YBP1Y_QuhpvW41Hncdu","slug":"coingecko-onchain-dex-token-price-base-network-824fc7be","name":"CoinGecko Onchain DEX Token Price (Base Network)","description":"Query onchain DEX token price & market data based on the provided token contract addresses on a network.","url":"https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/probe","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"include_24hr_vol":{"type":"boolean"},"mcap_fdv_fallback":{"type":"boolean"},"include_market_cap":{"type":"boolean"},"include_inactive_source":{"type":"boolean"},"include_24hr_price_change":{"type":"boolean"},"include_total_reserve_in_usd":{"type":"boolean"}}}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_S1mgMyhHD2twrq1wyxigF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time DEX token price and market data for tokens on the Base network by contract address.","exampleAgentPrompt":"What's the current price, 24-hour volume, and market cap for the token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on the Base network?","exampleUseCases":[{"title":"Live price check for a Base token","prompt":"Can you look up the current onchain price and 24-hour trading volume for the USDC token at contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?"},{"title":"Market cap monitoring for DeFi portfolio","prompt":"Pull the market cap and fully diluted valuation for the token at contract address 0x4200000000000000000000000000000000000006 on Base — I want to track it for my DeFi portfolio."},{"title":"New token launch due diligence","prompt":"I just saw a new token launch on Base at contract 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA — can you get me its current price, 24-hour price change, and total reserve in USD from CoinGecko onchain data?"}],"resultDescription":"Returns a JSON object keyed by token contract address containing real-time onchain data sourced from DEX pools, including token price in USD, optionally 24hr trading volume, market capitalization, 24hr price change percentage, total reserve in USD, and FDV/market cap fallback values.","failureModes":["Unknown or unlisted contract address returns empty or null price data","Network mismatch if the contract exists on another chain but not Base","Rate limiting or payment failure returns 402 or 429 error","Inactive token with no recent DEX activity may return stale or missing data","Malformed contract address returns 400 bad request"],"whenToPreferThis":"Choose this endpoint when you need real-time DEX-sourced token prices specifically on the Base network and you have the token contract address. Prefer this over CoinGecko's centralized price endpoints when dealing with newer or smaller tokens that may not have a CoinGecko coin ID but trade on-chain. It is especially useful for DeFi agents monitoring Base-native tokens, newly launched assets, or any token where onchain liquidity data (reserve, volume) matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:40:15.990Z","isFirstParty":false}