{"uid":"cap_A4U7OT3ETNAm5Ae0voR0n","slug":"allium-history-388124b4","name":"Allium Wallet Balance History","description":"Get historical wallet balances","url":"https://agents.allium.so/api/v1/developer/wallet/balances/history?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"addresses":{"type":"array","items":{"type":"object","required":["chain","address"],"properties":{"chain":{"type":"string","description":"Blockchain network (e.g. ethereum, solana, base)"},"address":{"type":"string","description":"Wallet address"}}}},"end_timestamp":{"type":"string","format":"date-time","description":"ISO 8601 timestamp"},"start_timestamp":{"type":"string","format":"date-time","description":"ISO 8601 timestamp"}}},"responseSchema":null,"example":{"request":{"addresses":[{"chain":"ethereum","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}],"end_timestamp":"2024-01-31T23:59:59Z","start_timestamp":"2024-01-01T00:00:00Z"},"response":{"_truncated":true,"_originalSize":275964}},"exampleRequest":{"addresses":[{"chain":"ethereum","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}],"end_timestamp":"2024-01-31T23:59:59Z","start_timestamp":"2024-01-01T00:00:00Z"},"tags":["blockchain","prices","tokens","wallet","balances","transactions","pnl","sql","explorer","solana","base","defi","data"],"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":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GmhmzphQw0PMGO1VJK79z","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_3nIOqHJTgFddK95wd9oS7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","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 historical token balances for one or more wallet addresses across specified blockchains over a given time range","exampleAgentPrompt":"Can you pull the historical token balances for the Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 from January 1 2024 to January 31 2024?","exampleUseCases":null,"resultDescription":"A time-series dataset of token balances held by the specified wallet address(es) on the given chain(s) between the start and end timestamps, including token identities and balance amounts at various points in time.","failureModes":["Invalid or unsupported chain name returns an error","Malformed wallet address causes a bad request response","Start timestamp after end timestamp returns a validation error","Very large time ranges may result in truncated responses","Unsupported chain/address combinations return empty or error results"],"whenToPreferThis":"Use this endpoint when you need to understand how wallet balances changed over a historical period — for auditing, portfolio tracking, tax reporting, or analyzing past DeFi activity. Prefer this over the current Balances endpoint when point-in-time or time-series balance data is needed rather than live balances.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:40:08.526Z","isFirstParty":false,"canonicalSlug":"allium-history-388124b4"}