Documentación API

Consulta conjuntos de datos y observaciones con sus fechas originales mediante una clave API.

Autenticación y acceso

Envía la clave mediante X-API-Key por HTTPS. Los tokens de sesión y las claves de ingesta no sirven para esta API. No incluyas claves en URL ni las publiques.

Las suscripciones aún no están a la venta. La evaluación es por invitación y no se cobra.

Conjuntos de datos y observaciones

Consulta primero el catálogo y usa un identificador devuelto. Los precios requieren frequency, startDate y endDate; los pedidos, startPeriod y endPeriod en formato mensual o anual original.

Se conservan unidades, monedas, regiones, frecuencias y bases originales. No hay interpolación, precios simulados ni conversión automática de divisas.

Usa limit (1–1.000) y nextAfter como el siguiente after, sin cambiar filtros. El cursor es exclusivo; una respuesta vacía no equivale a precio cero.

Uso y errores

Las consultas autenticadas admitidas cuentan, incluso con error. Las filas y observaciones devueltas consumen registros. Las claves comparten cuotas, reiniciadas al inicio del mes UTC.

400: parámetros; 401: clave; 403: acceso inactivo; 404: sin conjunto publicado; 429: límite; 503: evaluación desactivada. Retry-After de 60 s es la espera mínima, no un reinicio de cuota mensual.

Solo consultas GET. No ejecuta operaciones, recomienda inversiones ni expone cuentas, borradores o registros administrativos.

GET /api/v1/datasets?limit=100 GET /api/v1/prices/{id}/observations?frequency=daily&startDate=2026-01-01&endDate=2026-01-31 GET /api/v1/ship-orders/{id}/observations?startPeriod=2025-01&endPeriod=2025-12 X-API-Key: YOUR_API_KEY

[email protected]