{"uid":"cap_md8QkE-89jQzu4_SOox1q","slug":"allium-at-timestamp-4d1409af","name":"Allium At Timestamp Token Prices","description":"Get token prices at a specific time","url":"https://agents.allium.so/api/v1/developer/prices/at-timestamp?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"}}}},"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"},{"chain":"solana","token_address":"So11111111111111111111111111111111111111112"}],"timestamp":"2024-03-15T14:30:00Z","time_granularity":"1h"},"response":{"items":[{"mint":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","chain":"ethereum","price":1.000929951418074,"input_timestamp":"2024-03-15T14:30:00Z","price_timestamp":"2024-03-15T14:00:00"},{"mint":"So11111111111111111111111111111111111111112","chain":"solana","price":180.87868193649282,"input_timestamp":"2024-03-15T14:30:00Z","price_timestamp":"2024-03-15T14:00:00"}]}},"exampleRequest":{"addresses":[{"chain":"ethereum","token_address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},{"chain":"solana","token_address":"So11111111111111111111111111111111111111112"}],"timestamp":"2024-03-15T14:30: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_worr1hWWa5xmJjaGzZk0G","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_usNZJ344dqwaWRSkQG_K2","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 token prices at or near a specific historical timestamp for one or more tokens across multiple chains","exampleAgentPrompt":"What were the prices of USDC on Ethereum (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) and wrapped SOL on Solana (So11111111111111111111111111111111111111112) on March 15, 2024 at 2:30pm UTC — snap to the nearest 1-hour bucket?","exampleUseCases":null,"resultDescription":"An array of price records, each containing the token mint address, blockchain network, the requested input timestamp, the nearest snapped price timestamp (based on the chosen granularity), and the token price in USD at that time.","failureModes":["Token address not recognized or not indexed — returns empty items array for that token","Timestamp too far in the past or outside supported range — may return no price data","Invalid chain identifier — validation error or empty result","Unsupported time_granularity value — schema validation error","Malformed ISO 8601 timestamp — request rejected with validation error","Network or service unavailability — HTTP 5xx error"],"whenToPreferThis":"Use this endpoint when you need the price of one or more tokens at a specific historical moment in time, such as for PnL calculations, portfolio valuations at a past date, or reconstructing trade values. Prefer this over the History endpoint when you want a single point-in-time price rather than a time series, and over the Prices endpoint when you need historical rather than current prices. Supports multiple chains and tokens in a single request, making it efficient for cross-chain portfolio snapshots.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:38:20.204Z","isFirstParty":false,"canonicalSlug":"allium-at-timestamp-4d1409af"}