# Serie histórica del indicador
> Devuelve la serie de valores de un indicador entre dos fechas (AAAA-MM-DD), en orden ascendente, acotada por 'limite' (tope duro 1000), leída del almacén de referencia global.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID** | `indicadores.serie.consultar` |
| **Nombre MCP** | `indicadores__serie__consultar` |
| **Conector** | `indicadores` |
| **Plano** | `action` |
| **Scope (permiso)** | `indicadores:read` |
| **Auth** | `none` |
| **Versión** | `1` |
| **Sensible** | no |
| **Deprecado** | no |
| **Comportamiento** | readOnly=true, destructive=false, idempotent=true, openWorld=false |
## Entrada [#entrada]
| Campo | Tipo | Requerido | Descripción |
| -------- | ------------------------------------------------- | ------------------- | ------------------------------------------------------- |
| `codigo` | `"UF"` · `"DOLAR"` · `"EURO"` · `"IPC"` · `"UTM"` | sí | Código del indicador económico |
| `desde` | string `^\d{4}-\d{2}-\d{2}$` | sí | Primer día del rango, inclusive, en formato AAAA-MM-DD. |
| `hasta` | string `^\d{4}-\d{2}-\d{2}$` | sí | Último día del rango, inclusive, en formato AAAA-MM-DD. |
| `limite` | entero 1-1000 | no · default `1000` | Máximo de puntos a devolver (tope duro 1000) |
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"
},
"desde": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Primer día del rango, inclusive, en formato AAAA-MM-DD."
},
"hasta": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Último día del rango, inclusive, en formato AAAA-MM-DD."
},
"limite": {
"default": 1000,
"description": "Máximo de puntos a devolver (tope duro 1000)",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"required": [
"codigo",
"desde",
"hasta"
]
}
```
## Ejemplo [#ejemplo]
```bash title="curl"
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"}}'
```
```ts title="SDK TypeScript"
const data = await connect.tools.indicadores.serie.consultar({ codigo: "UF", desde: "2026-08-01", hasta: "2026-08-03" });
```
```json title="MCP · meta-tool execute"
{
"tool": "indicadores.serie.consultar",
"params": {
"codigo": "UF",
"desde": "2026-08-01",
"hasta": "2026-08-03"
}
}
```
**Salida esperada (200):**
```json
{
"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",
"latency_ms": 24,
"audit_status": "recorded"
}
}
```
## Salida [#salida]
| Campo | Tipo | Requerido | Descripción |
| ----------------- | --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `codigo` | string | sí | Eco del código del indicador al que corresponde este valor. |
| `unidad` | string | sí | En qué unidad está expresada la serie. 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. Cuando 'valores' llega vacío este campo es la cadena vacía, porque la unidad se toma del primer punto. |
| `valores` | lista de objeto | sí | Los puntos de la serie dentro del rango, en orden ascendente por fecha. Solo trae los días que tienen dato propio: esta tool no arrastra, a diferencia de 'indicadores.valor.consultar', así que un rango con fines de semana devuelve menos puntos que días pedidos. Puede venir recortada por 'limite'. |
| `valores[].fecha` | string | sí | El día de este punto, en formato AAAA-MM-DD. |
| `valores[].valor` | número | sí | El valor de ese día, en la unidad que dice 'unidad'. |
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."
},
"unidad": {
"type": "string",
"description": "En qué unidad está expresada la serie. 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. Cuando 'valores' llega vacío este campo es la cadena vacía, porque la unidad se toma del primer punto."
},
"valores": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fecha": {
"type": "string",
"description": "El día de este punto, en formato AAAA-MM-DD."
},
"valor": {
"type": "number",
"description": "El valor de ese día, en la unidad que dice 'unidad'."
}
},
"required": [
"fecha",
"valor"
],
"additionalProperties": false
},
"description": "Los puntos de la serie dentro del rango, en orden ascendente por fecha. Solo trae los días que tienen dato propio: esta tool no arrastra, a diferencia de 'indicadores.valor.consultar', así que un rango con fines de semana devuelve menos puntos que días pedidos. Puede venir recortada por 'limite'."
}
},
"required": [
"codigo",
"unidad",
"valores"
],
"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).