NautilusTrader Docs · ภาษาไทย

OrderBookDelta

OrderBookDelta แทนการเปลี่ยนแปลงหนึ่งครั้งของ order book เป็นชนิดข้อมูล book ที่ละเอียดที่สุดในบรรดาที่มี มาให้ในตัว และรองรับ book type ที่ NautilusTrader ใช้กับ incremental update:

  • L3_MBO: ข้อมูล Level 3 market-by-order (MBO)
  • L2_MBP: ข้อมูล Level 2 market-by-price (MBP)
  • L1_MBP: ข้อมูล Level 1 market-by-price (MBP) เฉพาะ top-of-book

feed ต้นทางและ BookType เป้าหมายเป็นตัวกำหนดว่า delta หนึ่งตัวมีความละเอียดระดับใด

ใช้ชนิดนี้เมื่อ venue หรือผู้ให้บริการข้อมูล publish การเปลี่ยนแปลงของ book แบบ incremental และต้องการให้ NautilusTrader ดูแล state ของ book ไว้ในเครื่อง

ฟิลด์

ฟิลด์Rust typeRequired/defaultหมายเหตุ
instrument_idInstrumentIdRequiredinstrument ที่ book กำลังเปลี่ยน
actionBookActionRequiredADD, UPDATE, DELETE หรือ CLEAR
orderBookOrderRequiredpayload ที่มี price, size, side และ order ID
flagsu8Requiredbit field ของ RecordFlag สำหรับ metadata ของ event
sequenceu64Requiredsequence number จาก venue หรือศูนย์ถ้าไม่มี
ts_eventUnixNanosRequiredtimestamp ของ event หน่วยนาโนวินาที
ts_initUnixNanosRequiredtimestamp ตอน initialize หน่วยนาโนวินาที

ฟิลด์ของ BookOrder

ฟิลด์ order เก็บ payload BookOrder ของ delta

ฟิลด์Rust typeหมายเหตุ
sideOption<OrderSide>ฝั่งของ order
pricePriceราคาของ order
sizeQuantityขนาดของ order
order_idOrderId (u64)order ID ที่มากับ feed ต้นทาง

order แบบ null/default ใช้ None เป็น side พร้อม price, size และ order ID เป็นศูนย์

variant ของ BookAction

Rust variantValueความหมาย
BookAction::Add1เพิ่ม order เข้า book
BookAction::Update2อัปเดต order ที่มีอยู่แล้วใน book
BookAction::Delete3ลบ order ที่มีอยู่แล้วใน book
BookAction::Clear4ล้าง state ของ order book

พฤติกรรม

  • delta แบบ ADD และ UPDATE ต้องมี order size เป็นบวก
  • delta แบบ CLEAR จะ reset state ของ book และใช้ book order แบบ null
  • flags เก็บ metadata ของขอบเขต event และ snapshot ดู Delta flags และขอบเขตของ event
  • ใช้ OrderBookDelta::clear(...) เพื่อสร้าง clear delta

ตัวอย่าง

use nautilus_core::UnixNanos;
use nautilus_model::{
    data::{BookOrder, OrderBookDelta},
    enums::{BookAction, OrderSide, RecordFlag},
    identifiers::InstrumentId,
    types::{Price, Quantity},
};

let delta = OrderBookDelta::new(
    InstrumentId::from("ETHUSDT-PERP.BINANCE"),
    BookAction::Add,
    BookOrder::new(
        OrderSide::Buy,
        Price::from("2500.10"),
        Quantity::from("3.5"),
        12_345,
    ),
    RecordFlag::F_LAST as u8,
    42,
    UnixNanos::from(1_000_000_000),
    UnixNanos::from(1_000_000_100),
);
  • OrderBookDeltas อธิบายการรวม delta เป็นชุด (batching)
  • Order books อธิบาย book type และ state ของ book ในเครื่อง
  • Rust API reference รวมรายละเอียด API ฝั่ง Rust

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