{"openapi":"3.1.0","info":{"title":"Token Price API","version":"1.0.0","description":"Live crypto token prices by contract address — no key, nothing cached. Unlike price APIs keyed on a coin slug, this prices a token by its on-chain contract address on its chain, exactly what you have when a token comes out of a wallet, a DEX pair or a transaction. The price endpoint returns the current USD price, symbol, decimals, a confidence score and the timestamp for one or many tokens at once, addressed as chain:address (ethereum:0xA0b8…, a Solana mint, etc.) or as coingecko:slug — USD Coin resolves to about $1.00 and Wrapped Ether to its live price, in one batched call. The historical endpoint returns a token's price at any past moment by Unix timestamp. The chart endpoint returns a price series over a span and period, so you can plot or back-test. It spans every chain DefiLlama indexes — Ethereum, Solana, BSC, Base, Arbitrum and dozens more — including long-tail tokens a slug-based API will not have. This is the address-based price layer every wallet, portfolio tracker, DEX tool and crypto-accounting app needs to value arbitrary tokens. Live from DefiLlama, nothing stored. Distinct from coin-slug price and market-cap APIs — this prices tokens by contract address, across chains. 4 endpoints.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tokenprice-api","description":"oanor gateway"}],"tags":[{"name":"Price"},{"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/chart":{"get":{"operationId":"get_v1_chart","tags":["Price"],"summary":"Token price series","description":"","parameters":[{"name":"token","in":"query","required":true,"description":"chain:address or coingecko:slug","schema":{"type":"string"},"example":"ethereum:0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"},{"name":"period","in":"query","required":false,"description":"Candle period (1h,4h,1d,1w)","schema":{"type":"string"},"example":"1d"},{"name":"span","in":"query","required":false,"description":"How many points (2-100)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"span":30,"count":30,"token":"ethereum:0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","period":"1d","prices":[{"price":2333.905872656188,"timestamp":1778499464},{"price":2285.0563851087372,"timestamp":1778586103},{"price":2305.185556590428,"timestamp":1778672355},{"price":2255.047782412044,"timestamp":1778759023},{"price":2259.136908954603,"timestamp":1778845234},{"price":2178.8265977405254,"timestamp":1778931711},{"price":2191.701634608531,"timestamp":1779018102},{"price":2117.4813666278537,"timestamp":1779104315},{"price":2111.86874931612,"timestamp":1779190904},{"price":2127.265396198652,"timestamp":1779277006},{"price":2113.450218281493,"timestamp":1779363643},{"price":2122.7150244549516,"timestamp":1779449802},{"price":2029.2169056949785,"timestamp":1779536702},{"price":2124.2325584091404,"timestamp":1779622663},{"price":2116.3382666961875,"timestamp":1779708987},{"price":2118.0864109970776,"timestamp":1779795722},{"price":2079.8829008695807,"timestamp":1779882190},{"price":1986.544798856715,"timestamp":1779968509},{"price":2007.0966926565911,"timestamp":1780054662},{"price":2014.9926536548203,"timestamp":1780141064},{"price":2019.990040784292,"timestamp":1780227686},{"price":1981.530355897542,"timestamp":1780314026},{"price":1977.2082207220474,"timestamp":1780400505},{"price":1881.3002484972428,"timestamp":1780486644},{"price":1740.3106548451067,"timestamp":1780573346},{"price":1670.2749189518568,"timestamp":1780659904},{"price":1561.571604106965,"timestamp":1780746304},{"price":1629.2610110217106,"timestamp":1780833543},{"price":1691.818962563001,"timestamp":1780919082},{"price":1667.352118176379,"timestamp":1781004589}],"symbol":"WETH","decimals":18},"meta":{"timestamp":"2026-06-09T11:39:45.765Z","request_id":"05a2b1de-611c-4b76-a9bf-679a3f8af566"},"status":"ok","message":"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/historical":{"get":{"operationId":"get_v1_historical","tags":["Price"],"summary":"Price at a past timestamp","description":"","parameters":[{"name":"token","in":"query","required":true,"description":"chain:address or coingecko:slug","schema":{"type":"string"},"example":"ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"},{"name":"timestamp","in":"query","required":true,"description":"Unix timestamp (seconds)","schema":{"type":"string"},"example":"1700000000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"price":1,"token":"ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","symbol":"USDC","decimals":6,"timestamp":1700000107,"confidence":0.99,"requested_timestamp":1700000000},"meta":{"timestamp":"2026-06-09T11:39:45.989Z","request_id":"c2df436c-34c1-4f39-846b-b77a20178a79"},"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/price":{"get":{"operationId":"get_v1_price","tags":["Price"],"summary":"Current token price(s)","description":"","parameters":[{"name":"token","in":"query","required":true,"description":"chain:address, Solana mint, or coingecko:slug (comma for many)","schema":{"type":"string"},"example":"ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"prices":[{"price":0.9996178037354563,"token":"ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","symbol":"USDC","decimals":6,"timestamp":1781005077,"confidence":0.99}]},"meta":{"timestamp":"2026-06-09T11:39:46.151Z","request_id":"b662a4c8-d78e-4fe7-9aee-849681f90cb6"},"status":"ok","message":"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":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"DefiLlama coins API (live)","service":"tokenprice-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/chart":"A token's price series (token=, period=1d, span=30).","GET /v1/price":"Current price(s) for one or many tokens (token=ethereum:0x…,coingecko:bitcoin — up to 12).","GET /v1/historical":"A token's price at a past Unix timestamp (token=, timestamp=1700000000)."},"description":"Live crypto token prices by contract address from DefiLlama: the current USD price, symbol, decimals, confidence and timestamp for one or many tokens addressed as chain:address (ethereum:0x…, a Solana mint) or coingecko:slug; a token's historical price at any Unix timestamp; and a price chart over a span and period. Across every chain DefiLlama indexes. Live, no key, nothing stored. Distinct from coin-slug price and market-cap APIs — this prices tokens by contract address, including long-tail tokens, across chains.","token_formats":["ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","solana:<mint>","coingecko:bitcoin","0x… (defaults to ethereum)"],"upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T11:39:46.295Z","request_id":"78216de9-c225-43e3-ae3b-f4a44da8b757"},"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":11500,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":950,"monthly_call_quota":135000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2500,"monthly_call_quota":650000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5950,"monthly_call_quota":3250000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tokenprice-api"}