Start a campaign (reserve the holdout)
campaign_startStarts a backtest campaign by setting its period and locking a holdout segment; every run and read is refused inside that window until finalization.
Instructions
Declares the period and reserves its tail as a holdout before anything is run. holdoutFrom must leave at least half of [from, to] in-sample. From then on every run and every read whose period reaches [holdoutFrom − embargo, to] is refused with HOLDOUT_LOCKED; embargo = max(maxHoldingBars, 24) bars. Every attempt becomes a ledger row (campaign://{id}/ledger); the holdout is run once, by campaign_finalize. A campaign over a period an earlier campaign already covered inherits its trial count; a holdout another campaign already spent is refused (HOLDOUT_SPENT).
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": {
"name": "<name>",
"symbols": "<symbols>",
"timeframes": "<timeframes>",
"from": "<from>",
"to": "<to>",
"holdoutFrom": "<holdoutFrom>"
},
"name": "campaign_start"
}
}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. | |
| name | Yes | ||
| symbols | Yes | The holdout is run on symbols × timeframes (≤ 30); DSR uses the first pair. | |
| strategyId | No | The strategy the campaign is about, for the ledger header. | |
| timeframes | Yes | ||
| holdoutFrom | Yes | ISO-8601 instant, or a date `YYYY-MM-DD` read as 00:00 UTC. | |
| parentCampaignId | No | Inherit the trial count of this campaign. Detected automatically when the periods overlap. |