# Valor del indicador a una fecha
> Devuelve el valor de un indicador vigente a una fecha dada (AAAA-MM-DD) CON ARRASTRE: si esa fecha no tiene dato propio (un fin de semana, un feriado, o una fuente que no se ha actualizado) devuelve el último valor anterior.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID** | `indicadores.valor.consultar` |
| **Nombre MCP** | `indicadores__valor__consultar` |
| **Conector** | `indicadores` |
| **Plano** | `action` |
| **Scope (permiso)** | `indicadores:read` |
| **Auth** | `none` |
| **Versión** | `2` |
| **Sensible** | no |
| **Deprecado** | no |
| **Comportamiento** | readOnly=true, destructive=false, idempotent=true, openWorld=false |
## Qué hace [#qué-hace]
La 'fecha' de la respuesta puede ser DISTINTA de la solicitada, y 'esArrastre' lo marca: false = ese día tiene dato propio; true = el valor corresponde a la 'fecha' devuelta, que es anterior. Pedir una fecha futura devuelve el último valor conocido con 'esArrastre: true', no un error. Todo se lee del almacén de referencia global.
## Entrada [#entrada]
| Campo | Tipo | Requerido | Descripción |
| -------- | ------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `codigo` | `"UF"` · `"DOLAR"` · `"EURO"` · `"IPC"` · `"UTM"` | sí | Código del indicador económico |
| `fecha` | string `^\d{4}-\d{2}-\d{2}$` | sí | La fecha a la que quieres el valor vigente, en formato AAAA-MM-DD. Si ese día no tiene dato propio se arrastra el último anterior, así que pedir un fin de semana o una fecha futura responde 200 con 'esArrastre' en true, nunca un error. |
JSON Schema de entrada
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"codigo": {
"type": "string",
"enum": [
"UF",
"DOLAR",
"EURO",
"IPC",
"UTM"
],
"description": "Código del indicador económico"
},
"fecha": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "La fecha a la que quieres el valor vigente, en formato AAAA-MM-DD. Si ese día no tiene dato propio se arrastra el último anterior, así que pedir un fin de semana o una fecha futura responde 200 con 'esArrastre' en true, nunca un error."
}
},
"required": [
"codigo",
"fecha"
]
}
```
## Ejemplo [#ejemplo]
```bash title="curl"
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"}}'
```
```ts title="SDK TypeScript"
const data = await connect.tools.indicadores.valor.consultar({ codigo: "DOLAR", fecha: "2026-08-02" });
```
```json title="MCP · meta-tool execute"
{
"tool": "indicadores.valor.consultar",
"params": {
"codigo": "DOLAR",
"fecha": "2026-08-02"
}
}
```
**Salida esperada (200):**
```json
{
"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",
"latency_ms": 24,
"audit_status": "recorded"
}
}
```
> El 2 de agosto de 2026 es domingo: no hay dato propio y el valor viene arrastrado del viernes anterior.
## Salida [#salida]
| Campo | Tipo | Requerido | Descripción |
| ----------------- | -------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `codigo` | string | sí | Eco del código del indicador al que corresponde este valor. |
| `fecha` | string | sí | La fecha del valor DEVUELTO. Si 'esArrastre' es true, es anterior a 'fechaSolicitada'. |
| `valor` | número | sí | El valor del indicador vigente a esa fecha, en la unidad que dice 'unidad'. |
| `unidad` | string | sí | 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. |
| `fechaSolicitada` | string | sí | Eco de la fecha que pediste, para poder compararla sin guardarla tú. |
| `esArrastre` | booleano | sí | true = la fecha pedida NO tiene dato propio y este valor viene de una fecha anterior ('fecha'). false = es el valor de esa fecha exacta. Míralo antes de usar el número: un arrastre de un día sobre un fin de semana es normal, uno de tres semanas significa que la fuente está caída. |
JSON Schema de salida
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"codigo": {
"type": "string",
"description": "Eco del código del indicador al que corresponde este valor."
},
"fecha": {
"type": "string",
"description": "La fecha del valor DEVUELTO. Si 'esArrastre' es true, es anterior a 'fechaSolicitada'."
},
"valor": {
"type": "number",
"description": "El valor del indicador vigente a esa fecha, en la unidad que dice 'unidad'."
},
"unidad": {
"type": "string",
"description": "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."
},
"fechaSolicitada": {
"type": "string",
"description": "Eco de la fecha que pediste, para poder compararla sin guardarla tú."
},
"esArrastre": {
"type": "boolean",
"description": "true = la fecha pedida NO tiene dato propio y este valor viene de una fecha anterior ('fecha'). false = es el valor de esa fecha exacta. Míralo antes de usar el número: un arrastre de un día sobre un fin de semana es normal, uno de tres semanas significa que la fuente está caída."
}
},
"required": [
"codigo",
"fecha",
"valor",
"unidad",
"fechaSolicitada",
"esArrastre"
],
"additionalProperties": false
}
```
## Errores de esta tool [#errores-de-esta-tool]
Toda llamada puede devolver además los códigos transversales (`validation_error`, `unauthorized`, `scope_not_granted`, `rate_limited`, entre otros): el detalle vive en el [catálogo de errores](../errores).