Envía una fecha válida
El endpoint requiere fecha con formato AAAA-MM-DD. Comprueba que sea un día del calendario, además de validar el formato: una cadena como 2026-02-30 no es una fecha válida. La API rechaza entradas inválidas antes de consultar.
Recibirás moneda, fecha, compra y venta cuando estén disponibles. La fecha de la respuesta proviene del dato publicado por la fuente; compárala con la fecha que necesitas y decide cómo gestionar días sin publicación. No rellenes silenciosamente el resultado con el valor cero.
Integra sin confundir compra y venta
Elige explícitamente qué campo utiliza tu proceso. Compra y venta no son intercambiables; conserva también moneda y fecha junto con el valor seleccionado para que el resultado sea trazable. Evita convertir una respuesta HTTP exitosa en una recomendación financiera.
DatosPerú consulta la información a través de su proveedor JSON.pe. No promete una cotización de mercado en tiempo real ni ejecuta operaciones de cambio. La API de comisiones AFP es una consulta diferente, con un periodo mensual como entrada.
Errores y consumo
Una consulta exitosa consume un crédito. Ante un error de fuente, muestra que el valor no está disponible y permite reintentar de forma controlada. Evita reintentos simultáneos o continuos cuando se alcanza el límite de tu plan.
Preguntas frecuentes
¿La fecha se envía como texto?
Sí, utiliza una cadena con formato AAAA-MM-DD.
¿Puedo obtener las comisiones AFP?
Sí, con el endpoint /api/v1/afp y un periodo AAAA-MM. Es una operación separada.