# Borsa Istanbul (BIST) API > Live and historical price data for Turkish equities on Borsa Istanbul (BIST), with no key. Read the latest daily quote for any BIST stock (close, weighted average, high/low, volume and market cap, in both Turkish lira and US dollars); pull the daily price history over any window; get a dollar-denominated price history — essential for seeing real returns in a high-inflation market; and read computed period returns (1 week, 1 month, 3 months) in both TRY and USD. The Turkey-equities / price-history / dual-currency layer for trading dashboards, screeners and research — distinct from other exchange readers, this is BIST time-series data with a TRY/USD view. Live; short cache only. ## 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/borsaistanbul-api/..." ``` ## Pricing - **Free** (Free) — 16,000 calls/Mo, 3 req/s - **Starter** ($22/Mo) — 320,000 calls/Mo, 8 req/s - **Pro** ($58/Mo) — 1,750,000 calls/Mo, 20 req/s - **Enterprise** ($136/Mo) — 9,000,000 calls/Mo, 60 req/s ## Endpoints ### Quotes #### `GET /v1/quote` — Latest daily quote (TRY & USD) **Parameters:** - `hisse` (query, required, string) — BIST ticker, e.g. THYAO (Turkish Airlines), GARAN, ASELS Example: `THYAO` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/borsaistanbul-api/v1/quote?hisse=THYAO" ``` **Response:** ```json { "data": { "low": 301, "date": "2026-06-12", "high": 311, "note": "The latest daily quote for one Borsa Istanbul stock — close, weighted average, high/low, volume and market cap in Turkish lira, plus the close and market cap in US dollars, and the day's change. Pass hisse (the BIST ticker, e.g. THYAO).", "close": 307.75, "change": 14.5, "source": "Borsa Istanbul", "symbol": "THYAO", "average": 306.815, "close_usd": 6.6658, "volume_try": 26865029766, "change_percent": 4.94, "market_cap_try": 424695000000, "market_cap_usd": 9198744606.74741 }, "meta": { "timestamp": "2026-06-15T02:11:09.344Z", "request_id": "57158eeb-062b-46e7-9a3b-00cdf12ef6eb" }, "status": "ok", "message": "Quote retrieved successfully", "success": true } ``` ### History #### `GET /v1/history` — Daily price history in TRY **Parameters:** - `hisse` (query, required, string) — BIST ticker, e.g. THYAO Example: `THYAO` - `days` (query, optional, string) — Look-back window in days (5-365, default 30) Example: `30` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/borsaistanbul-api/v1/history?hisse=THYAO&days=30" ``` **Response:** ```json { "data": { "days": 30, "note": "The daily price history of one Borsa Istanbul stock over the requested window — each day's close, weighted average, high/low, volume and market cap (in TRY). Pass hisse (the BIST ticker, e.g. THYAO) and days (5-365, default 30).", "count": 16, "source": "Borsa Istanbul", "symbol": "THYAO", "history": [ { "low": 294.5, "date": "2026-05-18", "high": 301, "close": 294.5, "average": 297.843, "close_usd": 6.4683, "volume_try": 10827845159, "market_cap_try": 406410000000, "market_cap_usd": 8926280924.93674 }, { "low": 289.75, "date": "2026-05-20", "high": 300.25, "close": 295, "average": 294.993, "close_usd": 6.4706, "volume_try": 10181705807, "market_cap_try": 407100000000, "market_cap_usd": 8929413545.24697 }, { "low": 274, "date": "2026-05-21", "high": 274, "close": 274, "average": 284.485, "close_usd": 6.0075, "volume_try": 16359129293, "market_cap_try": 378120000000, "market_cap_usd": 8290341747.47916 …(truncated, see openapi.json for full schema) ``` #### `GET /v1/usd` — Dollar-denominated price history **Parameters:** - `hisse` (query, required, string) — BIST ticker, e.g. THYAO Example: `THYAO` - `days` (query, optional, string) — Look-back window in days (5-365, default 30) Example: `30` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/borsaistanbul-api/v1/usd?hisse=THYAO&days=30" ``` **Response:** ```json { "data": { "days": 30, "note": "The dollar-denominated daily price history of one Borsa Istanbul stock — each day's USD close, USD high/low and USD market cap. Essential for seeing real returns in a high-inflation market. Pass hisse (e.g. THYAO) and days (5-365, default 30).", "count": 16, "source": "Borsa Istanbul", "symbol": "THYAO", "history": [ { "date": "2026-05-18", "low_usd": 6.4683, "high_usd": 6.6111, "close_usd": 6.4683, "market_cap_usd": 8926280924.93674 }, { "date": "2026-05-20", "low_usd": 6.3554, "high_usd": 6.5857, "close_usd": 6.4706, "market_cap_usd": 8929413545.24697 }, { "date": "2026-05-21", "low_usd": 6.0075, "high_usd": 6.0075, "close_usd": 6.0075, "market_cap_usd": 8290341747.47916 }, { "date": "2026-05-22", "low_usd": 5.9493, "high_usd": 6.3602, "close_usd": 6.3109, "market_cap_usd": 8709047601.30864 }, { "date": "2026-05-25", "low_usd": 6.4751, "high_usd": 6.5736, "close_usd": 6.5079, "market_cap_us …(truncated, see openapi.json for full schema) ``` ### Analytics #### `GET /v1/performance` — Computed 1w / 1mo / 3mo returns (TRY & USD) **Parameters:** - `hisse` (query, required, string) — BIST ticker, e.g. THYAO Example: `THYAO` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/borsaistanbul-api/v1/performance?hisse=THYAO" ``` **Response:** ```json { "data": { "note": "Computed period returns for one Borsa Istanbul stock over 1 week, 1 month and 3 months — in both Turkish lira and US dollars, so you can separate nominal from real performance. Pass hisse (the BIST ticker, e.g. THYAO).", "as_of": "2026-06-12", "source": "Borsa Istanbul", "symbol": "THYAO", "close_try": 307.75, "close_usd": 6.6658, "returns_try": { "1w": 3.62, "1mo": -1.52, "3mo": 7.23 }, "returns_usd": { "1w": 3.22, "1mo": -3.5, "3mo": 2.12 } }, "meta": { "timestamp": "2026-06-15T02:11:09.789Z", "request_id": "b504a7ec-26b0-4b1d-9145-67fa1ec1ac78" }, "status": "ok", "message": "Performance retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Endpoints & source **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/borsaistanbul-api/v1/meta" ``` **Response:** ```json { "data": { "sample": { "thyao_close": 307.75 }, "source": "İş Yatırım public BIST market data (isyatirim.com.tr), keyless", "service": "borsaistanbul-api", "endpoints": { "GET /v1/usd": "Dollar-denominated price history (hisse, days).", "GET /v1/meta": "This document.", "GET /v1/quote": "Latest daily quote (hisse).", "GET /v1/history": "Daily price history in TRY (hisse, days).", "GET /v1/performance": "Computed 1w/1mo/3mo returns in TRY & USD (hisse)." }, "description": "Live and historical price data for Turkish equities on Borsa Istanbul (BIST) with no key: the latest daily quote for any stock (close, average, high/low, volume, market cap in TRY and USD), the daily price history over any window, a dollar-denominated price history, and computed period returns (1w/1mo/3mo) in both TRY and USD. The Turkey-equities / price-history / dual-currency layer for trading dashboards and research. Distinct from other exchange readers — BIST time-series with a TRY/USD view. Live, short cache only.", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-15T02:11:09.862Z", "request_id": "2b18d517-db68-4d09-9764-ed59f4486e11" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/borsaistanbul-api OpenAPI spec: https://www.oanor.com/api/borsaistanbul-api/openapi.json