Launch backtests
backtest_runLaunches persisted backtests of a saved strategy across symbols, timeframes, or start-date shifts, returning backtest IDs for status polling.
Instructions
Launches persisted backtests of a saved strategy: one per symbols × timeframes (× shifts), at most 30 per call — a wider fan-out is refused before anything launches. batch {kind:"START_DATE_SHIFT", shifts, shiftWeeks} moves from forward; SYMBOL_MATRIX names the plain fan-out. Returns {backtestIds, batchId}; then call wait {kind:"BACKTEST"}. Every run counts against the daily backtest quotas (per API key and per user). Inside a campaign the period must end before the locked region.
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": {
"strategyId": "<strategyId>",
"from": "<from>",
"to": "<to>"
},
"name": "backtest_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | ISO-8601 instant, or a date `YYYY-MM-DD` read as 00:00 UTC. | |
| from | Yes | ISO-8601 instant, or a date `YYYY-MM-DD` read as 00:00 UTC. Limits: from on or after 2020-01-01, to at most 24 h past now, from before to, at most 500,000 bars per run (422 PERIOD_TOO_EARLY / INVALID_PERIOD / PERIOD_TOO_LONG otherwise). | |
| batch | No | ||
| symbols | No | Defaults to [config.instrument.symbol]. | |
| exchange | No | Defaults to config.market.exchange, then binance. | |
| leverage | No | Futures only. Defaults to config.market.futures.leverage. | |
| marginMode | No | ||
| marketType | No | Defaults to config.market.type. | |
| strategyId | Yes | ||
| timeframes | No | Defaults to [config.instrument.timeframe]. | |
| applyFunding | No | ||
| initialCapital | No | Defaults to 10000. | |
| strategyVersion | No | Pin a past revision; default is the current one. |