NautilusTrader Docs · ภาษาไทย

OrderBookDepth

OrderBookDepth แทน snapshot ที่มีจำนวนระดับราคา bid และ ask แปรผันได้ ใช้เมื่อ venue ส่ง depth snapshot ที่สมบูรณ์ในตัวเอง แทนที่จะเป็น delta แบบ incremental

Fields

FieldRust typeRequired/defaultหมายเหตุ
instrument_idInstrumentIdRequiredinstrument ที่ book นี้แทน
bidsSmallVec<[BookOrder; 10]>Requiredระดับ bid ตามลำดับใน book
asksSmallVec<[BookOrder; 10]>Requiredระดับ ask ตามลำดับใน book
bid_countsSmallVec<[u32; 10]>Requiredจำนวน bid order ในแต่ละระดับ
ask_countsSmallVec<[u32; 10]>Requiredจำนวน ask order ในแต่ละระดับ
flagsu8Requiredbit field ของ RecordFlag สำหรับ metadata ของ event
sequenceu64Requiredsequence number ของ venue หรือศูนย์หากไม่มี
ts_eventUnixNanosRequiredtimestamp ของ event หน่วยนาโนวินาที
ts_initUnixNanosRequiredtimestamp ตอน initialize หน่วยนาโนวินาที

พฤติกรรม

  • constructor ใน Rust รับ side ที่มีความยาวแปรผันได้ แต่ละ side ต้องมี count หนึ่งค่าต่อหนึ่ง order และฝั่ง bid กับ ask มีความยาวต่างกันได้
  • side ที่ว่างใช้ sequence ว่าง inline capacity คือสิบ snapshot ที่ใหญ่กว่านั้นจะ allocate เพิ่มตามต้องการ
  • type นี้ใช้แทนกันกับ stream ของ OrderBookDelta แบบ incremental ไม่ได้

ความเข้ากันได้กับของเดิม:

  • ชื่อ type เดิม OrderBookDepth10 ถูกยกเลิกแล้ว แต่ไดเรกทอรีใน catalog ที่ชื่อ order_book_depth10 ยังคง migrate ได้ และไฟล์ Arrow ที่เก็บ type นั้นไว้ใน schema metadata ยังคง transcode ได้
  • legacy C FFI และการเข้ารหัส SBE แบบ fixed-depth ต้องมีระดับราคาครบสิบระดับพอดีในแต่ละ side

ตัวอย่าง

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

let bids = vec![BookOrder::new(OrderSide::Buy, Price::from("2500.10"), Quantity::from("3.5"), 1)];
let asks = vec![BookOrder::new(OrderSide::Sell, Price::from("2500.20"), Quantity::from("2.0"), 2)];

let depth = OrderBookDepth::new(
    InstrumentId::from("ETHUSDT-PERP.BINANCE"),
    bids,
    asks,
    vec![1],
    vec![1],
    0,
    42,
    UnixNanos::from(1_000_000_000),
    UnixNanos::from(1_000_000_100),
);
  • QuoteTick อธิบายข้อมูล top-of-book ที่ได้จาก depth
  • Order books อธิบายสถานะของ order book
  • Rust API docs แสดงรายละเอียด API ฝั่ง Rust

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