{"openapi":"3.1.0","info":{"title":"Central Bank of Peru FX & Data API","version":"1.0.0","description":"Live official data for the Peruvian sol (PEN) and the full statistics database of the Central Reserve Bank of Peru (Banco Central de Reserva del Perú, BCRP) — straight from its public series API as clean JSON. Get the latest official interbank USD/PEN exchange rate (buy, sell and mid); pull the daily interbank USD/PEN rate over any date range; convert between USD and PEN at the BCRP's interbank mid rate; or fetch any BCRP statistical series by its code — exchange rates, international reserves, interest rates, inflation, monetary aggregates and thousands more — over a date range, for direct access to the central bank's whole time-series database (join up to 10 codes at once). Read live from the BCRP, nothing cached. This is the official Peruvian-sol rate plus Peru's central-bank statistics — distinct from the ECB, BCRA, BCB and other central-bank feeds and from market mid-rates: the BCRP's own published sol rate and economic series.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bcrp-api","description":"oanor gateway"}],"tags":[{"name":"USD"},{"name":"History"},{"name":"Convert"},{"name":"Series"},{"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/usd":{"get":{"operationId":"get_v1_usd","tags":["USD"],"summary":"Latest official interbank USD/PEN rate (buy, sell, mid)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"buy":3.4731,"mid":3.4787,"base":"USD","date":"2026-06-08","pair":"USD/PEN","sell":3.4842,"quote":"PEN","source":"Banco Central de Reserva del Perú"},"meta":{"timestamp":"2026-06-10T13:59:14.398Z","request_id":"ae9f75b8-bb51-4337-933d-e193c7c7a373"},"status":"ok","message":"USD/PEN rate 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 interbank USD/PEN rate over a date range","description":"","parameters":[{"name":"from","in":"query","required":false,"description":"Start date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-01"},{"name":"to","in":"query","required":false,"description":"End date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-08"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"2026-06-08","from":"2026-06-01","pair":"USD/PEN","count":6,"source":"Banco Central de Reserva del Perú","history":[{"buy":3.4166,"mid":3.4177,"date":"2026-06-01","sell":3.4188},{"buy":3.4081,"mid":3.4091,"date":"2026-06-02","sell":3.4101},{"buy":3.4179,"mid":3.4188,"date":"2026-06-03","sell":3.4198},{"buy":3.4127,"mid":3.4137,"date":"2026-06-04","sell":3.4147},{"buy":3.4509,"mid":3.4529,"date":"2026-06-05","sell":3.4549},{"buy":3.4731,"mid":3.4787,"date":"2026-06-08","sell":3.4842}]},"meta":{"timestamp":"2026-06-10T13:59:16.349Z","request_id":"b64cd908-2db3-4e21-837d-ed1a5eeeeee5"},"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/convert":{"get":{"operationId":"get_v1_convert","tags":["Convert"],"summary":"Convert between USD and PEN at the interbank mid rate","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Source currency (USD or PEN)","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"Target currency (USD or PEN)","schema":{"type":"string"},"example":"PEN"},{"name":"amount","in":"query","required":false,"description":"Amount to convert","schema":{"type":"string"},"example":"100"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"PEN","date":"2026-06-08","from":"USD","rate":3.4787,"amount":100,"result":347.87,"source":"Banco Central de Reserva del Perú","usd_pen_mid":3.4787},"meta":{"timestamp":"2026-06-10T13:59:18.279Z","request_id":"14858d97-edb9-42a1-a9cd-cd00988f4645"},"status":"ok","message":"Conversion completed 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/series":{"get":{"operationId":"get_v1_series","tags":["Series"],"summary":"Any BCRP statistical series by code over a date range","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"BCRP series code (join up to 10 with hyphens)","schema":{"type":"string"},"example":"PD04637PD"},{"name":"from","in":"query","required":false,"description":"Start date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-01-01"},{"name":"to","in":"query","required":false,"description":"End date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-08"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"2026-06-08","from":"2026-01-01","codes":["PD04637PD"],"count":108,"source":"Banco Central de Reserva del Perú","observations":[{"date":"2026-01-05","values":[3.36257142857143]},{"date":"2026-01-06","values":[3.35914285714286]},{"date":"2026-01-07","values":[3.36142857142857]},{"date":"2026-01-08","values":[3.36228571428571]},{"date":"2026-01-09","values":[3.36028571428571]},{"date":"2026-01-12","values":[3.35957142857143]},{"date":"2026-01-13","values":[3.35742857142857]},{"date":"2026-01-14","values":[3.35842857142857]},{"date":"2026-01-15","values":[3.36071428571429]},{"date":"2026-01-16","values":[3.35942857142857]},{"date":"2026-01-19","values":[3.356]},{"date":"2026-01-20","values":[3.357]},{"date":"2026-01-21","values":[3.354]},{"date":"2026-01-22","values":[3.35371428571429]},{"date":"2026-01-23","values":[3.35185714285714]},{"date":"2026-01-26","values":[3.34957142857143]},{"date":"2026-01-27","values":[3.34685714285714]},{"date":"2026-01-28","values":[3.34085714285714]},{"date":"2026-01-29","values":[3.34142857142857]},{"date":"2026-01-30","values":[3.356]},{"date":"2026-02-02","values":[3.36457142857143]},{"date":"2026-02-03","values":[3.36028571428571]},{"date":"2026-02-04","values":[3.359]},{"date":"2026-02-05","values":[3.36585714285714]},{"date":"2026-02-06","values":[3.35814285714286]},{"date":"2026-02-09","values":[3.356]},{"date":"2026-02-10","values":[3.35657142857143]},{"date":"2026-02-11","values":[3.35514285714286]},{"date":"2026-02-12","values":[3.35314285714286]},{"date":"2026-02-13","values":[3.35171428571429]},{"date":"2026-02-16","values":[3.34757142857143]},{"date":"2026-02-17","values":[3.34528571428571]},{"date":"2026-02-18","values":[3.34771428571429]},{"date":"2026-02-19","values":[3.362]},{"date":"2026-02-20","values":[3.35628571428571]},{"date":"2026-02-23","values":[3.35642857142857]},{"date":"2026-02-24","values":[3.35714285714286]},{"date":"2026-02-25","values":[3.35542857142857]},{"date":"2026-02-26","values":[3.35557142857143]},{"date":"2026-02-27","values":[3.35457142857143]},{"date":"2026-03-02","values":[3.364]},{"date":"2026-03-03","values":[3.40785714285714]},{"date":"2026-03-04","values":[3.40671428571429]},{"date":"2026-03-05","values":[3.42742857142857]},{"date":"2026-03-06","values":[3.47442857142857]},{"date":"2026-03-09","values":[3.48642857142857]},{"date":"2026-03-10","values":[3.43371428571429]},{"date":"2026-03-11","values":[3.42157142857143]},{"date":"2026-03-12","values":[3.44228571428571]},{"date":"2026-03-13","values":[3.44328571428571]},{"date":"2026-03-16","values":[3.42242857142857]},{"date":"2026-03-17","values":[3.40957142857143]},{"date":"2026-03-18","values":[3.43285714285714]},{"date":"2026-03-19","values":[3.45271428571429]},{"date":"2026-03-20","values":[3.47285714285714]},{"date":"2026-03-23","values":[3.45071428571429]},{"date":"2026-03-24","values":[3.45557142857143]},{"date":"2026-03-25","values":[3.45728571428571]},{"date":"2026-03-26","values":[3.46514285714286]},{"date":"2026-03-27","values":[3.48642857142857]},{"date":"2026-03-30","values":[3.48757142857143]},{"date":"2026-03-31","values":[3.48571428571429]},{"date":"2026-04-01","values":[3.454]},{"date":"2026-04-06","values":[3.42414285714286]},{"date":"2026-04-07","values":[3.42685714285714]},{"date":"2026-04-08","values":[3.38442857142857]},{"date":"2026-04-09","values":[3.377]},{"date":"2026-04-10","values":[3.38485714285714]},{"date":"2026-04-13","values":[3.36628571428571]},{"date":"2026-04-14","values":[3.38542857142857]},{"date":"2026-04-15","values":[3.43585714285714]},{"date":"2026-04-16","values":[3.431]},{"date":"2026-04-17","values":[3.43371428571429]},{"date":"2026-04-20","values":[3.43342857142857]},{"date":"2026-04-21","values":[3.43585714285714]},{"date":"2026-04-22","values":[3.43928571428571]},{"date":"2026-04-23","values":[3.45914285714286]},{"date":"2026-04-24","values":[3.472]},{"date":"2026-04-27","values":[3.502]},{"date":"2026-04-28","values":[3.51428571428571]},{"date":"2026-04-29","values":[3.52714285714286]},{"date":"2026-04-30","values":[3.51471428571429]},{"date":"2026-05-04","values":[3.51457142857143]},{"date":"2026-05-05","values":[3.48885714285714]},{"date":"2026-05-06","values":[3.46271428571429]},{"date":"2026-05-07","values":[3.45771428571429]},{"date":"2026-05-08","values":[3.438]},{"date":"2026-05-11","values":[3.42971428571429]},{"date":"2026-05-12","values":[3.43085714285714]},{"date":"2026-05-13","values":[3.42]},{"date":"2026-05-14","values":[3.41385714285714]},{"date":"2026-05-15","values":[3.432]},{"date":"2026-05-18","values":[3.42642857142857]},{"date":"2026-05-19","values":[3.42542857142857]},{"date":"2026-05-20","values":[3.40871428571429]},{"date":"2026-05-21","values":[3.41314285714286]},{"date":"2026-05-22","values":[3.41742857142857]},{"date":"2026-05-25","values":[3.41]},{"date":"2026-05-26","values":[3.41785714285714]},{"date":"2026-05-27","values":[3.41614285714286]},{"date":"2026-05-28","values":[3.41214285714286]},{"date":"2026-05-29","values":[3.41271428571429]},{"date":"2026-06-01","values":[3.41657142857143]},{"date":"2026-06-02","values":[3.40814285714286]},{"date":"2026-06-03","values":[3.41785714285714]},{"date":"2026-06-04","values":[3.41271428571429]},{"date":"2026-06-05","values":[3.45085714285714]},{"date":"2026-06-08","values":[3.47314285714286]}],"series_names":["Tipo de cambio - TC Interbancario (S/ por US$) - Compra"]},"meta":{"timestamp":"2026-06-10T13:59:19.841Z","request_id":"4733c7d5-b779-44c1-9017-b6ef3ca4c2d9"},"status":"ok","message":"Series 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":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-06-08","source":"BCRP series API (estadisticas.bcrp.gob.pe, live)","service":"bcrp-api","endpoints":{"GET /v1/usd":"Latest official interbank USD/PEN rate (buy, sell, mid).","GET /v1/meta":"This document.","GET /v1/series":"Any BCRP statistical series by code over a range (code=PD04637PD, from=2026-01-01, to=2026-06-09; join up to 10 codes with hyphens).","GET /v1/convert":"Convert between USD and PEN at the interbank mid rate (from=USD, to=PEN, amount=100).","GET /v1/history":"Daily interbank USD/PEN rate over a date range (from=2026-06-01, to=2026-06-09)."},"description":"Live official data for the Peruvian sol (PEN) and the full BCRP statistics database from the Central Reserve Bank of Peru (Banco Central de Reserva del Perú, BCRP), via its public series API. The usd endpoint returns the latest official interbank USD/PEN rate (buy, sell, mid); the history endpoint returns the daily interbank USD/PEN rate over a date range; the convert endpoint converts between USD and PEN at the interbank mid rate; the series endpoint fetches any BCRP statistical series by code (exchange rates, international reserves, interest rates, inflation, monetary aggregates and thousands more) over a date range. Live, no key, nothing stored. Distinct from the ECB, BCRA, BCB and other central-bank feeds and from market mid-rates — this is the BCRP's own published sol rate and economic time-series database.","usd_pen_mid":3.4787,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T13:59:20.189Z","request_id":"37f6c4c0-594d-480f-9681-e8867a123cbe"},"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":600,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":750,"monthly_call_quota":26000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2350,"monthly_call_quota":135000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":5650,"monthly_call_quota":680000,"rps_limit":42,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bcrp-api"}