{"openapi":"3.1.0","info":{"title":"Crypto All-Time-High API","version":"1.0.0","description":"Live crypto all-time-high tracker as an API — the distance-from-ATH (and distance-from-all-time-low) every crypto dashboard shows, powered by CoinGecko. For any coin it returns the current price, its all-time high with the date and how far below it the price sits now (the headline \"X% below ATH\"), the days since that high, and the mirror metrics versus the all-time low. It also ranks the top 100 coins by how close they are to — or how far they have fallen from — their ATH, so you can see at a glance which assets are at fresh highs and which are deepest in drawdown. Get a coin's ATH stats, the leaders/laggards board, or search to resolve a coin name to its id. The cycle-and-drawdown layer for crypto, trading and dashboard apps. Live, no key. Distinct from live-price, market-cap and OHLC APIs — this is the all-time-high / drawdown analytic.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cryptoath-api","description":"oanor gateway"}],"tags":[{"name":"ATH"},{"name":"Leaders"},{"name":"Search"},{"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/ath":{"get":{"operationId":"get_v1_ath","tags":["ATH"],"summary":"A coin ATH/ATL stats and distance","description":"","parameters":[{"name":"coin","in":"query","required":true,"description":"Coin id or symbol","schema":{"type":"string"},"example":"bitcoin"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"bitcoin","ath":126080,"atl":67.81,"name":"Bitcoin","rank":1,"price":61074,"at_ath":false,"symbol":"BTC","ath_date":"2025-10-06T18:57:42.558Z","atl_date":"2013-07-06T00:00:00.000Z","market_cap":1223963328525,"below_ath_pct":-51.56,"change_24h_pct":-3.51,"days_since_ath":246,"up_from_atl_pct":89967.04},"meta":{"timestamp":"2026-06-10T05:21:16.072Z","request_id":"5b5f6fd1-26f4-4592-b1df-de0364636826"},"status":"ok","message":"ATH stats 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/leaders":{"get":{"operationId":"get_v1_leaders","tags":["Leaders"],"summary":"Top-100 ranked by distance from ATH","description":"","parameters":[{"name":"order","in":"query","required":false,"description":"near (closest to ATH) | far (deepest drawdown)","schema":{"type":"string"},"example":"far"},{"name":"limit","in":"query","required":false,"description":"Max coins (1-100)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"coins":[{"id":"internet-computer","ath":700.65,"atl":2.02,"name":"Internet Computer","rank":61,"price":2.25,"at_ath":false,"symbol":"ICP","ath_date":"2021-05-10T16:05:53.653Z","atl_date":"2026-02-24T05:35:51.591Z","market_cap":1246074160,"below_ath_pct":-99.68,"change_24h_pct":-3.44,"days_since_ath":1857,"up_from_atl_pct":11.85},{"id":"filecoin","ath":236.84,"atl":0.677565,"name":"Filecoin","rank":91,"price":0.74996,"at_ath":false,"symbol":"FIL","ath_date":"2021-04-01T13:29:41.564Z","atl_date":"2026-06-06T05:05:41.903Z","market_cap":591456379,"below_ath_pct":-99.68,"change_24h_pct":-3.11,"days_since_ath":1896,"up_from_atl_pct":10.95},{"id":"polkadot","ath":54.98,"atl":0.892875,"name":"Polkadot","rank":50,"price":0.940748,"at_ath":false,"symbol":"DOT","ath_date":"2021-11-04T14:10:09.301Z","atl_date":"2026-06-06T05:05:21.076Z","market_cap":1588624348,"below_ath_pct":-98.29,"change_24h_pct":-3.16,"days_since_ath":1679,"up_from_atl_pct":5.56},{"id":"algorand","ath":3.56,"atl":0.080092,"name":"Algorand","rank":79,"price":0.090463,"at_ath":false,"symbol":"ALGO","ath_date":"2019-06-20T14:51:19.480Z","atl_date":"2026-03-29T22:50:15.756Z","market_cap":807510826,"below_ath_pct":-97.45,"change_24h_pct":-2.75,"days_since_ath":2547,"up_from_atl_pct":13.22},{"id":"aptos","ath":19.92,"atl":0.619477,"name":"Aptos","rank":97,"price":0.653569,"at_ath":false,"symbol":"APT","ath_date":"2023-01-26T14:25:17.390Z","atl_date":"2026-06-06T05:05:42.875Z","market_cap":536115602,"below_ath_pct":-96.71,"change_24h_pct":-1.11,"days_since_ath":1231,"up_from_atl_pct":5.76},{"id":"cosmos","ath":43.84,"atl":1.16,"name":"Cosmos Hub","rank":72,"price":1.76,"at_ath":false,"symbol":"ATOM","ath_date":"2021-09-20T00:00:00.000Z","atl_date":"2020-03-13T02:27:44.591Z","market_cap":906863295,"below_ath_pct":-95.96,"change_24h_pct":0.69,"days_since_ath":1724,"up_from_atl_pct":52.58},{"id":"ethereum-classic","ath":167.09,"atl":0.615038,"name":"Ethereum Classic","rank":64,"price":6.93,"at_ath":false,"symbol":"ETC","ath_date":"2021-05-06T18:34:22.133Z","atl_date":"2016-07-25T00:00:00.000Z","market_cap":1085360568,"below_ath_pct":-95.85,"change_24h_pct":-1.77,"days_since_ath":1860,"up_from_atl_pct":1026.79},{"id":"pi-network","ath":2.99,"atl":0.118869,"name":"Pi Network","rank":56,"price":0.125214,"at_ath":false,"symbol":"PI","ath_date":"2025-02-26T16:41:03.732Z","atl_date":"2026-06-06T05:05:45.511Z","market_cap":1343359690,"below_ath_pct":-95.79,"change_24h_pct":-3.41,"days_since_ath":469,"up_from_atl_pct":5.83},{"id":"worldcoin-wld","ath":11.74,"atl":0.230306,"name":"Worldcoin","rank":46,"price":0.506275,"at_ath":false,"symbol":"WLD","ath_date":"2024-03-10T00:10:42.330Z","atl_date":"2026-05-18T15:06:03.669Z","market_cap":1716770058,"below_ath_pct":-95.71,"change_24h_pct":1.17,"days_since_ath":822,"up_from_atl_pct":118.56},{"id":"avalanche-2","ath":144.96,"atl":2.8,"name":"Avalanche","rank":33,"price":6.52,"at_ath":false,"symbol":"AVAX","ath_date":"2021-11-21T14:18:56.538Z","atl_date":"2020-12-31T13:15:21.540Z","market_cap":2818701230,"below_ath_pct":-95.49,"change_24h_pct":-3.3,"days_since_ath":1662,"up_from_atl_pct":133.38},{"id":"flare-networks","ath":0.150073,"atl":0.0064918,"name":"Flare","rank":90,"price":0.006908,"at_ath":false,"symbol":"FLR","ath_date":"2023-01-10T03:14:05.921Z","atl_date":"2026-06-06T05:05:42.877Z","market_cap":590562004,"below_ath_pct":-95.36,"change_24h_pct":-3.45,"days_since_ath":1247,"up_from_atl_pct":7.17},{"id":"cardano","ath":3.09,"atl":0.01925275,"name":"Cardano","rank":18,"price":0.160744,"at_ath":false,"symbol":"ADA","ath_date":"2021-09-02T06:00:10.474Z","atl_date":"2020-03-13T02:22:55.044Z","market_cap":5980776144,"below_ath_pct":-94.79,"change_24h_pct":-4.82,"days_since_ath":1742,"up_from_atl_pct":734.92},{"id":"ethena","ath":1.52,"atl":0.076868,"name":"Ethena","rank":82,"price":0.079674,"at_ath":false,"symbol":"ENA","ath_date":"2024-04-11T13:15:15.057Z","atl_date":"2026-04-05T12:50:40.489Z","market_cap":741755941,"below_ath_pct":-94.74,"change_24h_pct":-2.5,"days_since_ath":790,"up_from_atl_pct":3.82},{"id":"bitcoin-cash","ath":3785.82,"atl":76.93,"name":"Bitcoin Cash","rank":26,"price":199.87,"at_ath":false,"symbol":"BCH","ath_date":"2017-12-20T00:00:00.000Z","atl_date":"2018-12-16T00:00:00.000Z","market_cap":4004811524,"below_ath_pct":-94.72,"change_24h_pct":-3.92,"days_since_ath":3094,"up_from_atl_pct":159.8},{"id":"shiba-inu","ath":8.616e-5,"atl":5.6366e-11,"name":"Shiba Inu","rank":34,"price":4.63e-6,"at_ath":false,"symbol":"SHIB","ath_date":"2021-10-28T03:54:55.568Z","atl_date":"2020-11-28T11:26:25.838Z","market_cap":2729539852,"below_ath_pct":-94.63,"change_24h_pct":-2.07,"days_since_ath":1686,"up_from_atl_pct":8209255.89},{"id":"uniswap","ath":44.92,"atl":1.03,"name":"Uniswap","rank":52,"price":2.44,"at_ath":false,"symbol":"UNI","ath_date":"2021-05-03T05:25:04.822Z","atl_date":"2020-09-17T01:20:38.214Z","market_cap":1522675553,"below_ath_pct":-94.55,"change_24h_pct":-2.51,"days_since_ath":1864,"up_from_atl_pct":137.57},{"id":"a7a5","ath":0.229635,"atl":1.048e-5,"name":"A7A5","rank":99,"price":0.01307836,"at_ath":false,"symbol":"A7A5","ath_date":"2025-08-14T23:03:39.275Z","atl_date":"2025-08-21T17:38:27.654Z","market_cap":516136025,"below_ath_pct":-94.27,"change_24h_pct":-0.1,"days_since_ath":299,"up_from_atl_pct":125518.37},{"id":"polygon-ecosystem-token","ath":1.29,"atl":0.071288,"name":"POL (ex-MATIC)","rank":80,"price":0.075022,"at_ath":false,"symbol":"POL","ath_date":"2024-03-13T18:55:06.692Z","atl_date":"2026-06-05T19:10:45.870Z","market_cap":799558679,"below_ath_pct":-94.17,"change_24h_pct":-2.67,"days_since_ath":818,"up_from_atl_pct":5.38},{"id":"crypto-com-chain","ath":0.891544,"atl":0.0121196,"name":"Cronos","rank":37,"price":0.059266,"at_ath":false,"symbol":"CRO","ath_date":"2021-11-24T00:00:00.000Z","atl_date":"2019-02-08T00:00:00.000Z","market_cap":2659535334,"below_ath_pct":-93.35,"change_24h_pct":-3.43,"days_since_ath":1659,"up_from_atl_pct":389.04},{"id":"aave","ath":661.69,"atl":26.02,"name":"Aave","rank":70,"price":61.06,"at_ath":false,"symbol":"AAVE","ath_date":"2021-05-18T21:19:59.514Z","atl_date":"2020-11-05T09:20:11.928Z","market_cap":927788222,"below_ath_pct":-90.74,"change_24h_pct":-2.56,"days_since_ath":1848,"up_from_atl_pct":135.35}],"count":20,"order":"far"},"meta":{"timestamp":"2026-06-10T05:21:16.312Z","request_id":"12e3b4a9-e539-4d48-bbdd-4717beecb8f3"},"status":"ok","message":"Leaders 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/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Resolve a coin name/symbol to its id","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Coin name or symbol","schema":{"type":"string"},"example":"solana"},{"name":"limit","in":"query","required":false,"description":"Max results (1-25)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"coins":[{"id":"solana","name":"Solana","rank":7,"symbol":"SOL"},{"id":"solana-name-service","name":"Solana Name Service","rank":2171,"symbol":"SNS"},{"id":"green-satoshi-token","name":"STEPN Green Satoshi Token on Solana","rank":2594,"symbol":"GST-SOL"},{"id":"play-solana-token","name":"Play Solana Token","rank":3026,"symbol":"PLAY"},{"id":"pepecoin-on-solana","name":"PepeCoin on Solana","rank":3636,"symbol":"PEPE"},{"id":"harambe-2","name":"Harambe on Solana","rank":3735,"symbol":"HARAMBE"},{"id":"solana-fork-staccana","name":"Solana Fork Staccana","rank":3822,"symbol":"STACCANA"},{"id":"wiener-doge-on-solana","name":"Wiener Doge on Solana","rank":4071,"symbol":"WIENER"},{"id":"solid","name":"Solana ID","rank":4396,"symbol":"SOLID"},{"id":"npc-on-solana","name":"NPC On Solana","rank":4451,"symbol":"NPCS"}],"count":10,"query":"solana"},"meta":{"timestamp":"2026-06-09T03:02:33.419Z","request_id":"cc277504-28ef-45ec-9546-f36eef1d5734"},"status":"ok","message":"Search results 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","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"CoinGecko public markets + search (live)","service":"cryptoath-api","endpoints":{"GET /v1/ath":"A coin's ATH/ATL stats (coin=bitcoin or coin=BTC).","GET /v1/meta":"This document.","GET /v1/search":"Resolve a coin name/symbol to its id (q=solana).","GET /v1/leaders":"Top-100 coins ranked by distance from ATH (order=near|far, limit)."},"description":"Live crypto all-time-high tracker from CoinGecko: for any coin, the current price, its all-time high with date and how far below it the price sits now (the '% below ATH'), days since the high, and the mirror metrics versus the all-time low. Also ranks the top coins by how close they are to — or how far they have fallen from — their ATH. Get a coin's ATH stats, the leaders/laggards board, or search to resolve a name. Live, no key. Distinct from live-price, market-cap and OHLC APIs — this is the all-time-high / drawdown analytic."},"meta":{"timestamp":"2026-06-09T03:02:33.524Z","request_id":"5b8087e6-671f-409f-ad40-4ec6dcc15069"},"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":9000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1300,"monthly_call_quota":125000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3600,"monthly_call_quota":650000,"rps_limit":40,"hard_limit":true},{"slug":"desk","name":"Desk","price_cents_month":8500,"monthly_call_quota":3000000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cryptoath-api"}