{"openapi":"3.1.0","info":{"title":"Token Price History API","version":"1.0.0","description":"Historical price for any crypto token by its on-chain contract address, keyless. Unlike current-price APIs, this is the time dimension: a price chart over any window, the price at any past date or timestamp, the percentage change over a period, and the token first-ever recorded price. Works for any token on any chain by chain:address (and coingecko:id), covering long-tail tokens centralized APIs miss. Live, nothing stored. The token price-history layer for charting, backtesting, accounting, tax and analytics apps — distinct from current-price and coin-slug APIs, this prices a token HISTORY by contract address.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tokenpricehistory-api","description":"oanor gateway"}],"tags":[{"name":"History"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/at":{"get":{"operationId":"get_v1_at","tags":["History"],"summary":"Price at a past date or timestamp","description":"","parameters":[{"name":"coin","in":"query","required":true,"description":"Token as <chain>:<contract_address> or coingecko:<id>","schema":{"type":"string"},"example":"ethereum:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"name":"timestamp","in":"query","required":true,"description":"Unix timestamp (seconds); or use date=YYYY-MM-DD","schema":{"type":"string"},"example":"1704067200"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"coin":"ethereum:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","note":"Closest recorded USD price at or before the requested time.","price":2275.21,"source":"DeFiLlama","symbol":"WETH","confidence":0.99,"price_timestamp":1704067207,"requested_timestamp":1704067200},"meta":{"timestamp":"2026-06-14T08:04:19.641Z","request_id":"06eba318-61cb-4ba9-bb60-600e5dbe7bd8"},"status":"ok","message":"Historical price retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/change":{"get":{"operationId":"get_v1_change","tags":["History"],"summary":"Percentage price change over a period","description":"","parameters":[{"name":"coin","in":"query","required":true,"description":"Token as <chain>:<contract_address> or coingecko:<id>","schema":{"type":"string"},"example":"ethereum:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"name":"period","in":"query","required":false,"description":"Period: 1h, 24h, 7d, 30d (default 24h)","schema":{"type":"string"},"example":"7d"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"coin":"ethereum:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","note":"Percentage price change over the period.","period":"7d","source":"DeFiLlama","change_pct":3.6088},"meta":{"timestamp":"2026-06-14T08:04:19.832Z","request_id":"27b83514-fd58-4915-9b69-a59b65bc4bb2"},"status":"ok","message":"Price change retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/chart":{"get":{"operationId":"get_v1_chart","tags":["History"],"summary":"Price series over time for a token","description":"","parameters":[{"name":"coin","in":"query","required":true,"description":"Token as <chain>:<contract_address> or coingecko:<id>","schema":{"type":"string"},"example":"ethereum:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"name":"period","in":"query","required":false,"description":"Point spacing: 1h, 1d, 1w (default 1d)","schema":{"type":"string"},"example":"1d"},{"name":"span","in":"query","required":false,"description":"Number of points (1-365, default 30)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"coin":"ethereum:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","note":"Price series over time. timestamp is unix seconds; price is in USD.","span":30,"count":30,"period":"1d","prices":[{"price":2194.96610829,"timestamp":1778918765},{"price":2185.31030794,"timestamp":1779005086},{"price":2121.06881797,"timestamp":1779091583},{"price":2138.34353201,"timestamp":1779177908},{"price":2127.65685691,"timestamp":1779264384},{"price":2136.73062416,"timestamp":1779350809},{"price":2127.4388102,"timestamp":1779437203},{"price":2026.36957954,"timestamp":1779523322},{"price":2119.20003555,"timestamp":1779610004},{"price":2112.58707332,"timestamp":1779696425},{"price":2093.40193321,"timestamp":1779782722},{"price":2082.65397827,"timestamp":1779869182},{"price":1991.54985621,"timestamp":1779955307},{"price":2006.15456684,"timestamp":1780042023},{"price":2013.12740891,"timestamp":1780128484},{"price":2023.79204847,"timestamp":1780214803},{"price":1975.41951119,"timestamp":1780301123},{"price":1980.09532884,"timestamp":1780387506},{"price":1875.13101398,"timestamp":1780473600},{"price":1779.37727048,"timestamp":1780560344},{"price":1672.04110227,"timestamp":1780646866},{"price":1574.9289146,"timestamp":1780732783},{"price":1614.88054414,"timestamp":1780819445},{"price":1671.89479969,"timestamp":1780905584},{"price":1679.21135017,"timestamp":1780992004},{"price":1639.29802878,"timestamp":1781078382},{"price":1652.55306794,"timestamp":1781164785},{"price":1658.52061554,"timestamp":1781251204},{"price":1675.91171935,"timestamp":1781337604},{"price":1675.30992018,"timestamp":1781423945}],"source":"DeFiLlama","symbol":"WETH","decimals":18},"meta":{"timestamp":"2026-06-14T08:04:20.553Z","request_id":"cb5348c9-c8fd-4387-9273-fbe910e5acea"},"status":"ok","message":"Token price chart retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/first":{"get":{"operationId":"get_v1_first","tags":["History"],"summary":"The token first-ever recorded price","description":"","parameters":[{"name":"coin","in":"query","required":true,"description":"Token as <chain>:<contract_address> or coingecko:<id>","schema":{"type":"string"},"example":"ethereum:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"coin":"ethereum:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","note":"The token's first-ever recorded USD price (when DeFiLlama began tracking it).","source":"DeFiLlama","symbol":"WETH","first_price":839.535,"first_timestamp":1518566400},"meta":{"timestamp":"2026-06-14T08:04:21.556Z","request_id":"83a3adcc-e257-4d24-afd8-1e587ece88a0"},"status":"ok","message":"First price retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata & live sample","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"All endpoints take a required coin as <chain>:<contract_address> (e.g. ethereum:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 = WETH) or coingecko:<id> (e.g. coingecko:bitcoin). chart takes period (1h/1d/1w) and span (1-365). at takes timestamp (unix) or date (YYYY-MM-DD). change takes period (e.g. 24h, 7d). Prices are USD.","sample":{"coin":"ethereum:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","symbol":"WETH","first_price":839.535},"source":"DeFiLlama open coins API (coins.llama.fi), live","service":"tokenpricehistory-api","endpoints":{"GET /v1/at":"Price at a past date/timestamp (coin, timestamp or date).","GET /v1/meta":"This document.","GET /v1/chart":"Price series over time for a token (coin, period, span).","GET /v1/first":"The token's first-ever recorded price (coin).","GET /v1/change":"Percentage price change over a period (coin, period)."},"description":"Historical price for any crypto token by its on-chain contract address, keyless. The time dimension: a price chart over any window, the price at any past date/timestamp, the percentage change over a period, and the token's first-ever recorded price. Works for any token on any chain by chain:address (and coingecko:<id>), covering long-tail tokens centralized APIs miss. Live, nothing stored beyond a short protective cache. The token price-history layer for charting, backtesting, accounting, tax and analytics apps. Distinct from current-price and coin-slug APIs — this prices a token's HISTORY by contract address.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:21.630Z","request_id":"90cfa8ff-309f-40e7-aad5-71772f4e35a5"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2400,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1550,"monthly_call_quota":62000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":5050,"monthly_call_quota":400000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":15400,"monthly_call_quota":2600000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tokenpricehistory-api"}