create_backtest_sessionwriteOwner-scopedCreate a new backtest session (symbol + timeframe replay with its own starting capital). contractSize defaults from the instrument's broker contract size when omitted (never assume the FX lot of 100000; that breaks index sessions).
| Param | Type | Req. | Description |
|---|---|---|---|
| symbol | string | yes | Instrument symbol, e.g. EURUSD. |
| timeframe | string | yes | One of the stored resolutions: 1, 2, 5, 10, 15, 30, 60, 240, 720, D, W. |
| startTime | number | yes | Replay start time, epoch milliseconds. |
| startingBalance | number | yes | Starting account balance. Must be positive. |
| leverage | number | no | Default 100. |
| spread | number | no | Default 0. |
| contractSize | number | no | Override. Omit to let the server resolve it from the instrument. |
| name | string | no | Optional display name. |
Example prompts
- “Start a new EURUSD backtest on the 1H with $10,000.”
- “Create a backtest session for US500 daily starting today with 50k.”
Example call
{ "name": "create_backtest_session", "arguments": { "symbol": "EURUSD", "timeframe": "60", "startTime": 1700000000000, "startingBalance": 10000 } }