{"uid":"cap_ubTiIi19SxLwcfwFzz9kp","slug":"pro-api-coingecko-com-ef6be7b8","name":"CoinGecko Pro: Onchain DEX Token Price & Market Data (Base Network, Specific Contract)","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/0x00881016b7324678f4012fbca0c0267b69ebd10e","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":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","type","attributes"],"properties":{"id":{"type":"string"},"type":{"type":"string"},"attributes":{"type":"object","required":["token_prices","h24_volume_usd","market_cap_usd","total_reserve_in_usd","h24_price_change_percentage"],"properties":{"token_prices":{"type":"object","required":["0x00881016b7324678f4012fbca0c0267b69ebd10e"],"properties":{"0x00881016b7324678f4012fbca0c0267b69ebd10e":{"type":"null"}}},"h24_volume_usd":{"type":"object","required":["0x00881016b7324678f4012fbca0c0267b69ebd10e"],"properties":{"0x00881016b7324678f4012fbca0c0267b69ebd10e":{"type":"string"}}},"market_cap_usd":{"type":"object","required":["0x00881016b7324678f4012fbca0c0267b69ebd10e"],"properties":{"0x00881016b7324678f4012fbca0c0267b69ebd10e":{"type":"null"}}},"total_reserve_in_usd":{"type":"object","required":["0x00881016b7324678f4012fbca0c0267b69ebd10e"],"properties":{"0x00881016b7324678f4012fbca0c0267b69ebd10e":{"type":"string"}}},"h24_price_change_percentage":{"type":"object","required":["0x00881016b7324678f4012fbca0c0267b69ebd10e"],"properties":{"0x00881016b7324678f4012fbca0c0267b69ebd10e":{"type":"string"}}}}}}}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"include_24hr_vol":true,"mcap_fdv_fallback":true,"include_market_cap":true,"include_inactive_source":false,"include_24hr_price_change":true,"include_total_reserve_in_usd":true}},"output":{"type":"object","example":{"data":{"id":"test-id","type":"simple_token_price","attributes":{"token_prices":{"0x00881016b7324678f4012fbca0c0267b69ebd10e":{"usd":1.25,"usd_24h_vol":500000,"usd_24h_change":2.5,"usd_market_cap":10000000,"total_reserve_in_usd":750000}}}}}}},"response":{"data":{"id":"60e652f4-6d91-4747-bb4f-dbd1e825d4e5","type":"simple_token_price","attributes":{"token_prices":{"0x00881016b7324678f4012fbca0c0267b69ebd10e":null},"h24_volume_usd":{"0x00881016b7324678f4012fbca0c0267b69ebd10e":"0.0"},"market_cap_usd":{"0x00881016b7324678f4012fbca0c0267b69ebd10e":null},"total_reserve_in_usd":{"0x00881016b7324678f4012fbca0c0267b69ebd10e":"9.42416204249831355"},"h24_price_change_percentage":{"0x00881016b7324678f4012fbca0c0267b69ebd10e":""}}}}},"exampleRequest":{"include_24hr_vol":true,"mcap_fdv_fallback":true,"include_market_cap":true,"include_inactive_source":false,"include_24hr_price_change":true,"include_total_reserve_in_usd":true},"tags":["x402"],"displayCostAmount":"0.010000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.010000/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_OOnAMKfOwYLOBAMZn27TK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time on-chain DEX price and market data for a specific token contract address (0x00881016b7324678f4012fbca0c0267b69ebd10e) on the Base network.","exampleAgentPrompt":"What's the current on-chain DEX price, 24-hour volume, market cap, and 24-hour price change for the token at contract address 0x00881016b7324678f4012fbca0c0267b69ebd10e on the Base network?","exampleUseCases":[{"title":"Monitor Base token price movements","prompt":"Can you check the current USD price and 24-hour price change for the token at 0x00881016b7324678f4012fbca0c0267b69ebd10e on Base? I want to know if it's trending up or down."},{"title":"Track DeFi liquidity and market cap","prompt":"I need to see the market cap, total reserve in USD, and 24-hour trading volume for this Base network token contract 0x00881016b7324678f4012fbca0c0267b69ebd10e to assess liquidity."},{"title":"Compare on-chain vs off-chain pricing","prompt":"What's the real-time DEX price on Base for 0x00881016b7324678f4012fbca0c0267b69ebd10e? I want to compare how it trades on-chain versus centralized exchanges."}],"resultDescription":"Returns a JSON object containing the current USD price of the token as traded on DEXes on the Base network, optionally including 24hr trading volume, market cap, 24hr price change percentage, and total reserve in USD — all sourced from CoinGecko's onchain data aggregation.","failureModes":["Token contract address not found on Base network — returns empty or null data","Network congestion causing stale DEX price data","Invalid or malformed contract address returns 400 error","Payment not completed (x402 payment required) — returns 402 Payment Required","Rate limit exceeded — returns 429 Too Many Requests","Token has no active liquidity pool on Base — returns no price data"],"whenToPreferThis":"Use this endpoint when you need real-time on-chain DEX price data specifically for a known token contract address on the Coinbase Base network, and need optional enrichment like 24hr volume, market cap, or reserve data. Prefer this over CoinGecko's off-chain simple price endpoint when you need DEX-sourced prices rather than CEX aggregates, or when the token is only traded on-chain.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:56:11.896Z","isFirstParty":false}