run_forecast
Run a forecast now. Reserves AI credits up front, dispatches the backtest + projection + correlation pipeline, and returns either the completed result inline (wait_seconds > 0 and the run finishes in time) or a run_id you can poll with get_forecast_run.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"forecast_id": "<forecast_id>"
},
"name": "run_forecast"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| forecast_id | Yes | ||
| wait_seconds | No | Seconds to wait for the run to finish before returning a poll handle. 0 = return immediately with the run_id. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No | Present when status reaches "completed". | |
| run_id | Yes | ||
| status | Yes | pending while queued, running mid-execution, completed/failed/refunded when terminal. | |
| poll_tool | No | Tool to poll if the run is still running ("get_forecast_run"). | |
| credits_consumed | No | ||
| credits_refunded | No | ||
| credits_reserved | No |