{"openapi":"3.1.0","info":{"title":"Athens Stock Exchange (ATHEX) API","version":"1.0.0","description":"Live data for the Athens Stock Exchange (ATHEX, the Greek market) with no key: the live quote for one or more stocks by ticker (price, change, open/high/low, volume, market cap, P/E, sector, in euro, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap; primary Greek listings only), and the live value of the Athens indices (ATHEX Composite GD and FTSE/ATHEX Large Cap).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/athex-api","description":"oanor gateway"}],"tags":[{"name":"Quotes"},{"name":"Screener"},{"name":"Indices"},{"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/quote":{"get":{"operationId":"get_v1_quote","tags":["Quotes"],"summary":"Live quote for one or more ATHEX stocks","description":"","parameters":[{"name":"codes","in":"query","required":true,"description":"ATHEX ticker(s), comma-separated up to 20","schema":{"type":"string"},"example":"ETE,EEE"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The live quote for one or more Greek (ATHEX) stocks — price, change, open/high/low, volume, market cap, P/E and sector (in euro), with the company name. Pass codes (the ATHEX ticker, comma-separate up to 20, e.g. ETE,EUROB).","count":2,"quotes":[{"low":14.72,"high":15.125,"open":14.88,"price":14.92,"change":0.3200000000000003,"sector":"Finance","ticker":"ETE","volume":2338773,"company":"National Bank of Greece S.A.","currency":"EUR","pe_ratio":11.94,"market_cap":13645174220,"change_percent":2.19},{"low":52.1,"high":53.1,"open":52.4,"price":52.2,"change":-0.6999999999999957,"sector":"Consumer Non-Durables","ticker":"EEE","volume":15771,"company":"Coca-Cola HBC AG","currency":"EUR","pe_ratio":20.52,"market_cap":19366751410.426144,"change_percent":-1.32}],"source":"Athens Stock Exchange / ATHEX (TradingView)"},"meta":{"timestamp":"2026-06-15T02:10:26.941Z","request_id":"8a78e6a5-0394-4f3e-b7f1-c44f47df2761"},"status":"ok","message":"Quote 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/screener":{"get":{"operationId":"get_v1_screener","tags":["Screener"],"summary":"Ranked market screener (primary Greek listings)","description":"","parameters":[{"name":"by","in":"query","required":false,"description":"Ranking: gainers, losers, active, marketcap","schema":{"type":"string"},"example":"marketcap"},{"name":"limit","in":"query","required":false,"description":"Results 1-100","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"by":"marketcap","note":"A ranked screener of the Greek (ATHEX) market — the top stocks by your chosen ranking, limited to primary Greek listings. Pass by (gainers, losers, active, or marketcap; default marketcap) and limit (1-100, default 20).","count":20,"source":"Athens Stock Exchange / ATHEX (TradingView)","results":[{"price":4.063,"change":0.12399999999999967,"sector":"Finance","ticker":"EUROB","volume":10166097,"company":"EUROBANK S.A.","currency":"EUR","market_cap":14753526458,"change_percent":3.15},{"price":14.92,"change":0.3200000000000003,"sector":"Finance","ticker":"ETE","volume":2338773,"company":"National Bank of Greece S.A.","currency":"EUR","market_cap":13645174220,"change_percent":2.19},{"price":22.66,"change":0.23999999999999844,"sector":"Utilities","ticker":"PPC","volume":1513504,"company":"Public Power Corporation S.A.","currency":"EUR","market_cap":13537008394,"change_percent":1.07},{"price":9.05,"change":0.27000000000000135,"sector":"Finance","ticker":"TPEIR","volume":4433165,"company":"Piraeus Bank S.A.","currency":"EUR","market_cap":11181648637,"change_percent":3.08},{"price":13.93,"change":0.08000000000000007,"sector":"Consumer Services","ticker":"ALWN","volume":522248,"company":"Allwyn AG","currency":"EUR","market_cap":10771984044,"change_percent":0.58},{"price":3.945,"change":0.11999999999999966,"sector":"Finance","ticker":"ALPHA","volume":7754671,"company":"Alpha Bank S.A.","currency":"EUR","market_cap":8963230549,"change_percent":3.14},{"price":19.26,"change":0.08000000000000185,"sector":"Communications","ticker":"HTO","volume":449264,"company":"Hellenic Telecommunications Organization SA","currency":"EUR","market_cap":7634511153,"change_percent":0.42},{"price":19.14,"change":0,"sector":"Non-Energy Minerals","ticker":"VIO","volume":161560,"company":"Viohalco SA/NV","currency":"EUR","market_cap":4945340569,"change_percent":0},{"price":39.88,"change":-0.779999999999994,"sector":"Energy Minerals","ticker":"MOH","volume":153661,"company":"MOTOR OIL (HELLAS) CORINTH REFINERIES S.A.","currency":"EUR","market_cap":4402995283,"change_percent":-1.92},{"price":44.68,"change":0.5799999999999983,"sector":"Industrial Services","ticker":"GEKTERNA","volume":215296,"company":"Gek Terna S.A.","currency":"EUR","market_cap":4319180096,"change_percent":1.32},{"price":10.48,"change":0.3000000000000007,"sector":"Transportation","ticker":"AIA","volume":144218,"company":"Athens International Airport S.A","currency":"EUR","market_cap":3334712955,"change_percent":2.95},{"price":10.12,"change":-0.08000000000000007,"sector":"Energy Minerals","ticker":"ELPE","volume":249973,"company":"HELLENiQ ENERGY Holdings S.A.","currency":"EUR","market_cap":3093028117,"change_percent":-0.78},{"price":22.62,"change":0.08000000000000185,"sector":"Retail Trade","ticker":"BELA","volume":572273,"company":"Jumbo S.A.","currency":"EUR","market_cap":3039349308,"change_percent":0.35},{"price":1.226,"change":0.010000000000000009,"sector":"Finance","ticker":"CREDIA","volume":3439130,"company":"CrediaBank S.A.","currency":"EUR","market_cap":2445930664,"change_percent":0.82},{"price":10.5,"change":0.2599999999999998,"sector":"Finance","ticker":"OPTIMA","volume":540404,"company":"Optima Bank SA","currency":"EUR","market_cap":2322658127,"change_percent":2.54},{"price":1.164,"change":-0.018000000000000016,"sector":"Technology Services","ticker":"BYLOT","volume":6121945,"company":"Ballys Intralot S.A.","currency":"EUR","market_cap":2174122447,"change_percent":-1.52},{"price":9.85,"change":0.15000000000000036,"sector":"Communications","ticker":"AKTR","volume":366367,"company":"Aktor Societe Anonyme Holding Company Technical and Energy Projects","currency":"EUR","market_cap":2009048829,"change_percent":1.55},{"price":4.575,"change":-0.14499999999999957,"sector":"Producer Manufacturing","ticker":"ELHA","volume":557353,"company":"ELVALHALCOR Hellenic Copper and Aluminium Industry S.A.","currency":"EUR","market_cap":1716730284,"change_percent":-3.07},{"price":5.2,"change":0.04999999999999982,"sector":"Finance","ticker":"PRODEA","volume":529905,"company":"Prodea Real Estate Investment Co. SA","currency":"EUR","market_cap":1328571546,"change_percent":0.97},{"price":428,"change":6,"sector":"Consumer Non-Durables","ticker":"KARE","volume":313,"company":"Karelia Tobacco Company Inc.","currency":"EUR","market_cap":1181279996,"change_percent":1.42}],"description":"largest (by market cap)"},"meta":{"timestamp":"2026-06-15T02:10:27.144Z","request_id":"1844aff8-75b4-4ac1-8b60-558b2822917e"},"status":"ok","message":"Screener 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/index":{"get":{"operationId":"get_v1_index","tags":["Indices"],"summary":"Live value of an Athens index","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"GD or FTSE","schema":{"type":"string"},"example":"GD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"low":2415.74,"high":2444.61,"name":"ATHEX Composite Index","note":"The live value of an Athens Stock Exchange index — current level, change, and the day's open/high/low. Pass name (GD for the ATHEX Composite, or FTSE for the FTSE/ATHEX Large Cap; default GD).","open":2421.65,"index":"GD","value":2421.69,"change":25.320000000000164,"source":"Athens Stock Exchange / ATHEX (TradingView)","change_percent":1.06},"meta":{"timestamp":"2026-06-15T02:10:27.513Z","request_id":"b99f9c9b-8747-4ff1-b4bc-8e960583d9da"},"status":"ok","message":"Index 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 & endpoint catalog","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"athex_composite":2421.69},"source":"TradingView public screener (scanner.tradingview.com/greece/scan), keyless","indexes":["GD","FTSE"],"screens":["gainers","losers","active","marketcap"],"service":"athex-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/index":"Live value of an Athens index (name).","GET /v1/quote":"Live quote for one or more stocks (codes).","GET /v1/screener":"Ranked market screener (by, limit)."},"description":"Live data for the Athens Stock Exchange (ATHEX, the Greek market) with no key: the live quote for one or more stocks by ticker (price, change, open/high/low, volume, market cap, P/E, sector, in euro, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap; primary Greek listings only), and the live value of the Athens indices (ATHEX Composite GD and FTSE/ATHEX Large Cap). The Greece-equities / ATHEX-index / screener layer for trading dashboards and research. Distinct from other exchange readers — the Athens Stock Exchange market with a built-in screener. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-15T02:10:27.593Z","request_id":"c84d071c-92a4-4c44-97d0-671522c6bbd9"},"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":14800,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":3310,"monthly_call_quota":318000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":7630,"monthly_call_quota":1680000,"rps_limit":20,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":14190,"monthly_call_quota":8550000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/athex-api"}