{"uid":"cap_kifSZcuAu2dJ6oTK114AC","slug":"usd-price-of-a-token-at-a-past-moment-12b07bdc","name":"USD Price of a Token at a Past Moment","description":"USD price of a token at a past moment — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/token-price-at?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"chain":{"enum":["ethereum","base","polygon","arbitrum","optimism","bsc","avalanche","gnosis","linea","scroll"],"type":"string"},"contract":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"timestamp":{"type":"integer","minimum":0}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"token-price-at","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.005,"receipt_id":"g402-<16hex>"},"generated_at":"<iso8601>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xlLX72Ewe1i90N_7vtUqA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the USD price of an EVM token contract at a specified Unix timestamp on a supported blockchain","exampleAgentPrompt":"What was the USD price of the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum at Unix timestamp 1700000000?","exampleUseCases":[{"title":"Tax-time token valuation lookup","prompt":"I need to know the USD price of the token at 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum at Unix timestamp 1672531200 — I'm calculating capital gains for last year."},{"title":"DeFi portfolio historical audit","prompt":"What was the price of the token at contract 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 on Polygon at timestamp 1680000000? I need it for a historical portfolio valuation report."},{"title":"Arbitrage profit reconstruction","prompt":"Can you fetch the USD price of contract 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC6 on Arbitrum at Unix timestamp 1690000000? I'm reconstructing what a trade was worth at execution time."}],"resultDescription":"Returns a JSON object with ok:true, the type field 'token-price-at', the USD price of the token at the requested timestamp, a transaction receipt including tx_hash and receipt_id, and an ISO8601 generated_at timestamp confirming when the response was produced.","failureModes":["Unsupported chain value returns validation error","Invalid contract address format (non-0x40hex) rejected by schema","Timestamp too far in the past may lack price data, returning no result or an error","Network or RPC issues on the target chain may cause lookup failure","Payment failure via x402 protocol will block the request","Contract address not a known token on the specified chain may return null or error"],"whenToPreferThis":"Choose this endpoint when you need a point-in-time USD price for an EVM-compatible token on one of the ten supported chains (Ethereum, Base, Polygon, Arbitrum, Optimism, BSC, Avalanche, Gnosis, Linea, Scroll). It is ideal for tax calculations, historical portfolio valuation, audit trails, or reconstructing trade economics at a specific past moment. Prefer it over on-chain oracle calls when you need a simple, paid, API-level lookup without writing smart contract code.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:39:36.985Z","isFirstParty":false,"canonicalSlug":"usd-price-of-a-token-at-a-past-moment-12b07bdc"}