{"uid":"cap_DE2vHn--B8Uf0NgWkE8Ak","slug":"agents-allium-so-f2b2bd46","name":"Allium At-Timestamp Token Prices","description":"API request: /api/v1/developer/prices/at-timestamp","url":"https://agents.allium.so/api/v1/developer/prices/at-timestamp","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":{"type":"json","example":{"items":[{"mint":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","chain":"ethereum","price":2500.5,"input_timestamp":"2025-07-11T00:00:00Z","price_timestamp":"2025-07-10T23:55:00Z"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"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":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TVHxIAzznFOi2KOirs9Gy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical token prices at a specific past timestamp on-chain","exampleAgentPrompt":"What was the price of ETH on March 15, 2024 at 3:00 PM UTC? Use Allium's historical price lookup.","exampleUseCases":null,"resultDescription":"Returns the price of the specified token at the requested timestamp, including the token symbol, price value, denomination (e.g. USD), and the resolved timestamp from Allium's onchain price data.","failureModes":["Token not supported — returns error if the token is not in Allium's supported token list","Timestamp out of range — returns error if the timestamp predates available price data","Invalid token identifier — malformed or unrecognized token symbol/address returns an error","Network unavailable — transient upstream data issues may cause 5xx errors","Missing required parameters — omitting token or timestamp returns a 400-level validation error"],"whenToPreferThis":"Use this endpoint when you need to know what a specific crypto token was worth at a precise past moment — for example, to calculate PnL on a past trade, reconcile historical portfolio values, or audit the value of tokens at the time of a transaction. Prefer this over a current-price endpoint when the target time is in the past and precision is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:41:16.966Z","isFirstParty":false}