API de Datos Oficiales Peruanos
El EKIA Data Service es la API de solo lectura de Eurekia sobre datos
oficiales del Perú, con evidencia verificable en cada dato. Dominios: el
tipo de cambio (series publicado y cierre, con
cotejo diario entre ambas), la consulta RUC (el padrón
reducido diario de SUNAT, con historia) y el calendario de
feriados nacionales. URL base: https://api.eurekia.pe.
Servicio en desarrollo, sin acceso público por ahora. Esta documentación se publica como material técnico: describe el contrato tal como está desplegado, sin credenciales ni vía de acceso (Empezar).
Por qué es distinta
La mayoría de APIs de datos entrega un número. Esta entrega observaciones con evidencia:
- Cada dato es una observación inmutable. Queda registrado qué publicó la fuente, cuándo se observó y con qué bytes exactos. Una corrección nunca edita el pasado: en el tipo de cambio crea una observación nueva que supersede a la anterior; en el padrón, una transición más. Todo sigue consultable con su historia.
- La evidencia se puede verificar. Los bytes crudos que la fuente
respondió se descargan por la API y su SHA-256 se comprueba con
sha256sumen su propia máquina — hágalo ahora, toma 60 segundos. - El registro está versionado por revisiones. Con
as_of_revisionse consulta qué contenía en cualquier punto del pasado — y la respuesta es siempre la misma, ideal para auditoría. - Sin relleno. Si una fecha no tiene dato, la API lo dice con la razón del hueco — nunca le entrega otra fecha como si fuera la pedida.
La plataforma
- Empezar — el estado del servicio, la autenticación y su primer request en cada dominio, con la respuesta real.
- Verifique la evidencia en 60 segundos — cuatro pasos: dato → observación → metadatos de la evidencia → hash comprobado.
- El modelo de evidencia — observaciones, revisiones, transiciones, controles de integridad, evidencia y la tabla completa de estados.
- Errores y límites — la tabla completa de códigos, límites de uso, cuota de descarga, paginación, caché, alertas y salud.
- Qué no hacemos — los límites del servicio, declarados.
- Registro de cambios — todo cambio del contrato de la API, fechado.
- Referencia de la API — los endpoints de la v1 por servicio, con ejemplos reales.
Los servicios
Cada página de servicio responde las mismas ocho preguntas, en el mismo orden: qué es y qué no · cobertura · frescura · consulta histórica · integridad · evidencia · restricciones y límites · qué guardar.
- Tipo de cambio — series
publicado(SUNAT) ycierre(SBS vía BCRP) desde el 2026-08-21, cotejo diario, y la guía "Publicado vs cierre: qué serie usar". - Consulta RUC — el padrón reducido diario de SUNAT desde el 2026-09-03 con historia por transiciones, cobertura declarada, confiabilidad verificada y el ZIP original descargable por sha256; nace restringido para personas naturales hasta el dictamen legal.
- Calendario — los feriados nacionales del calendario formal del servicio, con su norma legal; público, sin token; parte del servicio en desarrollo.
Para agentes y herramientas
El índice está en /llms.txt, cada página tiene su espejo Markdown
(misma URL con extensión .md) y el esquema OpenAPI crudo vive en la URL
estable https://docs.eurekia.pe/openapi.json.
Esta documentación describe únicamente capacidades que el servicio ya presta. Roadmap: histórico profundo del cierre (backfill) y, después, otros dominios de datos oficiales — se documentarán aquí cuando existan.