{"openapi":"3.1.0","info":{"title":"Lima Stock Exchange (BVL) API","version":"1.0.0","description":"Live Peruvian equity data from the Lima Stock Exchange (BVL): real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in PEN/USD), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, a name search to find BVL stocks by company name, and the Peru general index (MSCI NUAM Peru General). Foreign depositary receipts are filtered out so you get only genuine Peruvian companies such as Banco de Credito, BBVA Peru and Buenaventura.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/peru-stock-api","description":"oanor gateway"}],"tags":[{"name":"Quotes"},{"name":"Screener"},{"name":"Search"},{"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 BVL stocks","description":"","parameters":[{"name":"symbols","in":"query","required":true,"description":"Comma-separated BVL tickers (up to 20)","schema":{"type":"string"},"example":"CREDITC1,BBVAC1,BACKUAC1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"market":"BVL","quotes":[{"low":6.3,"high":6.45,"last":6.36,"name":"Banco de Credito del Peru SA","open":6.45,"pe_ttm":12.0386,"sector":"Finance","symbol":"CREDITC1","ticker":"BVL:CREDITC1","volume":68955,"currency":"PEN","change_abs":0.06,"change_pct":0.9524,"market_cap":82535337959},{"low":1.94,"high":1.95,"last":1.95,"name":"Banco BBVA Peru SA","open":1.95,"pe_ttm":8.2278,"sector":"Finance","symbol":"BBVAC1","ticker":"BVL:BBVAC1","volume":480440,"currency":"PEN","change_abs":0,"change_pct":0,"market_cap":20681319646},{"low":220,"high":220,"last":220,"name":"Union De Cervecerias Peruanas Backus & Johnston SAA Class A","open":220,"pe_ttm":95.1351,"sector":"Consumer Non-Durables","symbol":"BACKUAC1","ticker":"BVL:BACKUAC1","volume":50,"currency":"PEN","change_abs":0,"change_pct":0,"market_cap":30755076632}]},"meta":{"timestamp":"2026-06-15T02:10:17.518Z","request_id":"a0c74f5f-5d8f-461c-95aa-30752f50e676"},"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":"BVL","results":[{"low":6.3,"high":6.45,"last":6.36,"name":"Banco de Credito del Peru SA","open":6.45,"pe_ttm":12.0386,"sector":"Finance","symbol":"CREDITC1","ticker":"BVL:CREDITC1","volume":68955,"currency":"PEN","change_abs":0.06,"change_pct":0.9524,"market_cap":82535337959},{"low":55.6,"high":60,"last":59,"name":"Sociedad Minera Cerro Verde SAA","open":59,"pe_ttm":13.8498,"sector":"Non-Energy Minerals","symbol":"CVERDEC1","ticker":"BVL:CVERDEC1","volume":779,"currency":"USD","change_abs":0,"change_pct":0,"market_cap":70334970007.50528},{"low":220,"high":220,"last":220,"name":"Union De Cervecerias Peruanas Backus & Johnston SAA Class A","open":220,"pe_ttm":95.1351,"sector":"Consumer Non-Durables","symbol":"BACKUAC1","ticker":"BVL:BACKUAC1","volume":50,"currency":"PEN","change_abs":0,"change_pct":0,"market_cap":30755076632},{"low":117,"high":117,"last":117,"name":"Compania de Minas Buenaventura SAA","open":117,"pe_ttm":8.8456,"sector":"Non-Energy Minerals","symbol":"BUENAVC1","ticker":"BVL:BUENAVC1","volume":300,"currency":"PEN","change_abs":-2,"change_pct":-1.6807,"market_cap":29699620014},{"low":1.94,"high":1.95,"last":1.95,"name":"Banco BBVA Peru SA","open":1.95,"pe_ttm":8.2278,"sector":"Finance","symbol":"BBVAC1","ticker":"BVL:BBVAC1","volume":480440,"currency":"PEN","change_abs":0,"change_pct":0,"market_cap":20681319646},{"low":17,"high":17,"last":17,"name":"Scotiabank Peru SA","open":17,"pe_ttm":9.9976,"sector":"Finance","symbol":"SCOTIAC1","ticker":"BVL:SCOTIAC1","volume":10,"currency":"PEN","change_abs":0,"change_pct":0,"market_cap":13985523560},{"low":235.5,"high":235.5,"last":235.5,"name":"Southern Peru Copper Corp.","open":235.5,"pe_ttm":1.7643,"sector":"Non-Energy Minerals","symbol":"SPCCPI1","ticker":"BVL:SPCCPI1","volume":332,"currency":"PEN","change_abs":5.5,"change_pct":2.3913,"market_cap":13454349012},{"low":34.4,"high":35.8,"last":35.8,"name":"InRetail Peru Corp.","open":34.5,"pe_ttm":13.5033,"sector":"Retail Trade","symbol":"INRETC1","ticker":"BVL:INRETC1","volume":53393,"currency":"USD","change_abs":1.3,"change_pct":3.7681,"market_cap":13237916632.913279},{"low":1.9,"high":1.9,"last":1.9,"name":"Banco Internacional del Peru SAA Interbank","open":1.9,"pe_ttm":8.0508,"sector":"Finance","symbol":"INTERBC1","ticker":"BVL:INTERBC1","volume":1262,"currency":"PEN","change_abs":0,"change_pct":0,"market_cap":12795045152},{"low":25,"high":25,"last":25,"name":"Shougang Hierro Peru Saa","open":25,"pe_ttm":8.315,"sector":"Non-Energy Minerals","symbol":"SHPC1","ticker":"BVL:SHPC1","volume":600,"currency":"PEN","change_abs":0,"change_pct":0,"market_cap":11151261902},{"low":9.1,"high":9.1,"last":9.1,"name":"Compania Minera Poderosa SA","open":9.1,"pe_ttm":12.9078,"sector":"Non-Energy Minerals","symbol":"PODERC1","ticker":"BVL:PODERC1","volume":3641,"currency":"PEN","change_abs":0.1,"change_pct":1.1111,"market_cap":9100000381},{"low":2.84,"high":2.9,"last":2.87,"name":"Orygen Peru SAA","open":2.88,"pe_ttm":11.4161,"sector":"Utilities","symbol":"ORYGENC1","ticker":"BVL:ORYGENC1","volume":41644,"currency":"PEN","change_abs":0.02,"change_pct":0.7018,"market_cap":8987720546},{"low":11.65,"high":11.7,"last":11.66,"name":"Alicorp SAA","open":11.65,"pe_ttm":15.8102,"sector":"Consumer Non-Durables","symbol":"ALICORC1","ticker":"BVL:ALICORC1","volume":9147,"currency":"PEN","change_abs":0.06,"change_pct":0.5172,"market_cap":6733885963},{"low":13.3,"high":13.3,"last":13.3,"name":"Luz del Sur SA","open":13.3,"pe_ttm":9.1883,"sector":"Utilities","symbol":"LUSURC1","ticker":"BVL:LUSURC1","volume":1470,"currency":"PEN","change_abs":0.3,"change_pct":2.3077,"market_cap":6476453520},{"low":6.6,"high":6.7,"last":6.7,"name":"Minsur SA","open":6.65,"pe_ttm":7.3489,"sector":"Non-Energy Minerals","symbol":"MINSURI1","ticker":"BVL:MINSURI1","volume":282942,"currency":"PEN","change_abs":0.13,"change_pct":1.9787,"market_cap":6438705133},{"low":55.01,"high":55.01,"last":55.01,"name":"Cerveceria San Juan SA","open":55.01,"pe_ttm":10.2556,"sector":"Consumer Non-Durables","symbol":"SNJUANC1","ticker":"BVL:SNJUANC1","volume":33,"currency":"PEN","change_abs":0,"change_pct":0,"market_cap":5484322461},{"low":1.95,"high":1.95,"last":1.95,"name":"Volcan Compania Minera S.A.A. Class A","open":1.95,"pe_ttm":8.8596,"sector":"Non-Energy Minerals","symbol":"VOLCAAC1","ticker":"BVL:VOLCAAC1","volume":11980,"currency":"PEN","change_abs":-0.05,"change_pct":-2.5,"market_cap":5244740187},{"low":3.35,"high":3.45,"last":3.44,"name":"Nexa Resources Peru SAA","open":3.44,"pe_ttm":4.1011,"sector":"Non-Energy Minerals","symbol":"NEXAPEC1","ticker":"BVL:NEXAPEC1","volume":176307,"currency":"PEN","change_abs":0.01,"change_pct":0.2915,"market_cap":4379414817},{"low":1.3,"high":1.35,"last":1.35,"name":"Pluz Energia Peru SAA","open":1.3,"pe_ttm":8.8293,"sector":"Utilities","symbol":"PLUZENC1","ticker":"BVL:PLUZENC1","volume":477547,"currency":"PEN","change_abs":0.01,"change_pct":0.7463,"market_cap":4094613024},{"low":4.03,"high":4.08,"last":4.07,"name":"Ferreycorp SAA","open":4.03,"pe_ttm":9.8571,"sector":"Distribution Services","symbol":"FERREYC1","ticker":"BVL:FERREYC1","volume":673435,"currency":"PEN","change_abs":0.05,"change_pct":1.2438,"market_cap":3849531321},{"low":21.9,"high":21.9,"last":21.9,"name":"Sociedad Minera el Brocal SA","open":21.9,"pe_ttm":6.5317,"sector":"Non-Energy Minerals","symbol":"BROCALC1","ticker":"BVL:BROCALC1","volume":443,"currency":"PEN","change_abs":1.4,"change_pct":6.8293,"market_cap":3507141263},{"low":7.15,"high":7.25,"last":7.22,"name":"Cementos Pacasmayo SAA","open":7.25,"pe_ttm":16.8455,"sector":"Non-Energy Minerals","symbol":"CPACASC1","ticker":"BVL:CPACASC1","volume":9640,"currency":"PEN","change_abs":0.07,"change_pct":0.979,"market_cap":3338254427},{"low":0.192,"high":0.192,"last":0.192,"name":"Integratel Peru S.A.A Class B","open":0.192,"sector":"Communications","symbol":"INTPEBC1","ticker":"BVL:INTPEBC1","volume":40000,"currency":"PEN","change_abs":0.027,"change_pct":16.3636,"market_cap":3166030433},{"low":1.75,"high":1.85,"last":1.81,"name":"UNACEM Corp. Sociedad Anonima Abierta","open":1.75,"pe_ttm":7.9806,"sector":"Non-Energy Minerals","symbol":"UNACEMC1","ticker":"BVL:UNACEMC1","volume":491102,"currency":"PEN","change_abs":0.01,"change_pct":0.5556,"market_cap":2895999908},{"low":4.32,"high":4.4,"last":4.38,"name":"ENGIE Energia Peru SA","open":4.4,"pe_ttm":15.9971,"sector":"Utilities","symbol":"ENGIEC1","ticker":"BVL:ENGIEC1","volume":57724,"currency":"PEN","change_abs":0.042,"change_pct":0.9682,"market_cap":2620168993}]},"meta":{"timestamp":"2026-06-15T02:10:17.761Z","request_id":"23e8b768-4f77-4a3f-a0ee-de310527ca70"},"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/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Find BVL stocks by company name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Company name fragment","schema":{"type":"string"},"example":"banco"},{"name":"limit","in":"query","required":false,"description":"Number of results (1-50)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"query":"banco","market":"BVL","results":[{"low":1.9,"high":1.9,"last":1.9,"name":"Banco Internacional del Peru SAA Interbank","open":1.9,"pe_ttm":8.0508,"sector":"Finance","symbol":"INTERBC1","ticker":"BVL:INTERBC1","volume":1262,"currency":"PEN","change_abs":0,"change_pct":0,"market_cap":12795045152},{"low":1.94,"high":1.95,"last":1.95,"name":"Banco BBVA Peru SA","open":1.95,"pe_ttm":8.2278,"sector":"Finance","symbol":"BBVAC1","ticker":"BVL:BBVAC1","volume":480440,"currency":"PEN","change_abs":0,"change_pct":0,"market_cap":20681319646},{"low":6.3,"high":6.45,"last":6.36,"name":"Banco de Credito del Peru SA","open":6.45,"pe_ttm":12.0386,"sector":"Finance","symbol":"CREDITC1","ticker":"BVL:CREDITC1","volume":68955,"currency":"PEN","change_abs":0.06,"change_pct":0.9524,"market_cap":82535337959}]},"meta":{"timestamp":"2026-06-15T02:10:17.992Z","request_id":"23a96aac-19e2-44ca-aea2-0affd28f4c70"},"status":"ok","message":"Search 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":"Peru general index (MSCI NUAM Peru General)","description":"","parameters":[{"name":"symbol","in":"query","required":false,"description":"Optional specific index symbol(s)","schema":{"type":"string"},"example":"MXNUAMPEGEN"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"market":"BVL","indices":[{"low":55088.83,"high":56491.6,"name":"MSCI NUAM Peru General","open":55092.36,"index":"MXNUAMPEGEN","value":56321.11,"change_abs":2278.8,"change_pct":4.2167}]},"meta":{"timestamp":"2026-06-15T02:10:18.175Z","request_id":"937238ed-2cfa-46b5-b7ec-83110869d499"},"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":"Lima Stock Exchange (BVL)","source":"TradingView screener (peru market), keyless","country":"Peru","indices":["MXNUAMPEGEN","MXNUAMPESEL"],"currency":"PEN","examples":{"index":"/v1/index","quote":"/v1/quote?symbols=CREDITC1,BBVAC1,BACKUAC1","search":"/v1/search?q=banco","screener":"/v1/screener?sort=change&order=desc&limit=10"},"endpoints":{"/v1/index":"Peru general index (MSCI NUAM Peru General)","/v1/quote":"live quote for one or more BVL stocks by ticker (symbols=CREDITC1,BBVAC1)","/v1/search":"find BVL stocks by company name (q, limit)","/v1/screener":"rank local primary listings by market_cap | change | volume (sort, order, limit)"},"cache_ttl_ms":20000},"meta":{"timestamp":"2026-06-15T02:10:18.253Z","request_id":"60662faf-619d-477c-912c-3181efdc0da7"},"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":1600,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1230,"monthly_call_quota":46000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3730,"monthly_call_quota":185000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8090,"monthly_call_quota":760000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/peru-stock-api"}