{"uid":"cap_d9VsAwOFV9H1VGTAa75O4","slug":"defillama-first-recorded-token-price-d52b7016","name":"DefiLlama First Recorded Token Price","description":"First recorded token price by DefiLlama — the earliest known price and timestamp for one or many coins.","url":"https://defillama.use.x402atlas.com/prices-first","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","required":["coins"],"properties":{"coins":{"type":"string","pattern":"^[A-Za-z0-9:,_.-]+$","maxLength":3000,"minLength":1,"description":"Comma-separated coins as {chain}:{address} or coingecko:{id}"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","data"],"properties":{"data":{"type":"object","properties":{"coins":{"type":"object","description":"Map keyed by the requested coin id (e.g. coingecko:ethereum)","additionalProperties":{"type":"object","properties":{"price":{"type":"number","description":"Earliest recorded USD price"},"symbol":{"type":"string"},"timestamp":{"type":"integer","description":"Unix timestamp of the earliest recorded price"}}}}}},"queried_at":{"type":"string","format":"date-time","description":"Time the upstream was queried"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"coins":{"coingecko:ethereum":{"price":0.4,"symbol":"ETH","timestamp":1438905600}}},"queried_at":"2026-07-01T12:00:00Z"}},"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_7ydMZo8x2jwt4P11EU54O","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 earliest known USD price and timestamp for one or many tokens, as tracked by DefiLlama.","exampleAgentPrompt":"What was the very first price ever recorded for AAVE and Uniswap on DefiLlama? I need the earliest known USD price and the timestamp for each — use ethereum:0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9 for AAVE and ethereum:0x1f9840a85d5af5bf1d1762f925bdaddc4201f984 for UNI.","exampleUseCases":[{"title":"All-time return since token launch","prompt":"I want to calculate the all-time return for Chainlink since it first launched. Can you pull the very first recorded USD price for LINK on DefiLlama using ethereum:0x514910771af9ca656af840dff83e8264ecf986ca, and then I'll compare it against today's price to figure out the gain?"},{"title":"Audit early DeFi token history","prompt":"I'm auditing the price history of some early DeFi tokens. Can you find the earliest known price and timestamp that DefiLlama has on record for Compound and MakerDAO? Use ethereum:0xc00e94cb662c3520282e6f5717214004a7f26888 for COMP and ethereum:0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2 for MKR."},{"title":"When did a stablecoin first appear","prompt":"I'm trying to figure out when USDC first showed up in DeFi price feeds and what price it was initially recorded at. Can you look up the genesis price entry for USDC on DefiLlama using ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48?"}],"resultDescription":"Returns a map of coin identifiers to their first-ever recorded price (in USD), the timestamp of that first record, token symbol, and decimals — representing the earliest data point DefiLlama has for each requested token.","failureModes":["Coin identifier not found or not tracked by DefiLlama — returns empty or missing entry for that coin","Malformed coin identifier (e.g. missing chain prefix or bad address) — likely returns an error or omits the coin","No historical price data available for a very new or obscure token — missing entry in response","Rate limiting or payment failure — HTTP 402 or 429 response","Network timeout for bulk coin queries with many identifiers"],"whenToPreferThis":"Use this endpoint when you need the genesis or origin price of a token — i.e., the very first price ever recorded by DefiLlama — rather than current or recent historical prices. Ideal for computing all-time returns from launch, auditing token history, or establishing when a token first appeared in DeFi price feeds. Prefer over current-price endpoints when the question is about historical origin, not present value.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:32:02.214Z","isFirstParty":false}