Skip to content

start-live-session


command start-live-session

Start a WebSocket-backed simulated session from a configuration file.

Reads a live-session configuration from a .toml, .yaml/.yml, or .json file, connects to the selected public exchange WebSocket, and feeds normalized candles into a local Session. The command runs until interrupted with Ctrl+C; no real orders are submitted. Session state and replayable events are saved to the same history used by the application.

Read more in the live-session guide.

Parameters

config : Path

Path to a live-session configuration. Top-level fields are provider, symbols, interval, optional saved strategy, batch_size, and timeout_seconds. Put SessionConfig fields under session.

--log_level, -l : str, default="warn"
Minimum log level to emit. Choose from: error, warn, info or debug.


See Also

LiveMarketFeed

Reusable, cancellable exchange market-data collector.

Session

A stateful simulated account with optional strategy evaluation.

Experiment

Configure and run one historical backtest experiment.


Example

Create live.toml:

provider = "kraken"
symbols = ["BTC-USD"]
interval = "1m"
strategy = "my-saved-strategy"

[session]
initial_cash = 25000
commission_pct = 0.1
slippage = 0.05

Start the session and press Ctrl+C to stop it:

backtide start-live-session live.toml