NautilusTrader Docs · ภาษาไทย
Deep Dive: ลงมือสร้างระบบจริง

ไปสู่ live: Bybit testnet

นำ strategy เดียวกันไปรันกับ exchange จริงบน testnet: dependency, credential, reconciliation และการหยุด node อย่างปลอดภัย

strategy ในบทนี้ไม่มีโค้ดส่วนไหนที่รู้ว่ากำลังรันใน backtest หรือ live ทุกอย่างที่ต่างกันอยู่ในส่วนประกอบระบบ (backtest.rs กับ bin/live.rs) หน้านี้นำชุด component จากหน้า Integration คือ BandSignalActor, SignalExecutor และ FillExporter ไปรันบน Bybit testnet กับ USDT linear perpetual (MeanReversion แบบตัวเดียวก็ใช้แทนได้ด้วย node.add_strategy(..) บรรทัดเดียว เพราะผ่าน test ว่าให้ผลเท่ากัน)

สถานะของโค้ดในหน้านี้

src/bin/live.rs compile ผ่านกับ NautilusTrader commit 04f766b4 แต่ไม่ได้รันกับ exchange ระหว่างเขียนบทนี้ เพราะต้องใช้ API key ของ testnet ก่อนใช้ให้รันบน testnet เองจนมั่นใจ และอ่าน log ทุกบรรทัดในรอบแรก

อะไรเปลี่ยนเมื่อไป live

เรื่องBacktestLive
instrumentสร้างเองแล้ว add_instrumentadapter โหลดจาก exchange ตอนเชื่อมต่อ
ข้อมูลป้อนล่วงหน้าทั้งหมดstream ผ่าน WebSocket ตามเวลาจริง
fillfill model จำลองexchange จริง มีคิว, partial fill และ latency
นาฬิกาเดินตามเวลาของข้อมูลนาฬิกาจริง timer ใน on_start ก็ทำงานตามเวลาจริง
state ตอนเริ่มว่างเปล่าเสมออาจมี order และ position ค้างจากรอบก่อน จึงต้อง reconcile
errorหยุดทั้งการรันnetwork หลุด, API rate limit, exchange ปิดปรับปรุง

Dependency

nautilus-bybit = { git = "https://github.com/nautechsystems/nautilus_trader", rev = "04f766b4d434d67fc8672026fefa25135bdc01be", default-features = false, optional = true }
nautilus-live = { git = "https://github.com/nautechsystems/nautilus_trader", rev = "04f766b4d434d67fc8672026fefa25135bdc01be", default-features = false, features = ["node"], optional = true }
tokio = { version = "1", features = ["macros", "rt-multi-thread"], optional = true }
  • default-features = false บน nautilus-bybit ปิด high-precision ที่ adapter เปิดไว้โดย default ถ้าเปิดไว้ flag จะลามไปทั้ง dependency graph และเปลี่ยนชนิดข้อมูลภายในของ Price/Quantity ในส่วน backtest ด้วย ถ้าตั้งใจจะใช้ high-precision ให้เปิดที่ nautilus-model โดยตรงเพื่อให้เห็นชัดใน Cargo.toml
  • nautilus-live ต้องเปิด feature node เพื่อใช้ LiveNode
  • live node ทำงานบน tokio จึงต้องมี tokio ที่เปิด macros และ rt-multi-thread

Credential

adapter อ่าน API key จาก environment variable ตาม environment ที่เลือก:

BybitEnvironmentAPI keyAPI secret
TestnetBYBIT_TESTNET_API_KEYBYBIT_TESTNET_API_SECRET
DemoBYBIT_DEMO_API_KEYBYBIT_DEMO_API_SECRET
MainnetBYBIT_API_KEYBYBIT_API_SECRET

การแยกชื่อตัวแปรตาม environment ช่วยกันพลาดได้ดี key ของ mainnet จะไม่ถูกใช้ตอนตั้งค่าเป็น testnet ถ้ากรอก api_key/api_secret ใน config เป็น None adapter จะอ่านจาก environment ให้เอง ห้ามเขียน key ลงในโค้ด

export BYBIT_TESTNET_API_KEY=...
export BYBIT_TESTNET_API_SECRET=...
cargo run --release --features live --bin live

สร้าง API key ของ testnet ได้ที่เว็บไซต์ testnet ของ Bybit ซึ่งแยกบัญชีจาก mainnet และใช้เงินทดสอบ

ประกอบ node

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let environment = BybitEnvironment::Testnet;
    let instrument_id = InstrumentId::from("BTCUSDT-LINEAR.BYBIT");

    let data_config = BybitDataClientConfig {
        environment,
        api_key: None,    // read from BYBIT_TESTNET_API_KEY
        api_secret: None, // read from BYBIT_TESTNET_API_SECRET
        product_types: vec![BybitProductType::Linear],
        ..Default::default()
    };
    let exec_config = BybitExecutionClientConfig {
        environment,
        api_key: None,
        api_secret: None,
        product_types: vec![BybitProductType::Linear],
        account_id: Some(AccountId::from("BYBIT-001")),
        ..Default::default()
    };
    // Re-check open orders and positions against the venue while running.
    let exec_engine_config = LiveExecutionEngineConfig {
        open_check_interval_secs: Some(10.0),
        position_check_interval_secs: Some(30.0),
        ..Default::default()
    };

    let mut node = LiveNode::builder(TraderId::from("TRADER-001"), Environment::Live)?
        .with_name("MEANREV-NODE".to_string())
        .with_exec_engine_config(exec_engine_config)
        .add_data_client(
            None,
            Box::new(BybitDataClientFactory::new()),
            Box::new(data_config),
        )?
        .add_exec_client(
            None,
            Box::new(BybitExecutionClientFactory::new()),
            Box::new(exec_config),
        )?
        .with_reconciliation(true)
        .with_delay_post_stop_secs(5)
        .build()?;

    let bar_type = BarType::from("BTCUSDT-LINEAR.BYBIT-1-MINUTE-LAST-EXTERNAL");
    node.add_actor(BandSignalActor::new(
        "BAND-SIGNAL-001",
        instrument_id,
        bar_type,
        20,  // Bollinger period
        2.0, // Bollinger k
        14,  // ATR period
        1.5, // stop distance in ATRs
        1.0, // minimum reward in ATRs
    ))?;
    node.add_strategy(SignalExecutor::new(SignalExecutorConfig {
        strategy_id: StrategyId::from("EXECUTOR-001"),
        order_id_tag: "001".to_string(),
        instrument_id,
        risk: RiskSettings {
            risk_fraction: 0.001,
            max_notional: 200.0, // USDT; keep testnet orders small
        },
        cooldown_mins: 30,
    }))?;

    let (fill_sink, writer) = spawn_jsonl_writer("fills.jsonl".as_ref(), 10_000)?;
    node.add_actor(FillExporter::new("FILL-EXPORTER-001", fill_sink))?;

    node.run().await?;

    // Disposing retires the exporter and drops its sender, which lets the writer
    // thread finish. Dropping the node is not enough.
    node.dispose();
    let lines = writer.join().expect("writer thread panicked")?;
    log::info!("Wrote {lines} fills to fills.jsonl");
    Ok(())
}

จุดที่ควรสังเกต:

  • instrument ID ของ Bybit มีประเภทสินค้าต่อท้าย BTCUSDT-LINEAR.BYBIT คือ perpetual แบบ USDT-margined ส่วน bar type ใช้ LAST ซึ่งตรงกับ kline ของ exchange และเป็นราคาที่ risk engine ใช้ได้ (ข้อมูล)
  • ค่าความเสี่ยงต่างจาก backtest risk_fraction 0.1% และ max_notional 200 USDT ทำให้ order บน testnet มีขนาดเล็ก config แยกจาก strategy จึงเปลี่ยนค่าเหล่านี้ได้โดยไม่แตะ logic
  • account_id กำหนดชื่อบัญชีใน Nautilus (BYBIT-001) ซึ่งจะปรากฏใน event และ report

Reconciliation

เมื่อ node เริ่มทำงาน มันจะถาม exchange ว่ามี order และ position อะไรเปิดอยู่ แล้วปรับ state ภายในให้ตรงก่อนเริ่มเทรด (with_reconciliation(true)) ในระหว่างรัน config ของ execution engine กำหนดให้ตรวจซ้ำเป็นระยะ:

ฟิลด์ใน LiveExecutionEngineConfigค่าที่ใช้ความหมาย
open_check_interval_secsSome(10.0)ตรวจสถานะ order ที่เปิดอยู่กับ exchange ทุก 10 วินาที
position_check_interval_secsSome(30.0)ตรวจ position กับ exchange ทุก 30 วินาที
reconciliation_lookback_minsdefaultย้อนดูประวัติ order กี่นาทีตอนเริ่ม
reconciliation_startup_delay_secsdefault (10 วินาที)รอก่อนเริ่ม reconcile เพื่อให้การเชื่อมต่อพร้อม

Order ที่ค้างจากรอบก่อน

cache ของ node เก็บไว้ในหน่วยความจำ หลัง restart cache จึงว่างเปล่า order ที่ยังเปิดอยู่บน exchange จะถูกสร้างขึ้นใหม่ระหว่าง reconciliation เป็น external order และถูกมอบให้ strategy ที่ "claim" instrument นั้นไว้ ถ้าไม่มี strategy ใด claim order จะไปอยู่กับ strategy ชื่อ EXTERNAL ซึ่งเป็นค่า fallback

strategy ทั้งสองตัวในบทนี้ (MeanReversion และ SignalExecutor) claim instrument ของตัวเองไว้ใน constructor:

external_order_instrument_ids: Some(vec![config.instrument_id]),

ถ้าไม่ claim order ที่ค้างจากรอบก่อนจะไม่ใช่ของ EXECUTOR-001 และ is_busy() ซึ่งกรองด้วย strategy ID จะมองไม่เห็นมัน strategy อาจส่ง bracket ชุดใหม่ซ้อนกับ take profit/stop loss ชุดเก่าที่ยังทำงานอยู่บน exchange ดูกติกาการ claim ทั้งหมดที่ การสร้าง external order

การตรวจเป็นระยะคือสิ่งที่ทำให้ node รู้ตัวเมื่อ event หลุดหายระหว่าง WebSocket ขาดการเชื่อมต่อ ซึ่งเกิดขึ้นจริงใน live ถ้าไม่มีการตรวจนี้ is_busy() ของ strategy อาจคิดว่ายังมี order เปิดอยู่ตลอดไป และ strategy จะไม่เทรดอีกเลย รายละเอียดทั้งหมดอยู่ที่ Reconciliation

หยุด node อย่างปลอดภัย

node.run() รับสัญญาณ SIGINT (Ctrl+C) และ SIGTERM แล้วปิดตามลำดับนี้:

  1. หยุด strategy ซึ่งเรียก on_stop ของเรา: ยกเลิก order ของ strategy นี้และปิด position ด้วย reduce-only market order
  2. ประมวลผล event ที่ตามมาต่ออีกช่วงหนึ่ง (with_delay_post_stop_secs(5) คือ 5 วินาที) เพื่อรับ cancel และ fill ที่ยังมาไม่ถึง
  3. ปิด kernel และตัดการเชื่อมต่อกับ exchange

ถ้ายังมี order ที่ส่งไปแล้วแต่ไม่ได้รับคำตอบเมื่อหมดเวลาในข้อ 2 run() จะคืน error ให้รู้ ช่วงเวลานี้ต้องนานพอ สำหรับ latency ของ exchange ที่ใช้ ถ้า process ถูก kill แบบ SIGKILL ขั้นตอนเหล่านี้จะไม่เกิดขึ้นเลย order และ position ที่ค้างจะรอให้ reconciliation จัดการในรอบถัดไป

ลำดับขั้นจาก backtest ถึงเงินจริง

  1. backtest ผ่าน test ทุกตัว รวมถึง control market
  2. รันบน testnet อย่างน้อยหลายวัน ดู log ทุกบรรทัดที่เป็น WARN หรือ ERROR
  3. ทดลอง restart ระหว่างที่มี position เปิดอยู่ แล้วดูว่า reconciliation คืนสถานะได้ถูกต้อง
  4. ทดลองตัดอินเทอร์เน็ตชั่วคราว แล้วดูว่า node เชื่อมต่อใหม่และตรวจพบ order ที่เปลี่ยนสถานะระหว่างหลุด
  5. ไป mainnet ด้วยขนาดเล็กที่สุดที่ exchange ยอมรับ แล้วค่อยเพิ่มขนาดทีละขั้น

ก่อนขั้นที่ 5 ให้ผ่าน Production checklist ให้ครบ ดูการตั้งค่า live node แบบละเอียดได้ที่ Configure live trading และ รัน live trading ด้วย Rust ส่วนความสามารถของ adapter Bybit ดูที่ Bybit integration

แปลจาก เอกสาร NautilusTrader © Nautech Systems Pty Ltd และผู้ร่วมพัฒนา เผยแพร่ภายใต้ LGPL-3.0 ฉบับแปลนี้ตัดเนื้อหาเฉพาะ Python ออกและเน้น Rust