NautilusTrader Docs · ภาษาไทย

InstrumentStatus

InstrumentStatus แทนการเปลี่ยนสถานะการซื้อขายของ instrument โดยเก็บ status event จาก venue เช่น pre-open, trading, halt, pause, close และการเปลี่ยนแปลงข้อจำกัด short-selling

ฟิลด์

ฟิลด์Rust typeRequired/defaultหมายเหตุ
instrument_idInstrumentIdRequiredinstrument ที่สถานะเปลี่ยน
actionMarketStatusActionRequiredstatus action ของ venue
ts_eventUnixNanosRequiredtimestamp ของ event หน่วยนาโนวินาที
ts_initUnixNanosRequiredtimestamp ตอน initialize หน่วยนาโนวินาที
reasonOption<Ustr>Noneสาเหตุของการเปลี่ยนสถานะ (ถ้ามี)
trading_eventOption<Ustr>Nonelabel ของ event จาก venue (ถ้ามี)
is_tradingOption<bool>Noneเปิดให้ซื้อขายอยู่หรือไม่ (ถ้าทราบ)
is_quotingOption<bool>Noneเปิดให้ quote อยู่หรือไม่ (ถ้าทราบ)
is_short_sell_restrictedOption<bool>Noneสถานะข้อจำกัด short-sell (ถ้าทราบ)

พฤติกรรม

  • boolean แบบ optional ช่วยให้ adapter เก็บสถานะตามที่ venue ส่งมาได้โดยไม่ต้องเดา
  • action ให้สถานะระดับสูงที่ normalize แล้ว แม้รายละเอียดเฉพาะของ venue จะถูกเก็บไว้ใน reason หรือ trading_event ด้วยก็ตาม
  • strategy สามารถรับ status update ได้ผ่าน on_instrument_status(...)

ตัวอย่าง

use nautilus_core::UnixNanos;
use nautilus_model::{
    data::InstrumentStatus,
    enums::MarketStatusAction,
    identifiers::InstrumentId,
};
use ustr::Ustr;

let status = InstrumentStatus::new(
    InstrumentId::from("AAPL.XNAS"),
    MarketStatusAction::Trading,
    UnixNanos::from(1_000_000_000),
    UnixNanos::from(1_000_000_100),
    Some(Ustr::from("Normal trading")),
    Some(Ustr::from("MARKET_OPEN")),
    Some(true),
    Some(true),
    Some(false),
);
  • InstrumentClose อธิบาย event ราคาปิดของ instrument
  • Instruments อธิบายการนิยาม instrument
  • Rust API reference รวมรายละเอียด API ฝั่ง Rust

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