{"uid":"cap_YFxFBzErPCEI48RHtZdm4","slug":"defillama-token-price-percentage-change-2f1c6071","name":"DefiLlama Token Price Percentage Change","description":"Token price change by DefiLlama — percentage price move over a period for one or many coins.","url":"https://defillama.use.x402atlas.com/prices-percentage","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"],"type":"string"},"queryParams":{"type":"object","required":["coins"],"properties":{"coins":{"type":"string","pattern":"^[A-Za-z0-9:,_.-]+$","maxLength":3000,"minLength":1,"description":"Comma-separated coins as {chain}:{address} or coingecko:{id}"},"period":{"type":"string","maxLength":200,"description":"Optional duration over which to measure the change (e.g. 3w)"},"timestamp":{"type":"string","maxLength":200,"description":"Optional unix timestamp to measure the change from (defaults to now)"},"lookForward":{"type":"string","maxLength":200,"description":"Optional whether to look forward from timestamp (true/false)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","data"],"properties":{"data":{"type":"object","properties":{"coins":{"type":"object","description":"Map keyed by the requested coin id to its percentage price change (number)","additionalProperties":{"type":"number"}}}},"queried_at":{"type":"string","format":"date-time","description":"Time the upstream was queried"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"coins":{"coingecko:ethereum":12.34}},"queried_at":"2026-07-01T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tUJZTIwAHD8Ru3nS0t1M_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","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 over a specified period for one or many tokens, identified by chain address or CoinGecko ID.","exampleAgentPrompt":"What's the percentage price change for ethereum (coingecko:ethereum) and solana (coingecko:solana) over the past 3 weeks using DefiLlama's price data?","exampleUseCases":[{"title":"Portfolio performance tracking dashboard","prompt":"Can you check how much my ETH, SOL, and USDC positions have moved in percentage terms over the last month? I want to see which ones are outperforming."},{"title":"DeFi yield strategy optimization alerts","prompt":"Show me the 30-day price changes for the top 5 tokens in my liquidity pool. I need to know which ones have momentum so I can decide whether to rebalance."},{"title":"Crypto market momentum analysis report","prompt":"Get me the percentage price movements for Bitcoin, Ethereum, and the major altcoins over the past 7 days. I'm trying to understand if we're in a bull or bear phase right now."}],"resultDescription":"A map of coin identifiers to their percentage price change over the specified period, showing how much each token's price moved (up or down) relative to the starting point.","failureModes":["Invalid or unrecognized coin identifier returns error or missing data for that coin","Malformed period string (e.g. unsupported duration format) may return an error","Timestamp too far in the past with no historical data returns empty or null values","Missing required 'coins' query parameter returns a 400 or validation error","Network or upstream DefiLlama data unavailability returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need to know how much a token's price has moved (as a percentage) over a given time window — ideal for performance comparison, momentum analysis, or alerting. Prefer this over current-price endpoints when relative change matters more than absolute price. Best for multi-coin comparisons and historical period analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:39:21.536Z","isFirstParty":false}