{"uid":"cap_emizsGiH803GYXWIRLkTH","slug":"allium-history-d97863ee","name":"Allium Historical Token Price Series","description":"Get historical token price series","url":"https://agents.allium.so/api/v1/developer/prices/history?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"addresses":{"type":"array","items":{"type":"object","required":["token_address","chain"],"properties":{"chain":{"type":"string","description":"Blockchain network (e.g. ethereum, solana, base)"},"token_address":{"type":"string","description":"Token contract address"}}}},"end_timestamp":{"type":"string","format":"date-time","description":"ISO 8601 timestamp"},"start_timestamp":{"type":"string","format":"date-time","description":"ISO 8601 timestamp"},"time_granularity":{"enum":["15s","1m","5m","1h","1d"],"type":"string","description":"Time granularity for price buckets"}}},"responseSchema":null,"example":{"request":{"addresses":[{"chain":"ethereum","token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}],"end_timestamp":"2025-01-31T23:59:59Z","start_timestamp":"2025-01-01T00:00:00Z","time_granularity":"1h"},"response":{"_truncated":true,"_originalSize":124405}},"exampleRequest":{"addresses":[{"chain":"ethereum","token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}],"end_timestamp":"2025-01-31T23:59:59Z","start_timestamp":"2025-01-01T00:00:00Z","time_granularity":"1h"},"tags":["blockchain","prices","tokens","wallet","balances","transactions","pnl","sql","explorer","solana","base","defi","data"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xzNS_02IAdR2HGPeCNSGw","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_8XsIX8aWsAXw9bd2g6XmA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"Allium","brandSlug":"allium","brandBaseUrl":"https://allium.so","brandDocsUrl":"https://docs.allium.so","whatItDoes":"Returns a time-series of historical token prices for one or more tokens across specified blockchains, bucketed by a chosen time granularity","exampleAgentPrompt":"Can you pull the hourly price history for USDC on Ethereum (contract 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48) from January 1, 2025 to January 31, 2025 using 1-hour granularity?","exampleUseCases":null,"resultDescription":"A time-series array of price data points for each requested token, indexed by timestamp and bucketed according to the specified granularity (15s, 1m, 5m, 1h, or 1d), covering the requested time range across the specified chains.","failureModes":["Invalid or unsupported token contract address returns an error or empty series","Unsupported chain identifier causes a validation error","Start timestamp after end timestamp returns an error","Requested time range too large for the chosen granularity may time out or return partial data","Token not indexed by Allium returns empty results","Malformed ISO 8601 timestamp causes a 400 bad request"],"whenToPreferThis":"Use this endpoint when you need time-series price data for one or more tokens over a historical period with fine-grained control over time buckets (from 15 seconds to 1 day). Ideal for PnL calculations, charting, backtesting, and filling historical price gaps. Prefer over spot-price endpoints when you need a range rather than a single moment in time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:39:35.688Z","isFirstParty":false,"canonicalSlug":"allium-history-d97863ee"}