{"openapi":"3.1.0","info":{"title":"Bulgarian Stock Exchange (BSE Sofia) API","version":"1.0.0","description":"Live Bulgarian equity data from the Bulgarian Stock Exchange (BSE Sofia): real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, and the Sofia index family (SOFIX, BGB 40 and BG REIT). Foreign depositary receipts are filtered out so you get only genuine Bulgarian companies such as Shelly Group, Sopharma, Speedy and First Investment Bank.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bulgaria-stock-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 BSE Sofia stocks","description":"","parameters":[{"name":"symbols","in":"query","required":true,"description":"Comma-separated BSE Sofia tickers (up to 20)","schema":{"type":"string"},"example":"SLYG,SFA,FIB"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"market":"BSESOF","quotes":[{"low":60.1,"high":60.4,"last":60.1,"name":"Shelly Group PLC","open":60.2,"pe_ttm":40.5232,"sector":"Communications","symbol":"SLYG","ticker":"BSESOF:SLYG","volume":62,"currency":"EUR","change_abs":-0.4,"change_pct":-0.6612,"market_cap":1094176255},{"low":1.87,"high":1.89,"last":1.89,"name":"Sopharma AD","open":1.89,"pe_ttm":13.0165,"sector":"Health Technology","symbol":"SFA","ticker":"BSESOF:SFA","volume":7090,"currency":"EUR","change_abs":0,"change_pct":0,"market_cap":968573428},{"low":3.12,"high":3.12,"last":3.12,"name":"First Investment Bank AD","open":3.12,"pe_ttm":4.7699,"sector":"Finance","symbol":"FIB","ticker":"BSESOF:FIB","volume":5,"currency":"EUR","change_abs":0,"change_pct":0,"market_cap":465144537}]},"meta":{"timestamp":"2026-06-15T11:16:03.851Z","request_id":"2c50c5bb-7bc6-4bdd-8f2d-388b87b09b55"},"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":"Rank local primary listings","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"Sort field: market_cap, change or volume","schema":{"type":"string"},"example":"market_cap"},{"name":"order","in":"query","required":false,"description":"asc or desc","schema":{"type":"string"},"example":"desc"},{"name":"limit","in":"query","required":false,"description":"Number of results (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sort":"market_cap","count":25,"order":"desc","market":"BSESOF","results":[{"low":60.1,"high":60.4,"last":60.1,"name":"Shelly Group PLC","open":60.2,"pe_ttm":40.5232,"sector":"Communications","symbol":"SLYG","ticker":"BSESOF:SLYG","volume":62,"currency":"EUR","change_abs":-0.4,"change_pct":-0.6612,"market_cap":1094176255},{"low":1.87,"high":1.89,"last":1.89,"name":"Sopharma AD","open":1.89,"pe_ttm":13.0165,"sector":"Health Technology","symbol":"SFA","ticker":"BSESOF:SFA","volume":7090,"currency":"EUR","change_abs":0,"change_pct":0,"market_cap":968573428},{"low":8.55,"high":8.55,"last":8.55,"name":"Tchaikapharma High Quality Medicines, Inc.","open":8.55,"pe_ttm":215.9091,"sector":"Health Technology","symbol":"THQM","ticker":"BSESOF:THQM","volume":20,"currency":"EUR","change_abs":-0.55,"change_pct":-6.044,"market_cap":872690050},{"low":86,"high":86,"last":86,"name":"Speedy AD-Sofia","open":86,"pe_ttm":17.2438,"sector":"Transportation","symbol":"SPDY","ticker":"BSESOF:SPDY","volume":14,"currency":"EUR","change_abs":-3.5,"change_pct":-3.9106,"market_cap":481296924},{"low":3.12,"high":3.12,"last":3.12,"name":"First Investment Bank AD","open":3.12,"pe_ttm":4.7699,"sector":"Finance","symbol":"FIB","ticker":"BSESOF:FIB","volume":5,"currency":"EUR","change_abs":0,"change_pct":0,"market_cap":465144537},{"low":1.07,"high":1.08,"last":1.07,"name":"Eurohold Bulgaria AD","open":1.08,"pe_ttm":6.3127,"sector":"Utilities","symbol":"EUBG","ticker":"BSESOF:EUBG","volume":36000,"currency":"EUR","change_abs":0,"change_pct":0,"market_cap":268059373},{"low":5.05,"high":5.05,"last":5.05,"name":"M+S Hydraulic AD","open":5.05,"pe_ttm":38.6381,"sector":"Consumer Durables","symbol":"MSH","ticker":"BSESOF:MSH","volume":10,"currency":"EUR","change_abs":-0.3,"change_pct":-5.6075,"market_cap":210967621},{"low":1.64,"high":1.64,"last":1.64,"name":"Central Cooperative Bank AD","open":1.64,"pe_ttm":4.733,"sector":"Finance","symbol":"CCB","ticker":"BSESOF:CCB","volume":9,"currency":"EUR","change_abs":0,"change_pct":0,"market_cap":208493144},{"low":15.8,"high":15.8,"last":15.8,"name":"Smart Organic AD","open":15.8,"pe_ttm":24.222,"sector":"Consumer Non-Durables","symbol":"SO","ticker":"BSESOF:SO","volume":65,"currency":"EUR","change_abs":0,"change_pct":0,"market_cap":187304701},{"low":2.64,"high":2.64,"last":2.64,"name":"Velgraf Asset Management Ad","open":2.64,"pe_ttm":1056,"sector":"Finance","symbol":"VAM","ticker":"BSESOF:VAM","volume":100,"currency":"EUR","change_abs":0.04,"change_pct":1.5385,"market_cap":182106555},{"low":25.4,"high":25.4,"last":25.4,"name":"Holding Varna Ad","open":25.4,"pe_ttm":34.2318,"sector":"Finance","symbol":"HVAR","ticker":"BSESOF:HVAR","volume":240,"currency":"EUR","change_abs":0,"change_pct":0,"market_cap":164741783},{"low":6.2,"high":6.25,"last":6.25,"name":"Bulgarian-American Credit Bank AD","open":6.2,"pe_ttm":8.2443,"sector":"Finance","symbol":"BACB","ticker":"BSESOF:BACB","volume":42,"currency":"EUR","change_abs":-0.2,"change_pct":-3.1008,"market_cap":154320705},{"low":48.6,"high":48.6,"last":48.6,"name":"Synthetica AD","open":48.6,"sector":"Health Technology","symbol":"SYN","ticker":"BSESOF:SYN","volume":1,"currency":"EUR","change_abs":0,"change_pct":0,"market_cap":145799995},{"low":10.7,"high":11,"last":11,"name":"Telematic Interactive Bulgaria AD","open":10.7,"pe_ttm":19.3152,"sector":"Consumer Services","symbol":"TIB","ticker":"BSESOF:TIB","volume":453,"currency":"EUR","change_abs":0.3,"change_pct":2.8037,"market_cap":140872250},{"low":15,"high":15,"last":15,"name":"TPP-Bobov Dol AD","open":15,"sector":"Utilities","symbol":"TBD","ticker":"BSESOF:TBD","volume":5,"currency":"EUR","change_abs":-2.5,"change_pct":-14.2857,"market_cap":130575600.00000001},{"low":0.8,"high":0.85,"last":0.8,"name":"Gradus AD","open":0.85,"pe_ttm":18.1406,"sector":"Process Industries","symbol":"GR6","ticker":"BSESOF:GR6","volume":3217,"currency":"EUR","change_abs":0.035,"change_pct":4.5752,"market_cap":126394372},{"low":1.29,"high":1.34,"last":1.29,"name":"Advance Terrafund REIT","open":1.31,"pe_ttm":135.7895,"sector":"Finance","symbol":"ATER","ticker":"BSESOF:ATER","volume":127726,"currency":"EUR","change_abs":-0.055,"change_pct":-4.0892,"market_cap":114473076},{"low":0.48,"high":0.505,"last":0.5,"name":"Chimimport AD","open":0.505,"pe_ttm":1.6171,"sector":"Finance","symbol":"CHIM","ticker":"BSESOF:CHIM","volume":38355,"currency":"EUR","change_abs":0,"change_pct":0,"market_cap":113231766},{"low":5.4,"high":5.4,"last":5.4,"name":"Stara Planina Holding AD","open":5.4,"pe_ttm":25.0464,"sector":"Producer Manufacturing","symbol":"SPH","ticker":"BSESOF:SPH","volume":52,"currency":"EUR","change_abs":0.1,"change_pct":1.8868,"market_cap":110100800},{"low":5.12,"high":5.26,"last":5.18,"name":"DOVERIE - United Holding AD","open":5.12,"pe_ttm":1.8878,"sector":"Finance","symbol":"DUH","ticker":"BSESOF:DUH","volume":645,"currency":"EUR","change_abs":0.08,"change_pct":1.5686,"market_cap":109649259},{"low":3,"high":3,"last":3,"name":"Sopharma Trading AD","open":3,"pe_ttm":3.9308,"sector":"Distribution Services","symbol":"SFT","ticker":"BSESOF:SFT","volume":865,"currency":"EUR","change_abs":0,"change_pct":0,"market_cap":102828140},{"low":2.73,"high":2.79,"last":2.73,"name":"Bulgarian Real Estate Fund REIT","open":2.78,"pe_ttm":7.5103,"sector":"Finance","symbol":"BREF","ticker":"BSESOF:BREF","volume":8655,"currency":"EUR","change_abs":-0.06,"change_pct":-2.1505,"market_cap":96650972},{"low":7.26,"high":7.28,"last":7.28,"name":"BULGARIAN STOCK EXCHANGE-Sofia","open":7.28,"pe_ttm":13.4665,"sector":"Finance","symbol":"BSE","ticker":"BSESOF:BSE","volume":305,"currency":"EUR","change_abs":0.08,"change_pct":1.1111,"market_cap":94793181},{"low":4.08,"high":4.1,"last":4.08,"name":"Sopharma Properties REIT","open":4.08,"pe_ttm":12.5926,"sector":"Finance","symbol":"SFI","ticker":"BSESOF:SFI","volume":133017,"currency":"EUR","change_abs":0,"change_pct":0,"market_cap":89561387},{"low":35.6,"high":35.6,"last":35.6,"name":"Himsnab Bulgaria AD","open":35.6,"pe_ttm":5.8742,"sector":"Finance","symbol":"CHSB","ticker":"BSESOF:CHSB","volume":9,"currency":"EUR","change_abs":0.2,"change_pct":0.565,"market_cap":88808862}]},"meta":{"timestamp":"2026-06-15T11:16:04.064Z","request_id":"35f53b7a-6003-4976-a703-9be970607215"},"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":"Sofia indices (SOFIX family)","description":"","parameters":[{"name":"symbol","in":"query","required":false,"description":"Optional specific index symbol(s)","schema":{"type":"string"},"example":"SOFIX"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"market":"BSESOF","indices":[{"low":1245.65,"high":1254.52,"name":"SOFIX BGN","open":1250.42,"index":"SOFIX","label":"SOFIX","value":1245.79,"change_abs":-4.63,"change_pct":-0.3703}]},"meta":{"timestamp":"2026-06-15T11:16:04.277Z","request_id":"6669227f-746a-4aaa-baff-dd6eca1acfc6"},"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":"Market metadata & endpoint guide","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"market":"Bulgarian Stock Exchange (BSE Sofia)","source":"TradingView screener (bulgaria market), keyless","country":"Bulgaria","indices":["SOFIX","BGBX40","BGREIT"],"currency":"EUR","examples":{"index":"/v1/index","quote":"/v1/quote?symbols=SLYG,SFA,FIB","screener":"/v1/screener?sort=change&order=desc&limit=10"},"endpoints":{"/v1/index":"Sofia indices (SOFIX, BGB 40 = BGBX40, BG REIT = BGREIT)","/v1/quote":"live quote for one or more BSE Sofia stocks by ticker (symbols=SLYG,SFA,FIB)","/v1/screener":"rank local primary listings by market_cap | change | volume (sort, order, limit)"},"cache_ttl_ms":20000},"meta":{"timestamp":"2026-06-15T11:16:04.366Z","request_id":"d769d3e7-6e15-453b-ade9-20798341be5a"},"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":1480,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1230,"monthly_call_quota":44800,"rps_limit":7,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3690,"monthly_call_quota":188000,"rps_limit":17,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7640,"monthly_call_quota":779000,"rps_limit":44,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bulgaria-stock-api"}