Skip to content

Realistic backtest fills

Configure a backtest with realistic execution: slippage on market orders, queue simulation for limit orders, and an exported equity curve. Same model in every binding.

1. Configure the simulator

import flox_py as flox

ex = flox.SimulatedExecutor()
ex.set_default_slippage("fixed_bps", bps=1.0)   # 1 bps default
ex.set_queue_model("tob")                       # top-of-book queue
# Per-symbol override:
ex.set_symbol_slippage(eth_usd, "volume_impact", impact_coeff=0.01)

const ex = new flox.SimulatedExecutor();
ex.setDefaultSlippage("fixed_bps", 0, 0, 1.0, 0);    // ticks, tickSize, bps, impactCoeff
ex.setQueueModel("tob", 1);

from flox.backtest import SimulatedExecutor, SLIPPAGE_FIXED_BPS, QUEUE_TOB

ex = SimulatedExecutor()
ex.set_default_slippage(SLIPPAGE_FIXED_BPS, 0, 0.0, 1.0, 0.0)
ex.set_queue_model(QUEUE_TOB, 1)

#include "flox/backtest/backtest_config.h"
#include "flox/backtest/backtest_runner.h"

flox::BacktestConfig cfg;
cfg.initialCapital = 100'000.0;
cfg.feeRate = 0.0002;                                                                 // 2 bps per fill
cfg.defaultSlippage = { flox::SlippageModel::FIXED_BPS, 0, flox::Price{}, 1.0, 0.0 };  // 1 bps default
cfg.queueModel = flox::QueueModel::TOB;
cfg.riskFreeRate = 0.0;
cfg.metricsAnnualizationFactor = 252.0;

flox::BacktestRunner runner(cfg);

cfg.perSymbolSlippage.emplace_back(
    kEthUsd, flox::SlippageProfile{flox::SlippageModel::VOLUME_IMPACT, 0, 0.0, 0.01});

2. Run it

bt = flox.BacktestRunner(reg, fee_rate=0.0002, initial_capital=100_000)
bt.set_strategy(my_strategy)
stats = bt.run_csv("data.csv", "BTCUSDT")

const bt = new flox.BacktestRunner(reg, 0.0002, 100_000);
bt.setStrategy(myStrategy);
const stats = bt.runCsv("data.csv", "BTCUSDT");

runner.setStrategy(&yourStrategy);
auto result = runner.run(*reader);   // reader: replay::IMultiSegmentReader
auto stats  = result.computeStats();

3. Inspect stats

The same fields are returned by every binding (snake_case in Python/Codon, camelCase in Node, BacktestStats struct in C++).

Field Description
total_trades / totalTrades Number of closed trades
net_pnl / netPnl Total P&L net of fees
return_pct / returnPct Total return %
sharpe / sharpeRatio Annualised Sharpe
sortino / sortinoRatio Annualised Sortino
max_drawdown_pct / maxDrawdownPct Worst drawdown
win_rate / winRate Win rate
profit_factor / profitFactor Gross profit / gross loss

4. Export the equity curve

curve = bt.equity_curve()                  # structured numpy array
bt.write_equity_curve_csv("equity.csv")

const curve = bt.equityCurve();
bt.writeEquityCurveCsv("equity.csv");

for (const auto& pt : result.equityCurve()) {
  fmt::print("{},{:.2f},{:.2f}\n", pt.timestampNs, pt.equity, pt.drawdownPct);
}
result.writeEquityCurveCsv("equity.csv");

CSV header: timestamp_ns,equity,drawdown_pct. One row per closed trade.

See also