{"uid":"cap_HEIN7k79YylMiC-_7629V","slug":"agents-allium-so-a91a4025","name":"Allium Wallet Balance History","description":"API request: /api/v1/developer/wallet/balances/history","url":"https://agents.allium.so/api/v1/developer/wallet/balances/history","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":{"type":"json","example":{"items":[{"chain":"ethereum","token":{"info":{"name":"Wrapped Ether","symbol":"WETH"},"type":"evm_erc20","chain":"ethereum","object":"token","address":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","decimals":18},"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","raw_balance":1500000000000000000,"block_number":20000000,"block_timestamp":"2025-06-17T00:00:00Z","raw_balance_str":"1500000000000000000"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"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":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yfJ6I2jcAyrSgxUqW5DXk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical token balance snapshots for a wallet address over time on-chain","exampleAgentPrompt":"Pull the historical token balance history for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum over the last 90 days so I can see how the portfolio changed month by month.","exampleUseCases":null,"resultDescription":"Returns a time-series of wallet token balances, including token symbols, amounts held, and optionally USD values at each recorded snapshot, allowing analysis of how holdings evolved over the specified time period.","failureModes":["Invalid or malformed wallet address returns 400 error","Unsupported blockchain network returns error or empty result","Date range too large may return partial data or timeout","No balance history found for new or empty wallets returns empty array","Insufficient payment or missing x402 payment header returns 402 error"],"whenToPreferThis":"Use this endpoint when you need time-series balance data for a wallet — e.g. for portfolio performance analysis, auditing, or charting balance changes. Prefer over the current-balances endpoint when historical snapshots matter. Prefer over raw SQL endpoints when you want a structured, pre-built response without writing queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:42:02.972Z","isFirstParty":false}