{"uid":"cap_1hCqW14F-ITDS-fWqrjA9","slug":"coingecko-onchain-token-price-market-data-base-network-50f686b2","name":"CoinGecko Onchain Token Price & Market Data (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/0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b,0x22af33fe49fd1fa80c7149773dde5890d3c76f3b,0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf","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":{"request":{"input":{"type":"http","method":"GET","queryParams":{"include_24hr_vol":true,"include_market_cap":true,"include_24hr_price_change":true}},"output":{"type":"object","example":{"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b":{"usd":1.25,"usd_24h_vol":5000000,"usd_24h_change":2.5,"usd_market_cap":250000000},"0x22af33fe49fd1fa80c7149773dde5890d3c76f3b":{"usd":0.85,"usd_24h_vol":3000000,"usd_24h_change":-1.2,"usd_market_cap":170000000},"0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf":{"usd":2.1,"usd_24h_vol":8000000,"usd_24h_change":5.3,"usd_market_cap":420000000}}}},"response":{"data":{"id":"3d73b34e-1429-4ecb-b381-68202140572c","type":"simple_token_price","attributes":{"token_prices":{"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b":"0.602607427927481","0x22af33fe49fd1fa80c7149773dde5890d3c76f3b":"0.000465638117780285","0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf":"15.8613968738623"},"h24_volume_usd":{"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b":"14056976.8889089","0x22af33fe49fd1fa80c7149773dde5890d3c76f3b":"478986.164624658","0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf":"13200754.975005"},"market_cap_usd":{"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b":"395947772.7899246","0x22af33fe49fd1fa80c7149773dde5890d3c76f3b":"46563811.778028496","0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf":"741704805.237798"},"h24_price_change_percentage":{"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b":"-4.460275086725223","0x22af33fe49fd1fa80c7149773dde5890d3c76f3b":"-1.9089210685202622","0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf":"2.0125702528"}}}}},"exampleRequest":{"include_24hr_vol":true,"include_market_cap":true,"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_Iw1eTmyte9gOw7JRgedv7","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 price and market data for multiple token contract addresses on the Base network using CoinGecko's onchain data.","exampleAgentPrompt":"What are the current prices, 24-hour volume, and market caps of these three Base network tokens: 0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b, 0x22af33fe49fd1fa80c7149773dde5890d3c76f3b, and 0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf?","exampleUseCases":[{"title":"Monitor DeFi portfolio token values","prompt":"Can you check the current prices and 24-hour price changes for these Base tokens in my wallet: 0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b, 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, and 0x2Ae3F1Ec7F1F5012CFEab0411dBEFd259a8eE9F0?"},{"title":"Track emerging Base network token metrics","prompt":"I want to see which of these newer Base tokens has the most liquidity. Can you get the reserve data and trading volumes for 0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf, 0x22af33fe49fd1fa80c7149773dde5890d3c76f3b, and 0x7c6b91d9bfcd165ee317DAA1e4A9e0488eE1e4dC?"},{"title":"Alert on significant token price movements","prompt":"Check the 24-hour price change percentage for these Base protocol tokens so I can see which ones have moved the most: 0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b, 0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf, and 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."}],"resultDescription":"Returns a JSON object mapping each token contract address to its current USD price, and optionally 24hr trading volume, market cap, 24hr price change percentage, and total reserve in USD — all sourced from onchain DEX data on the Base network.","failureModes":["Invalid or unrecognized contract address returns empty or null data for that token","Network not supported returns 404 or error response","Too many contract addresses in one request may result in partial data or timeout","Inactive tokens may return no data unless include_inactive_source flag is set","Rate limit exceeded returns 429 error"],"whenToPreferThis":"Use this endpoint when you need real-time onchain DEX price data for specific token contract addresses on the Base network, especially when you have multiple tokens to price simultaneously. Prefer this over CoinGecko's standard coin price endpoints when you have contract addresses rather than coin IDs, and when you need onchain/DEX-specific data rather than aggregated CEX prices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:03:13.344Z","isFirstParty":false}