{"uid":"cap_hZO55PqjBM-rfW87wWqCW","slug":"token-price-lookup-live-historical-x402utils-3583e273","name":"Token Price Lookup — Live & Historical (x402utils)","description":"Live and historical token prices for agents, any chain: coingecko ids or chain:contract addresses, plus % change over a period. Paid per call via x402 (USDC on Base).","url":"https://prices.x402utils.workers.dev/v1/price?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["coins"],"properties":{"coins":{"type":"string","description":"comma-separated coin ids"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"prices":{"coingecko:bitcoin":{"price":84376.78,"symbol":"BTC"}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wX_TwJg3l-dXc1AJtkEUU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live or historical prices and percentage change for crypto tokens identified by CoinGecko IDs or chain:contract address pairs, across any chain.","exampleAgentPrompt":"What's the current price of Bitcoin and Ethereum right now? Use their CoinGecko IDs — bitcoin and ethereum.","exampleUseCases":[{"title":"DeFi portfolio value tracker","prompt":"Get me the live prices for bitcoin, ethereum, and solana so I can calculate the current value of my crypto portfolio."},{"title":"Multi-chain token price check","prompt":"What's the current USD price of the token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?"},{"title":"Price change alert system","prompt":"Fetch the price and 24-hour percentage change for coingecko:chainlink and coingecko:uniswap so I can check if either has moved more than 10% today."}],"resultDescription":"Returns a JSON object with a `prices` map keyed by coin identifier (e.g. 'coingecko:bitcoin'), each containing the current USD price and token symbol, plus optional percentage change over the requested period.","failureModes":["Invalid or unrecognized coin ID returns an error or empty entry for that coin","Malformed comma-separated coin list causes a 400-level error","Network or upstream CoinGecko outage may return stale or unavailable data","Missing x402 payment header results in a 402 Payment Required response","Requesting too many coins in a single call may result in timeouts or truncated results"],"whenToPreferThis":"Choose this endpoint when you need real-time or historical token prices across any blockchain, especially when tokens are identified by CoinGecko IDs or chain:contract address pairs. It is ideal for multi-chain DeFi workflows, portfolio valuation, price-triggered automations, or any agent that needs structured price data paid per call with USDC via x402 rather than a subscription API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:32:19.030Z","isFirstParty":false,"canonicalSlug":"token-price-lookup-live-historical-x402utils-3583e273"}