Beta privada · apertura 23 de diciembre
Consulta el tipo de cambio
GET /v1/tipo-cambio
Compra y venta oficiales del dólar para una fecha, según el BCRP. Sin fecha, el de hoy en Lima.
| Dato | Valor |
|---|---|
| Permiso | datos:leer |
| Cobro | Lectura medida: cuenta contra tu cupo gratis o tu saldo, y puede dar 402. |
Idempotency-Key |
No aplica |
| Herramienta MCP | tipo_cambio_consultar (Próximamente) |
Parámetros
Sección titulada «Parámetros»| Nombre | En | Requerido | Tipo | Descripción |
|---|---|---|---|---|
fecha |
query | No | string | Día que quieres; si no lo envías, hoy en Lima. |
X-Request-Id |
header | No | string | Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte. |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl "https://api-sandbox.opennexum.com/v1/tipo-cambio" \ -H "Authorization: Bearer onx_test_…"Respuestas
Sección titulada «Respuestas»Tipo de cambio.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
fecha |
string (date) | Sí | El día que pediste. |
publicado_el |
string (date) | Sí | Día de la publicación usada; en feriados y fines de semana, la última anterior. |
moneda |
“USD” | Sí | |
compra |
string | Sí | Soles por dólar, con tres decimales. |
venta |
string | Sí | Soles por dólar, con tres decimales. |
fuente |
“BCRP” | Sí | Fuente oficial del dato. |
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 400
validacion - 401
clave_invalida - 402
saldo_insuficiente - 402
tope_alcanzado - 403
permiso_faltante - 404
no_encontrado - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible