{"uid":"cap_g8bGWZIURf-s9VdvhcH_q","slug":"token-price-percentage-change-api-7a4a4359","name":"Token Price Percentage Change API","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/change?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"},"period":{"type":"string","description":"1h, 24h, 7d or 4w"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"period":"24h","change_pct":{"coingecko:bitcoin":-0.06}}},"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_mFIMO0sbJluat5WUUd-uA","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 the percentage price change for one or more tokens over a specified time period (1h, 24h, 7d, or 4w), supporting CoinGecko IDs or chain:contract addresses.","exampleAgentPrompt":"What's the percentage price change for bitcoin and ethereum over the last 24 hours?","exampleUseCases":[{"title":"Portfolio daily performance snapshot","prompt":"Show me the 24-hour price change percentages for bitcoin, ethereum, and solana so I can see how my holdings are doing today."},{"title":"DeFi token contract price tracking","prompt":"What's the 7-day price change for the token at ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48?"},{"title":"Hourly volatility alert check","prompt":"Check the last 1-hour price change for bitcoin and let me know if it moved more than 2% in either direction."}],"resultDescription":"A JSON object containing the requested period label and a 'change_pct' map keyed by coin identifier (e.g. 'coingecko:bitcoin'), with the percentage price change as a decimal value (e.g. -0.06 means -6%).","failureModes":["Invalid or unrecognized coin ID returns an error or omits the token from results","Invalid period value (not one of 1h, 24h, 7d, 4w) may return a 400 error","Missing 'coins' query parameter returns a 400 validation error","Payment not completed via x402 returns a 402 Payment Required response","Rate limits or upstream CoinGecko outages may cause 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need percentage price change over a specific time period (1h, 24h, 7d, or 4w) for one or more tokens, identified by CoinGecko ID or on-chain contract address. It is ideal for multi-token batch comparisons and supports any EVM chain via contract address, making it more flexible than single-asset endpoints. Prefer it over raw price endpoints when relative performance (delta) rather than absolute price is what matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:37:17.160Z","isFirstParty":false,"canonicalSlug":"token-price-percentage-change-api-7a4a4359"}