{"uid":"cap_nPAretIDD-YBU4DuQhVJ7","slug":"pro-api-coingecko-com-365edd3b","name":"CoinGecko Pro: On-Chain Token Price on Base Network","description":"Fetch the current on-chain price for a token on the Base network by contract address via CoinGecko Pro.","url":"https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b","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","h24_price_change_percentage"],"properties":{"token_prices":{"type":"object","required":["0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b"],"properties":{"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b":{"type":"string"}}},"h24_volume_usd":{"type":"object","required":["0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b"],"properties":{"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b":{"type":"string"}}},"h24_price_change_percentage":{"type":"object","required":["0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b"],"properties":{"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b":{"type":"string"}}}}}}}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"include_24hr_vol":true,"include_market_cap":false,"include_24hr_price_change":true}},"output":{"type":"object","example":{"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b":{"usd":1.25,"usd_24h_vol":5000000,"usd_24h_change":2.5}}}},"response":{"data":{"id":"4f2328f4-798b-43d4-8f8f-b02e4643c430","type":"simple_token_price","attributes":{"token_prices":{"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b":"0.714172890755159"},"h24_volume_usd":{"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b":"21760276.3304145"},"h24_price_change_percentage":{"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b":"0.3586407721"}}}}},"exampleRequest":{"include_24hr_vol":true,"include_market_cap":false,"include_24hr_price_change":true},"tags":["x402"],"displayCostAmount":"0.01","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.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_nipTFkl4ICZzsL7godqKO","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 on-chain price for a specific token contract address on the Coinbase Base network via CoinGecko Pro.","exampleAgentPrompt":"What's the current on-chain price of the token at contract address 0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b on the Base network, and can you also include its 24-hour volume and price change?","exampleUseCases":[{"title":"Monitor emerging Base network token prices","prompt":"I need to track the current price of this new Base token I found—contract address is 0x2ae3f1ec7f1f5012cfeab0411dfa8ce998e27661. Can you pull its real-time price and show me how much it's moved in the last 24 hours?"},{"title":"Compare DeFi token valuations across networks","prompt":"Help me check the on-chain price and market cap for the token at 0x50c5725949a6f0c72e6c4a641f14d13f46da8d69 on Base. I'm trying to understand if it's undervalued compared to other chains."},{"title":"Track stablecoin reserves and liquidity","prompt":"What's the current price and total reserve value in USD for the Base token at contract 0x833589fcd6edb6e08f4c7c32d4f71b1566469c3d? I want to make sure there's enough liquidity before I make a trade."}],"resultDescription":"Returns current on-chain price in fiat (e.g. USD) for the specified Base token contract, optionally including 24hr trading volume, market cap, 24hr price change percentage, total reserve in USD, and support for inactive source tokens.","failureModes":["Invalid or unknown contract address returns empty or error response","Token not indexed on CoinGecko for Base network returns 404 or empty data","Network connectivity or API key issues return 401/403/500 errors","Stale or illiquid token may have missing market data fields even if price is returned"],"whenToPreferThis":"Use this endpoint when you need real-time on-chain price data specifically for a token deployed on the Coinbase Base network, identified by contract address. Prefer over CoinGecko's general simple/price endpoint when dealing with newer or DEX-traded tokens not listed by coin ID, or when on-chain accuracy is required rather than aggregated CEX pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:33:28.868Z","isFirstParty":false}