{"uid":"cap_idAnHTczNtiCfucODC0Vu","slug":"pro-api-coingecko-com-20fe2a2e","name":"CoinGecko Onchain Token Price – Base Network (0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed)","description":"Returns the current price for a specified token contract on the Base network using CoinGecko's onchain pricing API.","url":"https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed","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":["0x4ed4e862860bed51a9570b96d89af5e1b0efefed"],"properties":{"0x4ed4e862860bed51a9570b96d89af5e1b0efefed":{"type":"string"}}},"h24_volume_usd":{"type":"object","required":["0x4ed4e862860bed51a9570b96d89af5e1b0efefed"],"properties":{"0x4ed4e862860bed51a9570b96d89af5e1b0efefed":{"type":"string"}}},"market_cap_usd":{"type":"object","required":["0x4ed4e862860bed51a9570b96d89af5e1b0efefed"],"properties":{"0x4ed4e862860bed51a9570b96d89af5e1b0efefed":{"type":"string"}}},"total_reserve_in_usd":{"type":"object","required":["0x4ed4e862860bed51a9570b96d89af5e1b0efefed"],"properties":{"0x4ed4e862860bed51a9570b96d89af5e1b0efefed":{"type":"string"}}},"h24_price_change_percentage":{"type":"object","required":["0x4ed4e862860bed51a9570b96d89af5e1b0efefed"],"properties":{"0x4ed4e862860bed51a9570b96d89af5e1b0efefed":{"type":"string"}}}}}}}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"include_24hr_vol":true,"mcap_fdv_fallback":false,"include_market_cap":true,"include_inactive_source":false,"include_24hr_price_change":true,"include_total_reserve_in_usd":false}},"output":{"type":"object","example":{"0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed":{"usd":0.00123,"usd_24h_vol":1500000,"usd_24h_change":5.25,"usd_market_cap":500000000}}}},"response":{"data":{"id":"5060233b-839b-4b28-b3e7-79b595aa6965","type":"simple_token_price","attributes":{"token_prices":{"0x4ed4e862860bed51a9570b96d89af5e1b0efefed":"0.00150162171263878"},"h24_volume_usd":{"0x4ed4e862860bed51a9570b96d89af5e1b0efefed":"533024.557065931"},"market_cap_usd":{"0x4ed4e862860bed51a9570b96d89af5e1b0efefed":"55508543.29158276"},"h24_price_change_percentage":{"0x4ed4e862860bed51a9570b96d89af5e1b0efefed":"-4.399386068474656"}}}}},"exampleRequest":{"include_24hr_vol":true,"mcap_fdv_fallback":false,"include_market_cap":true,"include_inactive_source":false,"include_24hr_price_change":true,"include_total_reserve_in_usd":false},"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_ea6OzTwBbUMotciJNCxj2","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 the current onchain USD price and market data for the token at contract address 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on the Coinbase Base network.","exampleAgentPrompt":"What's the current onchain USD price, 24h trading volume, market cap, and 24h price change for the token at contract 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed 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 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on Base? I want to see if it's up or down today."},{"title":"Track DeFi token liquidity and volume","prompt":"What's the total liquidity reserve and 24-hour trading volume for the contract 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on the Base network right now?"},{"title":"Assess Base token market cap","prompt":"Get me the current market cap and USD price for the token at 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on Base so I can understand its size in the ecosystem."}],"resultDescription":"Returns a JSON object keyed by the token contract address (lowercased) containing: current USD price as a string, 24-hour volume in USD, market cap in USD, total liquidity reserve in USD, and 24-hour price change percentage — all sourced from CoinGecko's onchain DEX aggregation.","failureModes":["Token contract not found or not indexed by CoinGecko — returns empty or null data","Invalid contract address format — may return 400 or empty response","Network mismatch (wrong chain) — no price data returned","Payment failure (x402 flow) — 402 response if USDC payment not completed","CoinGecko API unavailable or rate-limited — 5xx or 429 error","Token is inactive on Base DEX — no recent price available if include_inactive_source is false"],"whenToPreferThis":"Use this endpoint when you need real-time onchain price data for the specific token at 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on Base, sourced from DEX liquidity pools rather than centralized exchange feeds. Prefer this over CoinGecko's off-chain /simple/price endpoint when you need DEX-native pricing, reserve data, or when the token is not listed on major centralized exchanges. Ideal for DeFi analytics, portfolio trackers, or arbitrage monitors focused on the Base ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:55:36.568Z","isFirstParty":false}