Indicadores

El conector indicadores sirve los cinco indicadores económicos chilenos de uso diario: UF, dólar observado, euro, IPC (variación mensual, en porcentaje) y UTM. Es un conector de datos de referencia: los valores son idénticos para todas las organizaciones, no hay nada que conectar (sus tools se llaman sin connectionId) y su uso es gratis. Por eso el quickstart parte por aquí: da un dato real de entrada, sin configurar nada.

Las tools leen el almacén de referencia de Connect, refrescado a diario; ninguna consulta una fuente externa en tiempo real (ver «De dónde salen los datos», al final).

El último valor: indicadores.valor.actual

curl -X POST https://connect.emisso.ai/api/v1/tools/indicadores.valor.actual/execute \
  -H "Authorization: Bearer connect_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"input":{"codigo":"UF"}}'

{
  "data": { "codigo": "UF", "fecha": "2026-08-08", "valor": 39487.23, "unidad": "CLP", "antiguedadDias": -1 },
  "meta": { "request_id": "req_...", "tool_id": "indicadores.valor.actual", "plane": "action" }
}

«Último disponible» no es lo mismo que «el de hoy», y antiguedadDias existe para que no tengas que compararlo contra tu propio reloj: son los días entre fecha y hoy en America/Santiago. Cero significa que el valor es de hoy; positivo, que está atrasado esa cantidad de días (la fuente no se ha actualizado); negativo, que está fechado en el futuro, lo que es normal en la UF y la UTM porque se publican por adelantado. En el ejemplo, -1: el valor devuelto es el de mañana. Compáralo contra tu propia tolerancia antes de calcular plata con el número.

El valor a una fecha: indicadores.valor.consultar

curl -X POST https://connect.emisso.ai/api/v1/tools/indicadores.valor.consultar/execute \
  -H "Authorization: Bearer connect_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"input":{"codigo":"DOLAR","fecha":"2026-08-02"}}'

{
  "data": {
    "codigo": "DOLAR",
    "fecha": "2026-07-31",
    "valor": 943.18,
    "unidad": "CLP",
    "fechaSolicitada": "2026-08-02",
    "esArrastre": true
  },
  "meta": { "request_id": "req_...", "tool_id": "indicadores.valor.consultar", "plane": "action" }
}

Esta tool responde con arrastre: si la fecha pedida no tiene dato propio (un fin de semana, un feriado, o una fuente que no se ha actualizado), devuelve el último valor anterior. Por eso fecha puede diferir de fechaSolicitada, y esArrastre te dice cuándo pasó: false significa que ese día tiene dato propio; true, que el valor viene de la fecha devuelta, que es anterior. En el ejemplo, el 2 de agosto de 2026 es domingo y el valor viene arrastrado del viernes. Pedir una fecha futura devuelve el último valor conocido con esArrastre: true, no un error. Un arrastre de un día sobre un fin de semana es normal; uno de tres semanas significa que la fuente está caída.

La serie histórica: indicadores.serie.consultar

curl -X POST https://connect.emisso.ai/api/v1/tools/indicadores.serie.consultar/execute \
  -H "Authorization: Bearer connect_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"input":{"codigo":"UF","desde":"2026-08-01","hasta":"2026-08-03"}}'

{
  "data": {
    "codigo": "UF",
    "unidad": "CLP",
    "valores": [
      { "fecha": "2026-08-01", "valor": 39461.87 },
      { "fecha": "2026-08-02", "valor": 39470.12 },
      { "fecha": "2026-08-03", "valor": 39478.4 }
    ]
  },
  "meta": { "request_id": "req_...", "tool_id": "indicadores.serie.consultar", "plane": "action" }
}

La serie sale en orden ascendente y acotada por limite, con tope duro de 1000 puntos. Los indicadores mensuales (IPC y UTM) traen un punto por mes, normalizado al primer día del mes.

El canal público, sin API key

Para probar sin cuenta, los mismos datos responden en una ruta pública anónima:

curl https://connect.emisso.ai/public/v1/indicadores/UF

{ "data": { "codigo": "UF", "fecha": "2026-08-08", "valor": 39487.23, "unidad": "CLP" } }

curl "https://connect.emisso.ai/public/v1/indicadores/UF/serie?desde=2026-08-01&hasta=2026-08-03"

{
  "data": {
    "codigo": "UF",
    "unidad": "CLP",
    "valores": [
      { "fecha": "2026-08-01", "valor": 39461.87 },
      { "fecha": "2026-08-02", "valor": 39470.12 },
      { "fecha": "2026-08-03", "valor": 39478.4 }
    ]
  }
}

La primera ruta acepta ?fecha=AAAA-MM-DD para el valor a una fecha (con el mismo arrastre); la serie exige desde y hasta, y acepta limite (1 a 1000). El payload es la forma desnuda {codigo, fecha, valor, unidad}: los campos de frescura (antiguedadDias, esArrastre, fechaSolicitada) son de las tools autenticadas.

De dónde salen los datos

Del sitio de estadísticas del Banco Central de Chile (si3.bcentral.cl). Un job programado los refresca una vez al día (a las 12:00 UTC) y guarda solo lo que cambió. El histórico viene de una semilla committeada en el repositorio, cinco años hacia atrás (valores desde 2021); desde ahí el job diario mantiene la serie al día, sin raspar la historia a demanda.

Próximos pasos

• El recorrido completo de la primera llamada, con SDK y MCP: Tu primera llamada.
• Las tres tools y su contrato: referencia de indicadores.
• Cuando necesites datos de una empresa y no de referencia: los sistemas conectables.