---
title: "Valor actual del indicador"
method: POST
path: "/v1/tools/indicadores.valor.actual/execute"
tags: ["indicadores"]
---

# Valor actual del indicador

`POST /v1/tools/indicadores.valor.actual/execute`

## Request

- Base URL: `https://connect.emisso.ai/api`
- URL: `https://connect.emisso.ai/api/v1/tools/indicadores.valor.actual/execute`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://connect.emisso.ai/authorize`, token URL `https://connect.emisso.ai/token`, scopes: `indicadores:read`)

Devuelve el ÚLTIMO valor disponible de un indicador económico chileno (UF, DÓLAR, EURO, IPC, UTM), leído del almacén de referencia global; no consulta fuentes externas en tiempo real. 'último disponible' NO es lo mismo que 'el de hoy', y hay que mirar 'fecha' antes de usar el número: la UF y la UTM se publican por ADELANTADO, así que su fecha puede ser futura; y si la ingesta se atrasa, la fecha queda en el pasado. 'antiguedadDias' resuelve las dos de una vez: 0 = es el de hoy, positivo = días transcurridos desde esa fecha, negativo = está fechado en el futuro. Un positivo NO significa por sí solo que la fuente esté caída: en el IPC y la UTM, que son MENSUALES, es lo normal. Lee la descripción de 'antiguedadDias' antes de concluir nada.

## Request body

- object
  - `input` IndicadoresValorActualInput, required
    - `codigo` 'UF' | 'DOLAR' | 'EURO' | 'IPC' | 'UTM', required: Código del indicador económico

## Response `200`

La tool corrió bien. 'data' es la salida de la tool tal cual, y 'meta' trae el 'request_id' que identifica esta llamada en la bitácora.

- object
  - `data` IndicadoresValorActualOutput, required
    - `codigo` string, required: Eco del código del indicador al que corresponde este valor.
    - `fecha` string, required: La fecha del valor devuelto. Puede ser futura (UF/UTM se publican por adelantado) o pasada (ingesta atrasada).
    - `valor` number, required: El valor del indicador en esa fecha, en la unidad que dice 'unidad'.
    - `unidad` string, required: En qué unidad está expresado el valor. UF, DOLAR, EURO y UTM vienen en pesos chilenos ('CLP'); el IPC viene en 'pct', porque es la variación mensual en por ciento y no un monto. Lee este campo antes de tratar el número como plata.
    - `antiguedadDias` integer, required: Días entre 'fecha' y hoy en America/Santiago. 0 = el valor es de hoy; NEGATIVO = está fechado en el futuro, normal en UF y UTM que se publican por adelantado. El POSITIVO se lee según la FRECUENCIA del indicador, y confundirlas hace reportar caída una fuente sana: en los DIARIOS (UF, DOLAR, EURO) un positivo que se estira más allá de un fin de semana o un feriado sí significa que la ingesta dejó de correr; en los MENSUALES (IPC, UTM), que se fechan el día 1 del mes que miden, el número crece un día por día y eso es lo ESPERADO: la UTM llega a ~31 antes de que salga la del mes siguiente, y el IPC suma encima su rezago de publicación (el dato de un mes se publica a comienzos del siguiente), así que su normal llega a los dos meses. Medido el 2026-09-01, el IPC devolvió 62 con el dato de julio y la fuente al día. Compáralo contra tu propia tolerancia POR FRECUENCIA antes de calcular plata con este número.
  - `meta` ResponseMeta
    - `request_id` string, required: Identificador que el servidor le da a esta llamada (req_…). Correlaciona con la fila de la bitácora y es lo primero que pide soporte: guárdalo en tus logs.
    - `operation_request_id` string, uuid: Identidad del intento e-Boleta original. Se conserva al reproducir el resultado del journal; request_id identifica la llamada actual.
    - `tool_id` string, required: La tool que se ejecutó, con su id punteado.
    - `plane` 'action' | 'read', required: 'read' = la llamada escribió en el plano persistido (un sync). 'action' = efímera, no persistió nada de negocio: actuar afuera, o leer lo que un sync ya dejó.
    - `latency_ms` integer, required: Cuánto tardó la ejecución, en milisegundos.
    - `audit_status` 'recorded' | 'degraded', required: 'recorded' = la bitácora recibió la fila de esta llamada. 'degraded' = la acción se hizo pero el registro cayó a un respaldo duradero. Nunca convierte una acción exitosa en un error, porque reintentar por eso sería pagar o emitir dos veces.
    - `idempotency` 'replayed': Presente solo cuando una tool destructiva devolvió la respuesta guardada de un intento previo con la misma Idempotency-Key. Significa que en ESTA llamada no ocurrió ningún efecto nuevo.

## Other responses

- `400`: validation_error (400)
- `401`: unauthorized (401)
- `403`: scope_not_granted | connection_scope_not_enabled | alcance_not_enabled
- `404`: tool_not_found (404)
- `409`: connection_ambiguous | connection_busy
- `428`: connection_credential_required (428)
- `500`: internal_error (500)

---

[API](https://skmtc.dev/emisso/apis/emisso-connect-api.md) · [All operations](https://skmtc.dev/emisso/apis/emisso-connect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emisso/apis/emisso-connect-api/revisions/e766c01ef2a0?raw)