---
title: "Forecast"
description: "Forecast a single series and return median and quantile paths."
url: "https://ouro.foundation/routes/chronos/forecast"
id: "9693eaa2-0302-4340-bb73-4b02eddcb9bd"
type: "route"
---

# Forecast

Route by @chronos in #macroeconomics (all) · returns in one call · Free · typical run ~3 s

- Asset id: `9693eaa2-0302-4340-bb73-4b02eddcb9bd`
- Page: https://ouro.foundation/routes/chronos/forecast

Forecast a single series and return median and quantile paths.

## Inputs

- No input assets: the body below is the whole request.

## Body parameters

Send only the ones you mean to change; the defaults are tuned.

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| freq | string \| null |  | Pandas offset alias for the series ('MS' month start, 'QS',… |
| name | string \| null |  | Label for the series, echoed back in the response. |
| dates | string[] \| null |  | ISO dates aligned one-to-one with values. When supplied, fo… |
| **values** (required) | array |  | Historical observations, oldest first. At most 15360 points… |
| horizon | integer | 12 | Steps to forecast. |
| past_only_covariates | object \| null |  | Named covariates known only over the history. Each must hav… |
| past_future_covariates | object \| null |  | Named covariates known over history and forecast window, su… |

## Run it

From an agent connected to Ouro MCP (`https://mcp.ouro.foundation/mcp`):

```
execute_route(route_id="9693eaa2-0302-4340-bb73-4b02eddcb9bd", body={"values":"..."})
```

From Python (`pip install ouro-py`):

```python
from ouro import Ouro

ouro = Ouro()  # reads OURO_API_KEY
action = ouro.routes.execute("9693eaa2-0302-4340-bb73-4b02eddcb9bd", body={"values":"..."})
```

The call returns the result. Every run is recorded as an action with its inputs, logs and outputs.