{"uid":"cap_twWPHJ4IvIf9PSbeZsuJo","slug":"public-zapper-xyz-bb417b90","name":"Zapper Historical Token Price","description":"Get a token's price at a specific timestamp on a given chain, returned in the requested currency.","url":"https://public.zapper.xyz/x402/historical-token-price","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string","description":"The 0x contract address of the token"},"chainId":{"type":"integer","description":"The Chain ID (e.g. 8453 for Base)"},"currency":{"type":"string","default":"USD","description":"Currency for price data (default: USD)"},"timestamp":{"type":"integer","description":"The unix timestamp (in milliseconds) for the historical lookup"}}},"responseSchema":null,"example":{"request":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","chainId":1,"timestamp":1704067200000},"response":{"_nonJson":true,"_preview":"{\"data\":{\"fungibleTokenV2\":{\"address\":\"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\",\"symbol\":\"USDC\",\"name\":\"USDC\",\"decimals\":6,\"imageUrlV2\":\"https://storage.googleapis.com/zapper-fi-assets/tokens/ethereum/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.png\",\"priceData\":{\"historicalPrice\":{\"timestamp\":1704070409000,\"price\":1.0000964403152466}}}}}\n","_contentType":"text/plain; charset=utf-8"}},"exampleRequest":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","chainId":1,"timestamp":1704067200000},"tags":["x402"],"displayCostAmount":"0.001125","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001125/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001125","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001125","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_p70j2K7gG31gwTEFs7-Gv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001125","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the historical USD price of an ERC20 or gas token at a specific past timestamp on a given blockchain network.","exampleAgentPrompt":"What was the price of USDC (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) on Ethereum mainnet (chain ID 1) on January 1st 2024 at midnight UTC?","exampleUseCases":null,"resultDescription":"Returns historical price data for the specified token at the given timestamp, including the USD price and related metadata for that point in time.","failureModes":["Invalid token contract address returns error or empty result","Unsupported chain ID results in no data found","Timestamp too far in the past may return null or unavailable price","Malformed unix timestamp (wrong units, e.g. seconds instead of milliseconds) causes incorrect or missing results","Token with no price history at that timestamp returns empty or null price"],"whenToPreferThis":"Use this endpoint when you need the USD price of a specific token at a past point in time on a supported EVM chain. Ideal for portfolio P&L calculations, historical trade valuation, tax reporting, or auditing past DeFi positions. Prefer this over current-price endpoints when the timestamp is historical rather than real-time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T10:28:43.641Z","isFirstParty":false}