รัน backtest (Rust)
Nautilus มี Rust API สำหรับ backtest สองแบบ คือ BacktestEngine (low-level) และ BacktestNode
(high-level พร้อม streaming ข้อมูลจาก catalog) คู่มือนี้ครอบคลุมทั้งสองแบบ
พื้นฐานเรื่องแนวคิดของ backtest, fill model และพฤติกรรมของ matching engine ดูได้ที่คู่มือแนวคิด Backtesting ส่วนการตั้งค่าโปรเจกต์และ feature flag ดูได้ที่คู่มือแนวคิด Rust
Dependency
เพิ่มรายการต่อไปนี้ลงใน Cargo.toml โดย streaming และ nautilus-persistence จำเป็นเฉพาะเมื่อใช้
BacktestNode API แบบ high-level
[dependencies]
nautilus-backtest = { version = "0.66", features = ["streaming"] }
nautilus-execution = "0.66"
nautilus-model = { version = "0.66", features = ["test-support"] }
nautilus-persistence = "0.66"
nautilus-trading = { version = "0.66", features = ["examples"] }
ahash = "0.8"
anyhow = "1"
tempfile = "3"
ustr = "1"ถ้าต้องการใช้แค่ BacktestEngine แบบ low-level ให้ตัด streaming, nautilus-persistence,
tempfile และ ustr ออก
BacktestEngine (low-level API)
API แบบ low-level ให้ควบคุมได้โดยตรง: สร้าง engine เอง เพิ่ม venue และ instrument โหลดข้อมูลไว้ใน memory ลงทะเบียน strategy แล้วสั่งรัน
1. สร้าง engine
use nautilus_backtest::{config::BacktestEngineConfig, engine::BacktestEngine};
let mut engine = BacktestEngine::new(BacktestEngineConfig::default())?;2. เพิ่ม venue
SimulatedVenueConfig ใช้ bon::Builder: ต้องตั้งค่าเฉพาะฟิลด์ที่จำเป็น ส่วนค่าอื่นจะใช้ค่า default
ที่ระบุไว้ในเอกสาร build() จะตรวจสอบความถูกต้องของ config และคืนค่าเป็น ConfigResult จึงต้อง
propagate หรือ unwrap ผลลัพธ์
use nautilus_backtest::config::SimulatedVenueConfig;
use nautilus_execution::models::fee::{FeeModelAny, MakerTakerFeeModel};
use nautilus_model::{
enums::{AccountType, BookType, OmsType},
identifiers::Venue,
types::Money,
};
engine.add_venue(
SimulatedVenueConfig::builder()
.venue(Venue::from("SIM"))
.oms_type(OmsType::Hedging)
.account_type(AccountType::Margin)
.book_type(BookType::L1_MBP)
.starting_balances(vec![Money::from("1_000_000 USD")])
.fee_model(FeeModelAny::MakerTaker(MakerTakerFeeModel::zero()).into())
.build()?,
)?;เปลี่ยนค่า default ใดก็ได้ด้วยการต่อ setter เช่น .reject_stop_orders(false) หรือ
.allow_cash_borrowing(true)
3. เพิ่ม instrument และข้อมูล
use nautilus_model::instruments::{
Instrument, InstrumentAny, stubs::audusd_sim,
};
let instrument = InstrumentAny::CurrencyPair(audusd_sim());
let instrument_id = instrument.id();
engine.add_instrument(&instrument)?;
let quotes = generate_quotes(instrument_id); // Your data loading function
engine.add_data(quotes, None, true, true)?;4. ลงทะเบียน strategy แล้วรัน
use nautilus_model::types::Quantity;
use nautilus_trading::examples::strategies::EmaCross;
let strategy = EmaCross::new(
instrument_id,
Quantity::from("100000"),
10, // fast EMA period
20, // slow EMA period
);
engine.add_strategy(strategy)?;
engine.run(None, None, None, false)?;รันตัวอย่างฉบับเต็ม
cargo run -p nautilus-backtest --features examples --example engine-ema-crossซอร์สโค้ด:
crates/backtest/examples/engine_ema_cross.rs
BacktestNode (high-level API)
API แบบ high-level โหลดข้อมูลจาก ParquetDataCatalog และ stream เข้ามาเป็น chunk ตามขนาดที่กำหนดได้
ต้องเปิด feature streaming ของ nautilus-backtest
1. เขียนข้อมูลลง catalog
use nautilus_model::instruments::{
Instrument, InstrumentAny, stubs::audusd_sim,
};
use nautilus_persistence::backend::parquet::catalog::ParquetDataCatalog;
use tempfile::TempDir;
let instrument = InstrumentAny::CurrencyPair(audusd_sim());
let instrument_id = instrument.id();
let quotes = generate_quotes(instrument_id);
let temp_dir = TempDir::new()?;
let catalog_path = temp_dir.path().to_str()
.context("temp dir path is not valid UTF-8")?
.to_string();
let catalog = ParquetDataCatalog::new(
temp_dir.path(), None, None, None, None,
);
catalog.write_instruments(vec![instrument])?;
catalog.write_to_parquet("es, None, None, None)?;2. ตั้งค่าการรัน
use nautilus_backtest::config::{
BacktestDataConfig, BacktestRunConfig, BacktestVenueConfig, NautilusDataType,
};
use nautilus_model::enums::{AccountType, BookType, OmsType};
let venue_config = BacktestVenueConfig::builder()
.name("SIM")
.oms_type(OmsType::Hedging)
.account_type(AccountType::Margin)
.book_type(BookType::L1_MBP)
.starting_balances(vec!["1_000_000 USD".to_string()])
.build()?;
let data_config = BacktestDataConfig::builder()
.data_type(NautilusDataType::QuoteTick)
.catalog_path(catalog_path)
.instrument_id(instrument_id)
.build()?;
let run_config = BacktestRunConfig::builder()
.id("ema-cross-run".to_string())
.venues(vec![venue_config])
.data(vec![data_config])
.chunk_size(100)
.build()?;3. build เพิ่ม strategy แล้วรัน
use nautilus_backtest::node::BacktestNode;
use nautilus_model::types::Quantity;
use nautilus_trading::examples::strategies::EmaCross;
let mut node = BacktestNode::new(vec![run_config])?;
node.build()?;
let engine = node.get_engine_mut("ema-cross-run")
.context("engine not found for run config ID")?;
let strategy = EmaCross::new(
instrument_id,
Quantity::from("100000"),
10,
20,
);
engine.add_strategy(strategy)?;
node.run()?;รันตัวอย่างฉบับเต็ม
cargo run -p nautilus-backtest --features examples,streaming --example node-ema-crossซอร์สโค้ด:
crates/backtest/examples/node_ema_cross.rs
แปลจาก เอกสาร NautilusTrader © Nautech Systems Pty Ltd และผู้ร่วมพัฒนา เผยแพร่ภายใต้ LGPL-3.0 ฉบับแปลนี้ตัดเนื้อหาเฉพาะ Python ออกและเน้น Rust