{"uid":"cap_UYGLyBouRHuveeAUyabub","slug":"santyvv-data-historical-token-price-by-contract-ec66c39e","name":"santyvv-data Historical Token Price by Contract","description":"Historical token price by contract at a Unix timestamp","url":"https://santyvv-x402.santyvv1993.workers.dev/api/crypto/token-price-historical?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_fhSs16vS6h3FfkcNEFvds","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":"Returns the historical price of an ERC-20 token at a specific Unix timestamp, identified by its contract address","exampleAgentPrompt":"What was the price of the WETH token (contract 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2) on Ethereum at Unix timestamp 1700000000?","exampleUseCases":[{"title":"Portfolio historical valuation snapshot","prompt":"I need to know what the USDC token at contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 was worth on Ethereum at Unix timestamp 1690000000 so I can calculate my portfolio value at that point."},{"title":"Transaction-time price audit","prompt":"Can you look up the price of the token at contract 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum exactly when a transaction happened — the Unix timestamp is 1672531200?"},{"title":"DeFi yield calculation at entry point","prompt":"What was the price of the Uniswap token at contract 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Unix timestamp 1680000000? I need it to work out my returns since I entered that position."}],"resultDescription":"Returns the historical USD price (or equivalent denomination) of the specified ERC-20 token contract at the requested Unix timestamp, allowing point-in-time valuation of on-chain assets","failureModes":["Invalid or non-existent contract address returns an error or empty result","Unix timestamp out of supported historical range returns no data","Unsupported chain or network returns an error","Token contract with no price feed history at that timestamp returns null or error","Missing required query parameters returns a 400-level validation error"],"whenToPreferThis":"Use this endpoint when you need the price of a specific ERC-20 token at an exact past moment in time identified by Unix timestamp and contract address — ideal for transaction audits, historical portfolio valuations, P&L calculations, and tax reporting where point-in-time accuracy is critical. Prefer this over live-price endpoints when the moment of interest is in the past.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T00:35:38.741Z","isFirstParty":false,"canonicalSlug":"santyvv-data-historical-token-price-by-contract-ec66c39e"}