Tipo de cambio

Consulta el tipo de cambio oficial USD/PEN reportado por SUNAT, basado en el cierre publicado por la SBS.

URL

GET /api/tipo-cambio?fecha=YYYY-MM-DD

Parámetros

Parámetro Tipo Descripción
fecha string (opcional) Formato YYYY-MM-DD. Por defecto, fecha actual.

Fuente

Los datos provienen del scraper oficial de SUNAT, que a su vez replica el cierre diario publicado por la SBS. Si la fecha solicitada es futura, la API responde con los valores de hoy y un aviso indicando que la cotización oficial aún no está disponible.

Ejemplo de request

curl -X GET "https://apisperu.gsalinas.site/api/tipo-cambio?fecha=2026-05-20" \
  -H "Authorization: Bearer apk_demo_apisperu_pub_2BfHK7nN4tV9X8jE3LpQ5sUcZ"

Ejemplo de response

{
  "ok": true,
  "data": {
    "fecha": "2026-05-20",
    "compra": 3.685,
    "venta": 3.692,
    "moneda": "USD/PEN"
  },
  "proveedor": "sunat-tc"
}

Response con fecha futura

{
  "ok": true,
  "data": {
    "fecha": "2026-05-21",
    "compra": 3.690,
    "venta": 3.697,
    "moneda": "USD/PEN"
  },
  "aviso": "Fecha futura solicitada; se devuelve cotización del día actual.",
  "proveedor": "sunat-tc"
}

Campos del response

Campo Tipo Descripción
fecha string Fecha consultada en formato YYYY-MM-DD.
compra number Tipo de cambio compra (PEN por USD).
venta number Tipo de cambio venta (PEN por USD).
moneda string Par de monedas (por defecto USD/PEN).

Errores específicos

Probar en el playground