{"openapi":"3.1.0","info":{"title":"Borsa Istanbul (BIST) API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/borsaistanbul-api","description":"oanor gateway"}],"tags":[{"name":"Quotes"},{"name":"History"},{"name":"Analytics"},{"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":"Latest daily quote (TRY & USD)","description":"","parameters":[{"name":"hisse","in":"query","required":true,"description":"BIST ticker, e.g. THYAO (Turkish Airlines), GARAN, ASELS","schema":{"type":"string"},"example":"THYAO"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"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/history":{"get":{"operationId":"get_v1_history","tags":["History"],"summary":"Daily price history in TRY","description":"","parameters":[{"name":"hisse","in":"query","required":true,"description":"BIST ticker, e.g. THYAO","schema":{"type":"string"},"example":"THYAO"},{"name":"days","in":"query","required":false,"description":"Look-back window in days (5-365, default 30)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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},{"low":271.5,"date":"2026-05-22","high":290.25,"close":288,"average":283.472,"close_usd":6.3109,"volume_try":17739665908,"market_cap_try":397440000000,"market_cap_usd":8709047601.30864},{"low":296,"date":"2026-05-25","high":300.5,"close":297.5,"average":298.192,"close_usd":6.5079,"volume_try":13153259974,"market_cap_try":410550000000,"market_cap_usd":8980955256.00809},{"low":295.25,"date":"2026-05-26","high":298,"close":296.75,"average":296.689,"close_usd":6.4915,"volume_try":3484485135,"market_cap_try":409515000000,"market_cap_usd":8958314192.33748},{"low":291,"date":"2026-06-01","high":300.5,"close":291.5,"average":295.86,"close_usd":6.3498,"volume_try":13017523899,"market_cap_try":402270000000,"market_cap_usd":8762658662.12999},{"low":294.25,"date":"2026-06-02","high":300.25,"close":300,"average":298.1,"close_usd":6.5327,"volume_try":12781499308,"market_cap_try":414000000000,"market_cap_usd":9015129739.47581},{"low":296.5,"date":"2026-06-03","high":301.75,"close":297,"average":298.575,"close_usd":6.4632,"volume_try":10908144720,"market_cap_try":409860000000,"market_cap_usd":8919268283.12899},{"low":296.5,"date":"2026-06-04","high":301.5,"close":299.75,"average":299.219,"close_usd":6.5206,"volume_try":13713372545,"market_cap_try":413655000000,"market_cap_usd":8998368501.19643},{"low":295.25,"date":"2026-06-05","high":300.25,"close":297,"average":297.412,"close_usd":6.4578,"volume_try":7540816820,"market_cap_try":409860000000,"market_cap_usd":8911724224.90438},{"low":292.5,"date":"2026-06-08","high":299.5,"close":297.25,"average":297.024,"close_usd":6.4483,"volume_try":11664519069,"market_cap_try":410205000000,"market_cap_usd":8898677362.88243},{"low":295.5,"date":"2026-06-09","high":300,"close":296.75,"average":298.059,"close_usd":6.4349,"volume_try":11527048789,"market_cap_try":409515000000,"market_cap_usd":8880145199.69295},{"low":293.25,"date":"2026-06-10","high":298.25,"close":295.5,"average":296.251,"close_usd":6.4055,"volume_try":9389712062,"market_cap_try":407790000000,"market_cap_usd":8839634093.47091},{"low":291.5,"date":"2026-06-11","high":297.5,"close":293.25,"average":294.37,"close_usd":6.3543,"volume_try":10029234245,"market_cap_try":404685000000,"market_cap_usd":8768924743.06553},{"low":301,"date":"2026-06-12","high":311,"close":307.75,"average":306.815,"close_usd":6.6658,"volume_try":26865029766,"market_cap_try":424695000000,"market_cap_usd":9198744606.74741}]},"meta":{"timestamp":"2026-06-15T02:11:09.518Z","request_id":"fa469db3-a687-4471-83a7-a4b956ca5fb2"},"status":"ok","message":"History 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/usd":{"get":{"operationId":"get_v1_usd","tags":["History"],"summary":"Dollar-denominated price history","description":"","parameters":[{"name":"hisse","in":"query","required":true,"description":"BIST ticker, e.g. THYAO","schema":{"type":"string"},"example":"THYAO"},{"name":"days","in":"query","required":false,"description":"Look-back window in days (5-365, default 30)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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_usd":8980955256.00809},{"date":"2026-05-26","low_usd":6.4587,"high_usd":6.5189,"close_usd":6.4915,"market_cap_usd":8958314192.33748},{"date":"2026-06-01","low_usd":6.3389,"high_usd":6.5458,"close_usd":6.3498,"market_cap_usd":8762658662.12999},{"date":"2026-06-02","low_usd":6.4075,"high_usd":6.5381,"close_usd":6.5327,"market_cap_usd":9015129739.47581},{"date":"2026-06-03","low_usd":6.4524,"high_usd":6.5666,"close_usd":6.4632,"market_cap_usd":8919268283.12899},{"date":"2026-06-04","low_usd":6.4499,"high_usd":6.5586,"close_usd":6.5206,"market_cap_usd":8998368501.19643},{"date":"2026-06-05","low_usd":6.4197,"high_usd":6.5284,"close_usd":6.4578,"market_cap_usd":8911724224.90438},{"date":"2026-06-08","low_usd":6.3453,"high_usd":6.4971,"close_usd":6.4483,"market_cap_usd":8898677362.88243},{"date":"2026-06-09","low_usd":6.4078,"high_usd":6.5054,"close_usd":6.4349,"market_cap_usd":8880145199.69295},{"date":"2026-06-10","low_usd":6.3568,"high_usd":6.4651,"close_usd":6.4055,"market_cap_usd":8839634093.47091},{"date":"2026-06-11","low_usd":6.3164,"high_usd":6.4464,"close_usd":6.3543,"market_cap_usd":8768924743.06553},{"date":"2026-06-12","low_usd":6.5196,"high_usd":6.7362,"close_usd":6.6658,"market_cap_usd":9198744606.74741}]},"meta":{"timestamp":"2026-06-15T02:11:09.592Z","request_id":"279a3b66-c0f3-4f3b-953b-1de859130c9f"},"status":"ok","message":"USD history 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/performance":{"get":{"operationId":"get_v1_performance","tags":["Analytics"],"summary":"Computed 1w / 1mo / 3mo returns (TRY & USD)","description":"","parameters":[{"name":"hisse","in":"query","required":true,"description":"BIST ticker, e.g. THYAO","schema":{"type":"string"},"example":"THYAO"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"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":"Endpoints & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"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":16000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":2240,"monthly_call_quota":320000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":5750,"monthly_call_quota":1750000,"rps_limit":20,"hard_limit":true},{"slug":"enterprise","name":"Enterprise","price_cents_month":13600,"monthly_call_quota":9000000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/borsaistanbul-api"}