runs

Start Run

Start a new simulation run.

post/api/runs

Request body

run_mode'backtest' | 'live' | 'alpaca_paper' | 'alpaca_live'

'backtest' runs historical data instantly; 'live' schedules real-time simulated paper trading; 'alpaca_paper'/'alpaca_live' use Alpaca broker

simulation_datestring date nullable

Date to simulate trading for (single day mode)

start_datestring date nullable

Start date for multi-day simulation

end_datestring date nullable

End date for multi-day simulation

max_concurrent_daysinteger

Max concurrent day simulations for multi-day mode

initial_cash_balancenumber

Actual cash deposited in brokerage (per day for multi-day)

leverage_multipliernumber

Intraday margin multiplier (e.g. 4x)

tickersstring[]

List of ticker symbols to trade

llm_providersstring[]

LLM provider(s) to use. Multiple providers run in parallel for comparison.

qwen_baseline_addressstring nullable

host:port for Qwen Baseline vLLM server (required if qwen-baseline selected)

qwen_trading_rl_addressstring nullable

host:port for Qwen Trading RL vLLM server (required if qwen-trading-rl selected)

deepseek_addressstring nullable

host:port for DeepSeek vLLM server (required if deepseek selected)

broker_account_idstring nullable

ID of the BrokerAccount to use (required for alpaca_paper/alpaca_live modes)

stop_loss_pctnumber nullable

Stop loss as % of initial cash. Liquidates all positions when breached. None or 0 to disable.

best_of_n_enabledboolean

Enable Best of N mode - run LLM N times and judge to select best response

n_candidatesinteger

Number of candidate responses to generate in Best of N mode

analysis_interval_minutesinteger

Minutes between analysis steps

market_openstring time

Market open time (first LLM decision step)

market_closestring time

Session force-close cutoff (prompt mandate/countdown render from this)

Successful Response

runsobject required

Map of LLM provider to run ID

No recorded changes to this endpoint across all 1 revision of this API.