{"openapi":"3.1.0","info":{"title":"Bolsa de Valores de Colombia (BVC) API","version":"1.0.0","description":"Live Colombian equity data from the Bolsa de Valores de Colombia (BVC): real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in Colombian peso COP), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, and the MSCI COLCAP benchmark index. Foreign depositary receipts are filtered out so you get only genuine Colombian companies such as Ecopetrol, Grupo Nutresa, ISA, Grupo Energia Bogota and Grupo Cibest.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/colombia-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 BVC stocks","description":"","parameters":[{"name":"symbols","in":"query","required":true,"description":"Comma-separated BVC tickers (up to 20)","schema":{"type":"string"},"example":"ECOPETROL,NUTRESA,ISA"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"market":"BVC","quotes":[{"low":2810,"high":2875,"last":2875,"name":"Ecopetrol SA","open":2830,"pe_ttm":13.4507,"sector":"Energy Minerals","symbol":"ECOPETROL","ticker":"BVC:ECOPETROL","volume":18993540,"currency":"COP","change_abs":40,"change_pct":1.4109,"market_cap":118210499023438},{"low":305000,"high":308000,"last":305320,"name":"Grupo Nutresa S.A.","open":308000,"pe_ttm":141.9446,"sector":"Consumer Non-Durables","symbol":"NUTRESA","ticker":"BVC:NUTRESA","volume":256,"currency":"COP","change_abs":-2680,"change_pct":-0.8701,"market_cap":138028185643311},{"low":29500,"high":32200,"last":31500,"name":"Interconexion Electrica SA ESP","open":29780,"pe_ttm":15.2755,"sector":"Utilities","symbol":"ISA","ticker":"BVC:ISA","volume":554343,"currency":"COP","change_abs":1720,"change_pct":5.7757,"market_cap":34891856323242}]},"meta":{"timestamp":"2026-06-15T11:16:02.259Z","request_id":"f003f3c6-a761-4067-b2a3-94f62cb35324"},"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":"BVC","results":[{"low":305000,"high":308000,"last":305320,"name":"Grupo Nutresa S.A.","open":308000,"pe_ttm":141.9446,"sector":"Consumer Non-Durables","symbol":"NUTRESA","ticker":"BVC:NUTRESA","volume":256,"currency":"COP","change_abs":-2680,"change_pct":-0.8701,"market_cap":138028185643311},{"low":2810,"high":2875,"last":2875,"name":"Ecopetrol SA","open":2830,"pe_ttm":13.4507,"sector":"Energy Minerals","symbol":"ECOPETROL","ticker":"BVC:ECOPETROL","volume":18993540,"currency":"COP","change_abs":40,"change_pct":1.4109,"market_cap":118210499023438},{"low":82100,"high":85180,"last":82500,"name":"Grupo Cibest S.A.","open":82600,"pe_ttm":41.3631,"sector":"Finance","symbol":"CIBEST","ticker":"BVC:CIBEST","volume":368434,"currency":"COP","change_abs":-2400,"change_pct":-2.8269,"market_cap":73009332397461},{"low":29500,"high":32200,"last":31500,"name":"Interconexion Electrica SA ESP","open":29780,"pe_ttm":15.2755,"sector":"Utilities","symbol":"ISA","ticker":"BVC:ISA","volume":554343,"currency":"COP","change_abs":1720,"change_pct":5.7757,"market_cap":34891856323242},{"low":2865,"high":3060,"last":3050,"name":"GRUPO ENERGIA BOGOTA S.A. E.S.P","open":2975,"pe_ttm":10.1263,"sector":"Utilities","symbol":"GEB","ticker":"BVC:GEB","volume":2761126,"currency":"COP","change_abs":100,"change_pct":3.3898,"market_cap":28002589111328},{"low":841,"high":920,"last":918,"name":"Grupo Aval Acciones y Valores SA","open":841,"pe_ttm":12.7334,"sector":"Finance","symbol":"GRUPOAVAL","ticker":"BVC:GRUPOAVAL","volume":440945,"currency":"COP","change_abs":37,"change_pct":4.1998,"market_cap":22204004447754},{"low":397,"high":407,"last":407,"name":"BAC Holding International Corp","open":397,"pe_ttm":10.0565,"sector":"Finance","symbol":"BHI","ticker":"BVC:BHI","volume":875985,"currency":"COP","change_abs":10,"change_pct":2.5189,"market_cap":17590614722656},{"low":54000,"high":58200,"last":57980,"name":"Grupo de Inversiones Suramericana S.A.","open":54000,"pe_ttm":28.4718,"sector":"Finance","symbol":"GRUPOSURA","ticker":"BVC:GRUPOSURA","volume":195253,"currency":"COP","change_abs":2380,"change_pct":4.2806,"market_cap":17061163177795},{"low":39100,"high":40800,"last":40800,"name":"Banco de Bogota SA","open":39100,"pe_ttm":11.0177,"sector":"Finance","symbol":"BOGOTA","ticker":"BVC:BOGOTA","volume":47789,"currency":"COP","change_abs":1800,"change_pct":4.6154,"market_cap":14494243579102},{"low":11720,"high":12080,"last":11820,"name":"Cementos Argos SA","open":11860,"pe_ttm":30.8465,"sector":"Non-Energy Minerals","symbol":"CEMARGOS","ticker":"BVC:CEMARGOS","volume":938914,"currency":"COP","change_abs":40,"change_pct":0.3396,"market_cap":14430876687012},{"low":23500,"high":24480,"last":24460,"name":"Banco Davivienda SA Pfd","open":23700,"pe_ttm":7.8355,"sector":"Finance","symbol":"PFDAVVNDA","ticker":"BVC:PFDAVVNDA","volume":22066,"currency":"COP","change_abs":960,"change_pct":4.0851,"market_cap":11928418330931},{"low":16880,"high":17820,"last":17800,"name":"Grupo Argos S.A.","open":16880,"pe_ttm":7.2917,"sector":"Non-Energy Minerals","symbol":"GRUPOARGOS","ticker":"BVC:GRUPOARGOS","volume":350081,"currency":"COP","change_abs":800,"change_pct":4.7059,"market_cap":10845495612793},{"low":6450,"high":6780,"last":6680,"name":"Promigas SA ESP","open":6450,"pe_ttm":7.059,"sector":"Utilities","symbol":"PROMIGAS","ticker":"BVC:PROMIGAS","volume":46653,"currency":"COP","change_abs":230,"change_pct":3.5659,"market_cap":7580784790039},{"low":16960,"high":17700,"last":17700,"name":"Corporacion Financiera Colombiana SA","open":16960,"pe_ttm":12.2261,"sector":"Finance","symbol":"CORFICOLCF","ticker":"BVC:CORFICOLCF","volume":148770,"currency":"COP","change_abs":760,"change_pct":4.4864,"market_cap":6455899875488},{"low":4605,"high":4980,"last":4960,"name":"Almacenes Exito SA","open":4605,"pe_ttm":9.7746,"sector":"Retail Trade","symbol":"EXITO","ticker":"BVC:EXITO","volume":352537,"currency":"COP","change_abs":230,"change_pct":4.8626,"market_cap":6437407324219},{"low":75000,"high":77880,"last":77660,"name":"Grupo Bolivar SA","open":75000,"pe_ttm":11.1323,"sector":"Finance","symbol":"GRUBOLIVAR","ticker":"BVC:GRUBOLIVAR","volume":14260,"currency":"COP","change_abs":2720,"change_pct":3.6296,"market_cap":6143424910431},{"low":5040,"high":5270,"last":5200,"name":"Celsia SA ESP","open":5090,"pe_ttm":30.9892,"sector":"Utilities","symbol":"CELSIA","ticker":"BVC:CELSIA","volume":813709,"currency":"COP","change_abs":250,"change_pct":5.0505,"market_cap":5415927587891},{"low":14640,"high":15560,"last":15500,"name":"Mineros SA","open":14740,"pe_ttm":6.101,"sector":"Non-Energy Minerals","symbol":"MINEROS","ticker":"BVC:MINEROS","volume":330363,"currency":"COP","change_abs":920,"change_pct":6.31,"market_cap":4584598022461},{"low":18700,"high":19400,"last":19380,"name":"Organizacion Terpel SA","open":18700,"pe_ttm":5.5944,"sector":"Retail Trade","symbol":"TERPEL","ticker":"BVC:TERPEL","volume":69185,"currency":"COP","change_abs":920,"change_pct":4.9837,"market_cap":3516007096252},{"low":27300,"high":30000,"last":29660,"name":"Davivienda Group SA Pfd Registered Shs","open":27300,"sector":"Finance","symbol":"PFDAVIGRP","ticker":"BVC:PFDAVIGRP","volume":198336,"currency":"COP","change_abs":2660,"change_pct":9.8519,"market_cap":3314852351837},{"low":19500,"high":19500,"last":19500,"name":"Banco de Occidente SA","open":19500,"pe_ttm":6.1559,"sector":"Finance","symbol":"OCCIDENTE","ticker":"BVC:OCCIDENTE","volume":3000,"currency":"COP","change_abs":0,"change_pct":0,"market_cap":3040045120239},{"low":200,"high":200,"last":200,"name":"Banco Bilbao Vizcaya Argentaria Colombia SA Class B","open":200,"pe_ttm":5.6996,"sector":"Finance","symbol":"BBVACOL","ticker":"BVC:BBVACOL","volume":0,"currency":"COP","change_abs":0,"change_pct":0,"market_cap":2949501745605},{"low":15620,"high":16000,"last":15800,"name":"Bolsa de Valores de Colombia S.A.","open":15680,"pe_ttm":9.1162,"sector":"Finance","symbol":"BVC","ticker":"BVC:BVC","volume":6263,"currency":"COP","change_abs":380,"change_pct":2.4643,"market_cap":956112821198},{"low":120,"high":120,"last":120,"name":"Banco Popular SA Bogota","open":120,"pe_ttm":20.0488,"sector":"Finance","symbol":"POPULAR","ticker":"BVC:POPULAR","volume":0,"currency":"COP","change_abs":0,"change_pct":0,"market_cap":927039199219},{"low":49100,"high":49100,"last":49100,"name":"RCN Television SA","open":49100,"sector":"Consumer Services","symbol":"RCNTELEVI","ticker":"BVC:RCNTELEVI","volume":0,"currency":"COP","change_abs":0,"change_pct":0,"market_cap":780371053410}]},"meta":{"timestamp":"2026-06-15T11:16:02.487Z","request_id":"81f3be23-300f-4fe0-abb4-dc86aedc650b"},"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":"Colombian benchmark (MSCI COLCAP)","description":"","parameters":[{"name":"symbol","in":"query","required":false,"description":"Optional specific index symbol(s)","schema":{"type":"string"},"example":"ICAP"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"market":"BVC","indices":[{"low":2335.99,"high":2395.66,"name":"MSCI COLCAP Index","open":2343.94,"index":"ICAP","label":"MSCI COLCAP","value":2386.78,"change_abs":91.67,"change_pct":3.9941}]},"meta":{"timestamp":"2026-06-15T11:16:02.703Z","request_id":"b70c99fb-63d3-4e1f-9bf1-730bf560f4dc"},"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":"Bolsa de Valores de Colombia (BVC)","source":"TradingView screener (colombia market), keyless","country":"Colombia","indices":["ICAP"],"currency":"COP","examples":{"index":"/v1/index","quote":"/v1/quote?symbols=ECOPETROL,NUTRESA,ISA","screener":"/v1/screener?sort=change&order=desc&limit=10"},"endpoints":{"/v1/index":"Colombian benchmark index (MSCI COLCAP = ICAP)","/v1/quote":"live quote for one or more BVC stocks by ticker (symbols=ECOPETROL,NUTRESA,ISA)","/v1/screener":"rank local primary listings by market_cap | change | volume (sort, order, limit)"},"cache_ttl_ms":20000},"meta":{"timestamp":"2026-06-15T11:16:02.779Z","request_id":"d88892ac-3e4c-47e3-ac4b-914597219919"},"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":1240,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":920,"monthly_call_quota":37700,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2840,"monthly_call_quota":156000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":5930,"monthly_call_quota":651000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/colombia-stock-api"}