# Athens Stock Exchange (ATHEX) API > 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). ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/athex-api/..." ``` ## Pricing - **Free** (Free) — 14,800 calls/Mo, 2 req/s - **Basic** ($33/Mo) — 318,000 calls/Mo, 10 req/s - **Pro** ($76/Mo) — 1,680,000 calls/Mo, 20 req/s - **Scale** ($142/Mo) — 8,550,000 calls/Mo, 50 req/s ## Endpoints ### Quotes #### `GET /v1/quote` — Live quote for one or more ATHEX stocks **Parameters:** - `codes` (query, required, string) — ATHEX ticker(s), comma-separated up to 20 Example: `ETE,EEE` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/athex-api/v1/quote?codes=ETE%2CEEE" ``` **Response:** ```json { "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_i …(truncated, see openapi.json for full schema) ``` ### Screener #### `GET /v1/screener` — Ranked market screener (primary Greek listings) **Parameters:** - `by` (query, optional, string) — Ranking: gainers, losers, active, marketcap Example: `marketcap` - `limit` (query, optional, string) — Results 1-100 Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/athex-api/v1/screener?by=marketcap&limit=20" ``` **Response:** ```json { "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, …(truncated, see openapi.json for full schema) ``` ### Indices #### `GET /v1/index` — Live value of an Athens index **Parameters:** - `name` (query, optional, string) — GD or FTSE Example: `GD` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/athex-api/v1/index?name=GD" ``` **Response:** ```json { "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 } ``` ### Meta #### `GET /v1/meta` — Service metadata & endpoint catalog **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/athex-api/v1/meta" ``` **Response:** ```json { "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 …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/athex-api OpenAPI spec: https://www.oanor.com/api/athex-api/openapi.json