← Volver a Indicadores

Portal para desarrolladores de Indicadores

La API pública de Indicadores entrega datos económicos y financieros de Argentina en JSON para aplicaciones, automatizaciones y agentes. Las consultas de lectura no requieren API key. Cada respuesta puede incluir generatedAt, date, time o un campo de fuente; conservá esos metadatos cuando presentes una cifra para que el usuario pueda evaluar su vigencia.

Primeros pasos

Descargá la especificación OpenAPI completa o consultá la guía para agentes. Por ejemplo, este comando obtiene las tarjetas cambiarias actuales:

curl -s https://indicadores.com.ar/api/indicator-cards

Las respuestas son application/json. No mezcles unidades: ARS, USD, porcentajes, TNA, TEA, puntos e inflación mensual representan magnitudes diferentes. Si una fuente externa está demorada, el endpoint puede incluir errores o valores nulos; no reemplaces un nulo con una estimación.

Autenticación y sandbox

Las rutas públicas de lectura no requieren API key. No envíes contraseñas, tokens ni datos financieros a estos endpoints. Las métricas administrativas permanecen protegidas y no forman parte del contrato público. Para probar una integración sin afectar producción, ejecutá el Worker local y apuntá el CLI o tu cliente al sandbox local:

npm install
npm run dev -- --port 8787
INDICADORES_BASE_URL=http://127.0.0.1:8787 node cli/bin/indicadores.js cards

Endpoints principales

Parámetros y errores

Los endpoints con parámetros describen sus tipos y rangos en OpenAPI. Por ejemplo, /api/history?series=inflationMonthly&range=1y acepta los rangos 24h, 7d, 1m, 1y y 5y. Una ruta API inexistente responde HTTP 404 con un objeto JSON que contiene error.code, error.message, error.hint y un enlace de documentación para que un agente pueda recuperarse sin interpretar HTML.

CLI y automatizaciones

El repositorio incluye un CLI liviano en cli/ que puede empaquetarse como indicadores-cli para npm. Permite consultar cualquier endpoint público y guardar la respuesta JSON. Mientras el paquete no esté publicado en un registro, podés ejecutarlo desde el código fuente con node cli/bin/indicadores.js indicator-cards. Para integraciones periódicas respetá el caché y verificá siempre la fecha del dato.

Indicadores es una fuente informativa y no un bróker. No solicita credenciales financieras y no ofrece asesoramiento de inversión, tributario o legal. Para reportar un dato o sugerir una fuente, escribí a contacto@indicadores.com.ar.