NautilusTrader Docs · ภาษาไทย

Data Testing Spec

ใช้ test matrix นี้เพื่อตรวจสอบความสามารถด้านข้อมูลของ adapter ด้วย actor DataTester ของ Rust ซึ่งใน Rust import ได้จาก nautilus_testkit::testers แต่ละ case ใช้ ID ที่มี prefix (เช่น TC-D01) และจัดกลุ่มตามความสามารถ

adapter แต่ละตัวต้องผ่านชุดย่อยของ test ที่ตรงกับประเภทข้อมูลที่ตนรองรับ

กลุ่มของ test เรียงจากข้อมูลที่ derive น้อยที่สุดไปหามากที่สุด: instrument และข้อมูล book ดิบก่อน ตามด้วย quote, trade, bar และข้อมูลอนุพันธ์ adapter ที่ผ่านกลุ่ม 1-4 ถือว่าเป็นไปตามข้อกำหนดด้านข้อมูลขั้นพื้นฐาน (baseline data compliant)

ให้บันทึกพฤติกรรมด้านข้อมูลเฉพาะของ adapter (channel เฉพาะ, throttling, ความหมายของ snapshot ฯลฯ) ไว้ในคู่มือของ adapter นั้นเอง ไม่ใช่ที่นี่

สิ่งที่ต้องเตรียม

ก่อนรัน data test:

  • instrument เป้าหมายต้องมีอยู่และโหลดได้ผ่าน instrument provider
  • ตั้ง API credential ผ่าน environment variable ({VENUE}_API_KEY, {VENUE}_API_SECRET) เมื่อ venue ต้องการ การยืนยันตัวตนสำหรับข้อมูลที่กำลังทดสอบ
  • หาก venue มีโหมด demo/testnet ให้ใช้ credential ที่สร้างสำหรับ environment นั้น API key ของ demo และ production มักแยกกันและใช้แทนกันไม่ได้ การใช้ credential ผิดชุดจะทำให้เกิด error ด้านการยืนยันตัวตน (เช่น HTTP 401)

การตั้งค่า node ฝั่ง Rust (อ้างอิง: crates/adapters/{adapter}/examples/node_data_tester.rs):

use nautilus_testkit::testers::{DataTester, DataTesterConfig};

let tester_config = DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_quotes(true)
    .build()?;
let tester = DataTester::new(tester_config);
node.add_actor(tester)?;
node.run().await?;

สเกลของ timestamp

Nautilus เก็บ ts_event และ ts_init เป็น Unix nanosecond (UnixNanos) ทุก data message ที่มีฟิลด์เหล่านี้ ต้องใช้สเกลนี้ ไม่ใช่ค่าวินาที, มิลลิวินาที หรือไมโครวินาทีที่หลงเหลือมา

  • ค่าที่ต่ำกว่า 10^16 ไม่น่าจะเป็น timestamp แบบ Unix nanosecond ที่สมเหตุสมผล (10^16 ns คือประมาณ 116 วันหลังจาก 1970-01-01) และมักหมายความว่า adapter ไม่ได้แปลงสเกลจาก venue
  • เวลาจาก venue ที่ละเอียดระดับวินาทีและแปลงถูกต้องแล้วจะลงท้ายด้วย 000000000 และยังผ่าน: นั่นคือความละเอียด ที่หยาบ ไม่ใช่ความผิดพลาดของสเกล
  • ts_event ของ live stream ควรใกล้เคียงกับเวลาจริง (wall-clock) ของ session ผลลัพธ์จากการ request ข้อมูล ย้อนหลังอาจเก่ากว่าและยังถูกต้องหากสเกลเป็น nanosecond
  • ts_init คือ clock ในเครื่อง ณ เวลาที่ Nautilus สร้าง object อาจมีความคลาดเล็กน้อยที่ ts_event > ts_init ได้เมื่อ clock ของ venue เดินเร็วกว่า

DataTester จะเตือนเมื่อ ts_event หรือ ts_init ไม่ผ่านการตรวจสเกลบนประเภทข้อมูลเหล่านี้ รวมถึงชุดข้อมูล ย้อนหลังของแต่ละประเภท:

  • instrument, instrument status และ instrument close
  • book delta และ book depth
  • quote, trade และ bar
  • mark price, index price และ funding rate
  • option greeks

มันไม่ได้ตรวจ book ที่สร้างขึ้นใหม่ใน on_book ให้ถือว่าคำเตือนเป็นความล้มเหลวของ case ที่สร้าง message นั้น


ความสอดคล้องของการ sync order book

adapter ที่ดูแล order book จาก stream ของ venue ต้องรักษา output ให้ถูกต้องตลอดเวลาแม้เกิดความผิดพลาดจาก venue และเครือข่าย ชุด unit test และ integration test ไม่สามารถจำลองจังหวะเวลาของ venue ได้ ดังนั้นการเปลี่ยนแปลงกลไก การ sync และการกู้คืนของ book ต้องผ่านทั้งการตรวจด้วย model แบบ deterministic และการตรวจสอบแบบ live กับ venue จริง

การตรวจสอบแบบ live ในที่นี้หมายถึงการสังเกตเฉพาะ market data: subscribe, request และฉีด fault ห้ามส่ง order ระหว่างการตรวจสอบนี้ dark book คือ book ที่ subscribe แล้วแต่ไม่เคยได้รับข้อมูลเลย

ข้อตกลงของ book stream

BookStreamChecker ใน nautilus_live::book::conformance ซึ่งเปิดใช้ด้วย feature test-support ของ nautilus-live จะใช้ข้อตกลงนี้กับ batch OrderBookDeltas ทุกตัวที่ถูกส่งออกมา:

  • batch ลงท้ายด้วย F_LAST แต่ละ F_LAST ปิดกลุ่มของ event หนึ่งกลุ่ม และ book ต้องผ่านการตรวจ integrity หลัง ทุกกลุ่ม เพราะผู้ใช้ข้อมูลจะเห็น book ที่ขอบเขตเหล่านั้น
  • กลุ่ม snapshot คือ Clear ตามด้วย delta แบบ Add ซึ่งติด flag F_SNAPSHOT ทั้งหมด Clear ที่อยู่ลำพัง คือ snapshot ว่าง
  • กลุ่ม incremental ไม่มีทั้ง F_SNAPSHOT และ Clear และตามหลัง snapshot
  • sequence ของกลุ่ม incremental แต่ละกลุ่มต้องมากกว่ากลุ่มก่อนหน้า เมื่อ sequence ของ venue เพิ่มขึ้นแบบ monotonic ภายในช่วง snapshot เดียว seqId ของ OKX อาจ reset ได้ ส่วน book ของ Polymarket, Hyperliquid, Betfair และ AX Exchange ไม่มี sequence จาก venue ดังนั้น checker ของ venue เหล่านี้ทั้งหมดจะข้ามกฎนี้และอาศัย oracle แทน
  • book จะไม่ส่งอะไรออกมาอีกหลังการ unsubscribe เสร็จสิ้น

ระดับของการตรวจสอบ

เลือกระดับให้เหมาะกับส่วนที่เสี่ยงที่สุดของการเปลี่ยนแปลง ระดับที่สูงกว่ารวมเกณฑ์ของทุกระดับที่ต่ำกว่าด้วย

LevelTriggerวิธีการเกณฑ์การยอมรับ
L0 Modelการเปลี่ยนแปลงใด ๆ ต่อ BookSync, BookRecovery หรือการที่ adapter ใช้งานสิ่งเหล่านั้นproperty test ของ state machine ราย book เทียบกับ model อ้างอิง พร้อม regression ที่ฝังไว้property test ผ่าน และการย้อนการแก้ไขที่รู้จัก เช่นกฎความเป็นเจ้าของ gap ทำให้ test ล้มเหลว
L1 Conformanceการเปลี่ยนแปลงใด ๆ ต่อโค้ด sync/recovery ที่เคยตรวจสอบแล้วรัน stress harness หรือ oracle ที่ใช้อยู่ของ venue ซ้ำPASS ตามเกณฑ์ที่บันทึกไว้, ไม่มีการละเมิดจาก checker, ไม่มี dark book, ไม่มี error ที่อธิบายไม่ได้
L2 Edge probeการเปลี่ยนพฤติกรรมที่ขอบเขต (timeout, เส้นทางที่ปิดไว้, budget หมด, เพดานของการ retry)scenario ที่ขอบเขตแบบเจาะจง รวมถึงค่าปรับแต่งสุดขั้วใหม่แต่ละค่าทุก scenario ผ่าน เส้นทางที่ปิดไว้ยังเงียบ budget ที่หมดแล้วไปถึงเพดาน และ snapshot ที่มาช้ายังกู้ book ได้
L3 Race probeการเปลี่ยนแปลงด้าน concurrency หรือลำดับ (gate, epoch, ปฏิสัมพันธ์กับ reconnect) หรือการแก้ race ที่พบจาก liveฉีด fault พร้อม subscribe churn ภายใต้ oracle ที่เป็นอิสระการกู้คืนที่บังคับให้เกิดหลายสิบครั้งเสร็จสิ้นโดยไม่มี dark book และ scenario ของ race ที่รายงานไว้ผ่านโดยไม่เกิดซ้ำ
L4 Full validationimplementation ของ sync/recovery ใหม่L1-L3 พร้อม soak test ที่มี churn และ fault จาก reconnect ต่อเนื่องเกณฑ์ระดับล่างทั้งหมดผ่านตลอดการ soak และ latency ของการกู้คืนอยู่ในขอบเขต

property test ของ L0 คือ schedule_keeps_sync_contract ใน crates/live/src/book/sync.rs ให้บันทึก level, venue, oracle และผลลัพธ์ไว้กับการเปลี่ยนแปลง การแก้ไขที่พบจากการตรวจสอบแบบ live ต้องเริ่มใหม่ที่ระดับที่พบปัญหานั้น: การรันซ้ำต้องผ่านเกณฑ์เดิม ไม่ใช่เกณฑ์ที่เบากว่า

แคตตาล็อกของ fault

adapter ทุกตัวต้องให้ผลลัพธ์เหล่านี้ ไม่ว่าจะอยู่ใน recovery family ใด:

Faultผลลัพธ์ที่ต้องการ
Sequence gapoutput หยุดที่ gap และกลับมาส่งต่อเมื่อ snapshot ใหม่แทนที่ book แล้วเท่านั้น
Snapshot หายหรือมาช้าdeadline ของ snapshot จะเริ่มหรือ retry การกู้คืน snapshot ที่ยอมรับระหว่างความพยายามแต่ละครั้งจะยุติการกู้คืน
เริ่มการกู้คืนไม่ได้book ยังไม่มีเจ้าของและจะขอการกู้คืนอีกครั้งใน frame ถัดไป task ที่ถูกปฏิเสธจะยกเลิกช่วงที่ตนอ้างสิทธิ์ไว้
การแทนที่ถูกปฏิเสธการกู้คืน retry error ที่ classifier ระบุว่าถาวรจะข้าม budget และ retry ที่เพดาน
Retry budget หมดlog error หนึ่งครั้ง แล้ว retry ที่เพดานจนกว่าจะยอมรับ snapshot ได้
Reconnect ระหว่างการกู้คืนการกู้คืนที่กำลังรันอยู่คง budget, ความเป็นเจ้าของ และการเขียนที่ค้างอยู่ไว้ และการรอเพดานครั้งถัดไปจะจบทันที book อื่นจะ resync จาก snapshot ใหม่
Unsubscribe ระหว่างการกู้คืนการกู้คืนและการเขียนที่ค้างอยู่หยุดลง และ book ไม่ส่งอะไรออกมาอีก

เทคนิคการบังคับให้เกิดสถานการณ์

ให้ความสำคัญกับลำดับเหตุการณ์ที่แตกต่างมากกว่าปริมาณดิบ probe จะคุ้มค่าก็ต่อเมื่อมันบังคับลำดับที่ชุด test ทำให้เกิด ไม่ได้ (reconnect ระหว่างการกู้คืน, snapshot ที่แข่งกับการเปิด gate, unsubscribe ที่แข่งกับ subscribe ที่ยังค้างอยู่) จำนวน message เพียงอย่างเดียวไม่ใช่เหตุผลที่เพียงพอสำหรับ probe

เทคนิคสิ่งที่ทดสอบตัวเลขที่พิสูจน์แล้วว่าได้ผลสิ่งที่จับได้จริง
Subscribe churn (หมุน unsubscribe/resubscribe พร้อม flap เต็มรูปแบบเป็นระยะ)การเริ่มกู้คืน, การเปลี่ยนรอบ gate/epoch, race ของการยกเลิกที่ค้างอยู่tick ทุก 20 วินาทีตลอดการรัน 10-15 นาที การกู้คืนที่บังคับหลายสิบครั้ง (40+) โดยไม่มี dark bookข้อบกพร่องของ subscribe ซ้ำที่กู้คืนไม่ได้ (นำไปสู่การทบทวน design)
Traffic freeze (STOP tunnel ~40 วินาที)การตรวจจับ connection ที่ตาย, replay หลัง reconnect, การกู้คืนหลัง reconnectfreeze 2-3 ครั้งต่อการรัน เว้นระยะห่างกันหลายนาทีพิสูจน์การกู้คืนหลัง reconnect ภายใต้ packet loss ทั้งหมด ยังไม่พบข้อบกพร่อง
Proxy fault injection (drop/hold/cut frame ตามกฎ)การจัดการ gap, การปล่อย frame ที่ถูกถือไว้, ความสอดคล้องกับ oracleoracle batch หลายพันชุดต่อการรัน (6k+), นับ gap ต่อรอบrace ของ harness ที่ขึ้นกับ timeout (หน้าต่างสังเกตคงที่เทียบกับค่าเริ่มต้นใหม่)
ค่าปรับแต่งสุดขั้ว (0 และค่าสั้นที่ไม่ใช่ค่าเริ่มต้น)branch ที่ปิด deadline, การส่งพารามิเตอร์ต่อตลอดเส้นทางรันสั้นหนึ่งครั้งต่อค่าสุดขั้ว (4-5 นาที) ขณะมี churnยืนยันการแก้ไข zero-timeout ที่พบจาก review บน live และพิสูจน์การส่งพารามิเตอร์
Reconnect ที่ client สั่ง (คำสั่ง reconnect สาธารณะ แล้วทดสอบต่อ)การกู้คืนหลัง reconnect โดยไม่แตะเครือข่ายของเครื่อง hostผ่าน reconnect/reconcile ติดต่อกัน 5+ ครั้งพิสูจน์การกู้คืนโดยไม่มี fault จาก host ยังไม่พบข้อบกพร่อง
รัน scenario ของ race ซ้ำต่อเนื่องความไวต่อ schedulerผ่าน live ติดต่อกัน 5+ ครั้ง และรันซ้ำ 100 เท่าสำหรับ harness แบบ deterministicความไม่เสถียร (flake) ที่ผ่านครั้งหนึ่งแต่ล้มเหลวนาน ๆ ครั้ง

ให้ route แต่ละ venue ผ่านตำแหน่งเครือข่ายที่ venue นั้นให้บริการ Polymarket จำกัดการเข้าถึงตามภูมิภาค ส่วน OKX, Lighter, Binance, Hyperliquid และ AX Exchange ตรวจสอบแบบเชื่อมต่อตรงได้ ยืนยันว่าเส้นทางนั้นได้รับข้อมูลจาก venue ก่อนการรันที่ยาว: socket อาจเชื่อมต่อได้ขณะที่ venue ยังเงียบ branch ที่ venue ไม่เคยสร้างขึ้นใน live ควรอยู่ใน harness แบบ deterministic ที่ใช้ข้อมูล wire ที่บันทึกไว้ ไม่ใช่ในการรันแบบ live

Oracle

oracle คือการสร้างความจริงของ venue ขึ้นใหม่อย่างอิสระ แล้วเปรียบเทียบกับ book ที่ถูกส่งออกมาผ่าน BookStreamChecker::verify:

  • สร้างจาก connection แยกต่างหากหรือ REST snapshot ห้ามสร้างจาก state ของ adapter เอง
  • เปรียบเทียบที่ sequence ของ venue ที่ตรงกัน ข้าม sample ที่จัดให้ตรงกันไม่ได้ และไม่นับเป็นการผ่าน
  • นับว่าช่วง snapshot หนึ่งได้รับการตรวจสอบแล้วเมื่อการเปรียบเทียบหลัง snapshot นั้นสำเร็จ harness ที่ใช้ Coverage::Episodes เช่น OKX จะตรวจแต่ละ batch เมื่อมาถึง และทำให้ session ล้มเหลวหากมีช่วงใดไม่ได้รับการตรวจ ส่วน harness ที่ใช้ Coverage::Samples เช่น Binance จะจับคู่ sample ของ oracle ตาม update ID ภายหลัง จึงรายงาน จำนวนการตรวจของ oracle และ sample ที่จับคู่ไม่ได้ ไม่ใช่ความครอบคลุมรายช่วง

Stress harness

stress harness เป็นเครื่องมือพัฒนาสำหรับการเปลี่ยนแปลงโค้ด sync และการกู้คืนของ book ไม่ได้เป็นส่วนหนึ่งของ crate ที่ publish และไม่ได้รันใน CI BookStreamChecker ที่มันใช้มาพร้อมกับ nautilus-live ภายใต้ feature test-support test อื่นจึงใช้ข้อตกลงเดียวกันได้

adapter ที่ใช้กลไก book ร่วมจะเก็บ live harness ไว้ที่ crates/adapters/<venue>/tests/stress/book_stress.rs และลงทะเบียนเป็น test target ชื่อ <venue>-book-stress:

[[test]]
name = "okx-book-stress"
path = "tests/stress/book_stress.rs"
harness = false
test = false
required-features = ["examples"]

harness = false ให้ target ควบคุม runtime และอาร์กิวเมนต์ของตัวเอง และ test = false ทำให้มันไม่ถูกรันใน cargo test และ nextest ตามค่าเริ่มต้น ให้เพิ่ม nautilus-live พร้อม feature test-support ใน dev-dependencies ของ crate

กลไกร่วมเป็นซอร์สของ test อยู่ที่ crates/live/tests/book/stress/ ซึ่งแต่ละ harness compile รวมเข้ามาด้วย path include:

#[path = "../../../../live/tests/book/stress/mod.rs"]
mod stress;

module ร่วมเป็นผู้รัน harness ส่วน venue จัดเตรียมเฉพาะชิ้นส่วนของตัวเองด้วยการ implement StressVenue:

  • WireCodec ที่จัดประเภทแต่ละ frame ของ venue ว่าเป็น book snapshot, book update หรือการตอบรับ unsubscribe โดยบันทึก frame ลงใน oracle ก่อนที่ fault ใด ๆ จะมีผล และยังเขียน frame ใหม่เพื่อฝัง sequence gap หรือความไม่ตรงกัน แบบ in-band ได้ รวมถึงตอบ subscribe ของ adapter ด้วยการปฏิเสธจาก venue ได้ด้วย
  • route ของ proxy, configuration ของ data client และ route ของ proxy เพิ่มเติม เช่น proxy สำหรับ REST snapshot
  • การเปรียบเทียบกับ oracle สำหรับแต่ละ batch ที่ถูกส่งออกมา, เงื่อนไขของ book ที่สมบูรณ์ และการตรวจตัวเองตอนเริ่มต้น
  • scenario ต่าง ๆ ที่เขียนโดยใช้ Session

FaultProxy ส่งต่อ traffic WebSocket ของ adapter ไปยัง venue สำหรับ route ที่ URL ต้นทางไม่ใช่ WebSocket URL มันจะส่งต่อเป็นบรรทัดที่คั่นด้วย CRLF ผ่าน raw TCP route แบบบรรทัดให้บริการเฉพาะที่อยู่ของ proxy และ WireCodec::connect ของ venue จะเปิด connection ต้นทางเอง เช่น ผ่าน TLS

proxy ใช้กฎ Fault ราย book (drop snapshot หรือ update, ทำให้เสียหาย, hold, ทำให้เงียบ, ตัดเมื่อ unsubscribe, ปฏิเสธ subscribe) และการตัดหรือ freeze ทั้ง connection Session ส่งแต่ละ batch ที่ถูกส่งออกมาผ่าน BookStreamChecker และ oracle รอให้ book กลับมาสมบูรณ์ และเมื่อ shutdown จะตรวจว่า socket และ handle ของ reconnect ทั้งหมดถูกปล่อยแล้ว

harness ทุกตัวรับ flag ชุดเดียวกัน และ venue อาจเพิ่ม flag ของตัวเอง --help จะแสดงรายการ flag:

FlagความหมายDefault
--scenario NAMEscenario ที่จะรันchurn
--timeout SECSbook_snapshot_timeout_secs ค่า 0 ปิด deadline ของ snapshot10
--rounds Nจำนวนรอบของ stressค่าเริ่มต้นของ venue

รัน harness อย่างชัดเจนโดยตัด environment variable ของ adapter ออก:

CARGO_BUILD_JOBS=16 bash scripts/strip-adapter-env.bash \
  cargo test -p nautilus-okx --features examples --test okx-book-stress -- --timeout 10 --rounds 18

Betfair stream market data ให้เฉพาะ account ที่ login แล้ว harness ของมันจึงรันโดยตั้ง credential ของ Betfair ไว้ ดู Live recovery validation market data ของ AX Exchange ก็ต้องการการยืนยันตัวตนเช่นกัน harness ของมันจึงอ่าน sandbox credential จาก environment และรันโดยไม่ใช้ wrapper

harness จะเขียนหนึ่งบรรทัดต่อ event ไปยัง stderr แต่ละบรรทัดขึ้นต้นด้วยคำที่กำหนดตายตัว:

บรรทัดความหมาย
STARTvenue และอาร์กิวเมนต์
CHECKการตรวจตัวเองตอนเริ่มต้นหรือ probe ของ scenario ผ่าน
ROUNDstress รอบหนึ่งเสร็จสิ้น พร้อมตัวนับ
SHUTDOWNsession หยุดอย่างเรียบร้อย พร้อมตัวนับและความครอบคลุมของ oracle
PASSการรันเสร็จสิ้น เป็นบรรทัดสุดท้ายของการรันที่ผ่านเสมอ
FAILการตรวจล้มเหลวหรือ thread ใด panic โปรเซสจะจบด้วย status 1

ความล้มเหลวจาก deadline จะรายงาน frame ของ venue ที่แต่ละ route ของ proxy ได้รับ เพื่อแยก route ที่เงียบออกจาก ความล้มเหลวของ adapter

การตรวจตัวเอง: target ที่ตั้ง harness = false ไม่สามารถรันฟังก์ชัน #[test] ได้ venue จึงพิสูจน์การ parse wire และ oracle ของตนใน StressVenue::self_check ก่อนจะมี traffic ใด ๆ จาก venue ส่วน proxy ร่วม, การ parse อาร์กิวเมนต์ และ wire book มี unit test อยู่ใน test target book ของ nautilus-live รันได้ด้วย cargo nextest run -p nautilus-live --features test-support --test book

เอกสารของ harness: เพิ่มหัวข้อ Live recovery validation ในคู่มือ integration ของ adapter โดยระบุการตรวจ, fault ที่ฉีด, คำสั่งรัน, scenario, flag และ endpoint ที่ต้องใช้ OKX, Binance, Lighter, Polymarket, Hyperliquid, Bybit, Betfair และ AX Exchange มี harness ให้แล้ว

การตรวจสอบแบบ in-band

เมื่อ venue เผยแพร่ checksum หรือ hash ของ book ให้ตรวจ state ที่สมบูรณ์ซึ่ง checksum นั้นครอบคลุม และถือว่าความ ไม่ตรงกันเป็น gap วิธีนี้จับความเสียหายที่การตรวจ sequence พลาดได้โดยไม่ต้องใช้ oracle ภายนอก

  • Kraken: ตรวจ CRC32 checksum บนแต่ละ message ของ Spot L2 book และ L3 เมื่อเปิด validate_l2_checksum และ validate_l3_checksum ซึ่งเปิดเป็นค่าเริ่มต้นทั้งคู่
  • Polymarket: ปฏิเสธ snapshot ที่ hash ไม่ตรงเมื่อมี input ของ hash ครบ snapshot ที่ input ไม่ครบและ update แบบ incremental ยังไม่ได้รับการตรวจและไม่ trigger การกู้คืนจาก hash ความลึกที่ขาดหายอาจไม่ถูกตรวจพบจนกว่าจะมี snapshot ใหม่ ดู book snapshot validation และ price change bursts
  • OKX: frame ของ books มี checksum เป็นศูนย์ การตรวจสอบจึงอาศัย oracle แทน

แต่ละกลุ่มด้านล่างเริ่มด้วยตารางสรุป ตามด้วย test card แบบละเอียด Test ID ใช้หมายเลขแบบเว้นช่วงเพื่อให้แทรกเพิ่มได้โดยไม่ต้องเรียงหมายเลขใหม่


กลุ่ม 1: Instrument

ตรวจสอบการโหลดและการ subscribe instrument ก่อนทดสอบ stream ของ market data

TCชื่อคำอธิบายข้ามเมื่อ
TC-D01Request instrumentsโหลด instrument ทั้งหมดของ venueไม่ข้าม
TC-D02Subscribe instrumentsubscribe การอัปเดตของ instrumentไม่มี instrument sub
TC-D03Load specific instrumentโหลด instrument ตัวเดียวตาม IDไม่ข้าม

TC-D01: Request instruments

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว
ActionDataTester request instrument ทั้งหมดของ venue ตอน start
Event sequencecallback on_instruments ได้รับรายการ instrument
Pass criteriaได้รับ instrument อย่างน้อยหนึ่งตัว แต่ละตัวมี symbol, price precision และ size increment ที่ถูกต้อง
Skip whenไม่ข้าม

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .request_instruments(true)
    .build()?

TC-D02: Subscribe instrument

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument แล้ว
ActionDataTester subscribe การอัปเดตของ instrument
Event sequencecallback on_instrument ได้รับ instrument
Pass criteriaได้รับ instrument ที่มี instrument_id ถูกต้องและฟิลด์ถูกต้อง
Skip whenadapter ไม่รองรับการ subscribe instrument

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_instrument(true)
    .build()?

TC-D03: Load specific instrument

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว
Actionโหลด instrument ตัวหนึ่งตาม InstrumentId ผ่าน instrument provider
Event sequenceinstrument มีอยู่ใน cache หลังโหลด
Pass criteriaโหลด instrument ได้พร้อม ID, price precision, size increment และกฎการซื้อขายที่ถูกต้อง
Skip whenไม่ข้าม

ข้อควรพิจารณา:

  • case นี้ทดสอบ method load / load_async ของ instrument provider โดยตรง
  • ตรวจว่า instrument ถูกเก็บใน cache และเรียกดูจาก cache ด้วย instrument_id ได้

กลุ่ม 2: Order book

ทดสอบโหมดการ subscribe order book และการ request snapshot

TCชื่อคำอธิบายข้ามเมื่อ
TC-D10Subscribe book deltasstream การอัปเดต OrderBookDeltasไม่รองรับ book
TC-D11Subscribe book at intervalsnapshot ของ OrderBook เป็นระยะไม่รองรับ book
TC-D12Subscribe book depthsnapshot ของ OrderBookDepthไม่รองรับ book depth
TC-D13Request book snapshotrequest book snapshot ครั้งเดียวไม่รองรับ book snapshot
TC-D14Managed book from deltasสร้าง book ใน local จาก stream ของ deltaไม่รองรับ book

scenario เหล่านี้ใช้ BookType::L2_MBP ทั้งนี้ builder ฝั่ง Rust สามารถ override book_type ได้เมื่อ adapter ต้องการรูปแบบ book ที่ต่างออกไป

TC-D10: Subscribe book deltas

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument แล้ว
ActionDataTester subscribe order book delta
Event sequenceได้รับ event OrderBookDeltas ใน on_book_deltas
Pass criteriaได้รับ delta ที่มี instrument ID ถูกต้อง และมี delta อย่างน้อยหนึ่งตัวที่มีการอัปเดต bid/ask
Skip whenadapter ไม่รองรับข้อมูล order book

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_book_deltas(true)
    .book_type(BookType::L2_MBP)
    .build()?

TC-D11: Subscribe book at interval

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument แล้ว
ActionDataTester subscribe snapshot ของ order book เป็นระยะ
Event sequenceได้รับ event OrderBook ใน on_book ตามช่วงเวลาที่ตั้งไว้
Pass criteriaได้รับ book snapshot ที่มี level ของ bid/ask และการอัปเดตมาถึงตามช่วงเวลาที่ตั้งไว้โดยประมาณ
Skip whenadapter ไม่รองรับข้อมูล order book

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_book_at_interval(true)
    .book_type(BookType::L2_MBP)
    .book_depth(10)
    .book_interval_ms(1000)
    .build()?

TC-D12: Subscribe book depth

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument แล้ว
ActionDataTester subscribe snapshot ของ OrderBookDepth
Event sequenceได้รับ event OrderBookDepth ใน on_book_depth
Pass criteriadepth snapshot เคารพขีดจำกัดจำนวน level ที่ร้องขอ และราคาเรียงลำดับถูกต้อง
Skip whenadapter ไม่รองรับการ subscribe book depth

เลือก depth ที่ venue รองรับ ดูขีดจำกัดได้ในคู่มือของ adapter book_depth มีผลกับการ subscribe book ทุกแบบที่เปิดไว้ และกับการ request book snapshot หากไม่ระบุจะใช้ค่าเริ่มต้นของ adapter

  • เมื่อรัน depth ควบคู่กับ delta หรือ interval book DataTester จะ subscribe depth โดยตั้ง managed เป็น false เพื่อไม่ให้เขียนทับ book ที่จัดการจาก delta
  • เมื่อเปิดเฉพาะ depth ค่า managed จะเป็นไปตาม manage_book

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_book_depth(true)
    .book_type(BookType::L2_MBP)
    .build()?

TC-D13: Request book snapshot

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument แล้ว
ActionDataTester request snapshot ของ order book ครั้งเดียว
Event sequenceได้รับ book snapshot ผ่าน callback ของข้อมูลย้อนหลัง
Pass criteriasnapshot มี level ของ bid/ask ที่มีราคาและขนาดถูกต้อง
Skip whenadapter ไม่รองรับการ request book snapshot

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .request_book_snapshot(true)
    .book_depth(10)
    .build()?

TC-D14: Managed book from deltas

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว, โหลด instrument แล้ว และมี book delta stream เข้ามา
ActionDataTester subscribe delta โดยตั้ง manage_book เป็น true และสร้าง order book ใน local จาก stream ของ delta
Event sequenceOrderBookDeltas ถูกนำไปใช้กับ OrderBook ใน local และ log book ตาม depth ที่ตั้งไว้
Pass criteriabook ใน local สร้างได้ถูกต้องจาก delta level ของ bid เรียงลง level ของ ask เรียงขึ้น และ book ไม่ว่างหลัง snapshot แรก
Skip whenadapter ไม่รองรับข้อมูล order book

ข้อควรพิจารณา:

  • managed book นำแต่ละ delta ไปใช้กับ instance ของ OrderBook ที่ actor ดูแลอยู่
  • ใช้ book_levels_to_print เพื่อควบคุมความละเอียดของ log

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_book_deltas(true)
    .manage_book(true)
    .book_type(BookType::L2_MBP)
    .build()?

DataTesterConfig มี request_book_deltas ให้ใช้ แต่ DataTester ไม่ได้ส่ง request ข้อมูลย้อนหลังนั้นจริง ให้ทดสอบ การรองรับ book delta ย้อนหลังของ adapter ผ่าน actor แบบกำหนดเองไปก่อน จนกว่า tester จะ implement เส้นทาง request นี้


กลุ่ม 3: Quote

ทดสอบการ subscribe quote tick และการ request ข้อมูลย้อนหลัง

TCชื่อคำอธิบายข้ามเมื่อ
TC-D20Subscribe quotesตรวจว่า event QuoteTick ไหลเข้ามาหลัง startไม่ข้าม
TC-D21Request historical quotesrequest quote tick ย้อนหลังไม่มี quote ย้อนหลัง

TC-D20: Subscribe quotes

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument แล้ว
ActionDataTester subscribe quote ตอน start
Event sequenceได้รับ event QuoteTick ใน on_quote
Pass criteriaได้รับ QuoteTick อย่างน้อยหนึ่งตัวที่มีราคาและขนาดของ bid/ask ถูกต้อง และ bid < ask
Skip whenไม่ข้าม

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_quotes(true)
    .build()?

TC-D21: Request historical quotes

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument แล้ว
ActionDataTester request quote tick ย้อนหลัง
Event sequenceได้รับ batch ของ quote ย้อนหลังผ่าน on_historical_quotes
Pass criteriaได้รับ quote ที่มี timestamp, ราคา bid/ask และขนาดถูกต้อง
Skip whenadapter ไม่รองรับการ request quote ย้อนหลัง

หมายเหตุ: ต้นฉบับมีเฉพาะตัวอย่าง config แบบ Python (request_quotes) จึงตัดออก


กลุ่ม 4: Trade

ทดสอบการ subscribe trade tick และการ request ข้อมูลย้อนหลัง

TCชื่อคำอธิบายข้ามเมื่อ
TC-D30Subscribe tradesตรวจว่า event TradeTick ไหลเข้ามาหลัง startไม่ข้าม
TC-D31Request historical tradesrequest trade tick ย้อนหลังไม่มี trade ย้อนหลัง

TC-D30: Subscribe trades

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument แล้ว
ActionDataTester subscribe trade ตอน start
Event sequenceได้รับ event TradeTick ใน on_trade
Pass criteriaได้รับ TradeTick อย่างน้อยหนึ่งตัวที่มีราคา, ขนาด และ aggressor side ถูกต้อง
Skip whenไม่ข้าม

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_trades(true)
    .build()?

TC-D31: Request historical trades

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument แล้ว
ActionDataTester request trade tick ย้อนหลัง
Event sequenceได้รับ batch ของ trade ย้อนหลังผ่าน on_historical_trades
Pass criteriaได้รับ trade ที่มี timestamp, ราคา, ขนาด และ trade ID ถูกต้อง
Skip whenadapter ไม่รองรับการ request trade ย้อนหลัง

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .request_trades(true)
    .build()?

กลุ่ม 5: Bar

ทดสอบการ subscribe bar และการ request ข้อมูลย้อนหลัง

TCชื่อคำอธิบายข้ามเมื่อ
TC-D40Subscribe barsตรวจว่า event Bar ไหลเข้ามาหลัง startไม่รองรับ bar
TC-D41Request historical barsrequest bar แบบ OHLCV ย้อนหลังไม่มี bar ย้อนหลัง

TC-D40: Subscribe bars

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว, โหลด instrument แล้ว และตั้งค่า bar type แล้ว
ActionDataTester subscribe bar สำหรับ BarType ที่ตั้งค่าไว้
Event sequenceได้รับ event Bar ใน on_bar
Pass criteriaได้รับ Bar อย่างน้อยหนึ่งตัวที่มีค่า OHLCV ถูกต้อง โดย high >= low, high >= open, high >= close
Skip whenadapter ไม่รองรับการ subscribe bar

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .bar_types(vec![bar_type])
    .subscribe_bars(true)
    .build()?

TC-D41: Request historical bars

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว, โหลด instrument แล้ว และตั้งค่า bar type แล้ว
ActionDataTester request bar ย้อนหลังสำหรับ BarType ที่ตั้งค่าไว้
Event sequenceได้รับ bar ย้อนหลังผ่าน callback
Pass criteriaได้รับ bar ที่มีค่า OHLCV ถูกต้องและ timestamp เรียงจากน้อยไปมาก
Skip whenadapter ไม่รองรับการ request bar ย้อนหลัง

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .bar_types(vec![bar_type])
    .request_bars(true)
    .build()?

กลุ่ม 6: ข้อมูลอนุพันธ์

ทดสอบ data stream เฉพาะของอนุพันธ์: mark price, index price และ funding rate

TCชื่อคำอธิบายข้ามเมื่อ
TC-D50Subscribe mark pricesevent MarkPriceUpdateไม่ใช่อนุพันธ์
TC-D51Subscribe index pricesevent IndexPriceUpdateไม่ใช่อนุพันธ์
TC-D52Subscribe funding ratesevent FundingRateUpdateไม่ใช่ perpetual
TC-D53Request historical funding ratesข้อมูล funding rate ย้อนหลังไม่ใช่ perpetual

TC-D50: Subscribe mark prices

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument ประเภทอนุพันธ์แล้ว
ActionDataTester subscribe การอัปเดต mark price
Event sequenceได้รับ event MarkPriceUpdate ใน on_mark_price
Pass criteriaได้รับ MarkPriceUpdate อย่างน้อยหนึ่งตัวที่มี instrument ID และ mark price ถูกต้อง
Skip wheninstrument ไม่ใช่อนุพันธ์ หรือ adapter ไม่ให้ข้อมูล mark price

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_mark_prices(true)
    .build()?

TC-D51: Subscribe index prices

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument ประเภทอนุพันธ์แล้ว
ActionDataTester subscribe การอัปเดต index price
Event sequenceได้รับ event IndexPriceUpdate ใน on_index_price
Pass criteriaได้รับ IndexPriceUpdate อย่างน้อยหนึ่งตัวที่มี instrument ID และ index price ถูกต้อง
Skip wheninstrument ไม่ใช่อนุพันธ์ หรือ adapter ไม่ให้ข้อมูล index price

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_index_prices(true)
    .build()?

TC-D52: Subscribe funding rates

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument ประเภท perpetual แล้ว
ActionDataTester subscribe การอัปเดต funding rate
Event sequenceได้รับ event FundingRateUpdate ใน on_funding_rate
Pass criteriaได้รับ FundingRateUpdate อย่างน้อยหนึ่งตัวที่มี instrument ID และ rate ถูกต้อง
Skip wheninstrument ไม่ใช่ perpetual หรือ adapter ไม่ให้ข้อมูล funding rate

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_funding_rates(true)
    .build()?

TC-D53: Request historical funding rates

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument ประเภท perpetual แล้ว
ActionDataTester request funding rate ย้อนหลัง (ค่าเริ่มต้นย้อนหลัง 7 วัน)
Event sequenceได้รับ funding rate ย้อนหลังผ่าน callback
Pass criteriaได้รับ funding rate ที่มี timestamp และค่า rate ถูกต้อง
Skip wheninstrument ไม่ใช่ perpetual หรือ adapter ไม่รองรับการ request funding rate ย้อนหลัง

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .request_funding_rates(true)
    .build()?

กลุ่ม 7: Instrument status

ทดสอบการ subscribe event ของ instrument status และ instrument close

TCชื่อคำอธิบายข้ามเมื่อ
TC-D60Subscribe instrument statusevent InstrumentStatusไม่รองรับ status
TC-D61Subscribe instrument closeevent InstrumentCloseไม่รองรับ close

TC-D60: Subscribe instrument status

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument แล้ว
ActionDataTester subscribe การอัปเดต instrument status
Event sequenceได้รับ event InstrumentStatus ใน on_instrument_status
Pass criteriaได้รับ status event ที่มี MarketStatusAction ถูกต้อง (เช่น Trading)
Skip whenadapter ไม่รองรับการ subscribe instrument status

ข้อควรพิจารณา:

  • status event อาจเกิดขึ้นเฉพาะเมื่อ state เปลี่ยน (เช่น หยุดการซื้อขาย -> กลับมาซื้อขาย)
  • ในช่วงเวลาซื้อขายปกติ อาจได้รับ status Trading ตอน subscribe

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_instrument_status(true)
    .build()?

TC-D61: Subscribe instrument close

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument แล้ว
ActionDataTester subscribe event ของ instrument close
Event sequenceได้รับ event InstrumentClose ใน on_instrument_close
Pass criteriaได้รับ close event ที่มีราคาปิดและประเภทการปิดถูกต้อง
Skip whenadapter ไม่รองรับการ subscribe instrument close

ข้อควรพิจารณา:

  • close event มักเกิดตอนจบ session สำหรับตลาดแบบดั้งเดิม
  • อาจไม่เกิดขึ้นสำหรับ venue คริปโตที่เปิด 24/7 เว้นแต่ adapter จะสังเคราะห์ราคาปิดรายวันขึ้นมา

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_instrument_close(true)
    .build()?

กลุ่ม 8: Option greeks

ทดสอบการ subscribe option greeks และ option chain

TCชื่อคำอธิบายข้ามเมื่อ
TC-D62Subscribe option greeksข้อมูล OptionGreeks ของ instrument ตัวเดียวไม่รองรับ greeks
TC-D63Subscribe option chainsnapshot ของ OptionChainSlice สำหรับ seriesไม่รองรับ chain

TC-D62: Subscribe option greeks

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument ประเภท option แล้ว
ActionDataTester subscribe การอัปเดต option greeks
Event sequenceได้รับ event OptionGreeks ใน on_option_greeks
Pass criteriaได้รับ greeks ที่มีค่า delta, gamma, vega, theta ถูกต้อง
Skip whenadapter ไม่รองรับการ subscribe option greeks

ข้อควรพิจารณา:

  • greeks มีเฉพาะสำหรับ instrument ประเภท option
  • ค่าขึ้นกับ pricing model ของ venue และอาจอัปเดตทุกครั้งที่ quote เปลี่ยน
  • บาง venue (Bybit, Deribit) subscribe ราย instrument ส่วน OKX subscribe ราย instrument family แล้วกรองเหลือเฉพาะ instrument ที่ร้องขอ
  • rho อาจเป็นศูนย์เมื่อ venue ไม่ได้ให้มา (Bybit, OKX)
  • underlying_price และ open_interest อาจเป็น None ขึ้นกับ channel ของ venue

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_option_greeks(true)
    .build()?

TC-D63: Subscribe option chain

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และโหลด instrument ประเภท option ของ series แล้ว
ActionDataTester subscribe snapshot ของ option chain สำหรับ series
Event sequenceได้รับ snapshot ของ OptionChainSlice ใน on_option_chain
Pass criteriachain snapshot มี greeks ของ instrument ที่ตรงกับ series
Skip whenadapter ไม่รองรับการ subscribe option chain

ข้อควรพิจารณา:

  • การ subscribe option chain ถูกจัดการโดย DataEngine ซึ่งสร้างการ subscribe quote และ greeks ราย instrument ภายใน
  • ช่วง strike แบบ dynamic ต้องมีราคา ATM ก่อนเริ่มการ subscribe instrument โดย DataEngine จะ request ราคาอ้างอิง เริ่มต้น หรือไม่เช่นนั้นจะรอ option greeks จาก live
  • ยังตั้งค่าผ่าน DataTesterConfig ไม่ได้ ต้องตั้งค่า actor เองด้วย subscribe_option_chain และ OptionSeriesId

กลุ่ม 9: Lifecycle

ทดสอบพฤติกรรมใน lifecycle ของ actor: การจัดการ unsubscribe, การเก็บกวาดเมื่อ retire และพารามิเตอร์แบบกำหนดเอง

TCชื่อคำอธิบายข้ามเมื่อ
TC-D70Unsubscribe on stopunsubscribe จาก data feed เมื่อ actor หยุดไม่รองรับ unsub
TC-D71Custom subscribe paramsพารามิเตอร์การ subscribe เฉพาะของ adapterN/A
TC-D72Custom request paramsพารามิเตอร์การ request เฉพาะของ adapterN/A
TC-D73Retirement cleanupปล่อย data subscription ที่ actor ถือไว้N/A
TC-D74DeFi shared pool demandคง feed ของ pool ที่ใช้ร่วมกันไว้จนถึงเจ้าของรายสุดท้ายไม่รองรับ DeFi
TC-D75DeFi bootstrap cancelทิ้ง snapshot ของ pool bootstrap ที่ถูกยกเลิกไม่รองรับ DeFi

TC-D70: Unsubscribe on stop

FieldValue
Prerequisiteมี data subscription ที่ active อยู่ (quote, trade, book)
Actionหยุด actor โดยตั้ง can_unsubscribe เป็น true (ค่าเริ่มต้น)
Event sequencedata subscription ถูกลบออก และไม่ได้รับ data event อีก
Pass criteriaunsubscribe อย่างเรียบร้อย ไม่มี error ใน log และไม่มี data event หลังหยุด
Skip whenadapter ไม่รองรับ unsubscribe

Rust config:

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_quotes(true)
    .subscribe_trades(true)
    .can_unsubscribe(true)
    .build()?

TC-D71: Custom subscribe params

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และ adapter รับพารามิเตอร์การ subscribe เพิ่มเติมได้
Actionsubscribe ด้วย subscribe_params เฉพาะของ adapter
Event sequenceการ subscribe ถูกสร้างขึ้นโดยใช้พารามิเตอร์ที่กำหนด
Pass criteriaข้อมูลไหลเข้ามาโดยพารามิเตอร์เฉพาะของ adapter มีผล
Skip whenN/A (เฉพาะของ adapter)

Rust config:

use nautilus_core::Params;
use serde_json::json;

let subscribe_params = Params::new([("key".to_string(), json!("value"))].into());

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .subscribe_quotes(true)
    .subscribe_params(subscribe_params)
    .build()?

ข้อควรพิจารณา:

  • subscribe_params เป็นค่าทึบ (opaque) สำหรับ DataTester และถูกส่งผ่านไปยัง adapter โดยตรง
  • subscribe_params เป็นฟิลด์ที่มีเฉพาะใน Rust
  • ดูพารามิเตอร์ที่รองรับได้ในคู่มือของ adapter

TC-D72: Custom request params

FieldValue
Prerequisiteadapter เชื่อมต่อแล้ว และ adapter รับพารามิเตอร์การ request เพิ่มเติมได้
Actionrequest ข้อมูลด้วย request_params เฉพาะของ adapter
Event sequencerequest ได้รับการตอบสนองโดยใช้พารามิเตอร์ที่กำหนด
Pass criteriaได้รับข้อมูลย้อนหลังโดยพารามิเตอร์เฉพาะของ adapter มีผล
Skip whenN/A (เฉพาะของ adapter)

Rust config:

use nautilus_core::Params;
use serde_json::json;

let request_params = Params::new([("key".to_string(), json!("value"))].into());

DataTesterConfig::builder()
    .client_id(client_id)
    .instrument_ids(vec![instrument_id])
    .request_quotes(true)
    .request_params(request_params)
    .build()?

ข้อควรพิจารณา:

  • request_params เป็นค่าทึบ (opaque) สำหรับ DataTester และถูกส่งผ่านไปยัง adapter โดยตรง
  • request_params เป็นฟิลด์ที่มีเฉพาะใน Rust
  • ดูพารามิเตอร์ที่รองรับได้ในคู่มือของ adapter

TC-D73: Retirement cleanup

FieldValue
Prerequisiteactor มี subscription ที่อิงกับ venue และมี actor สองตัวใช้ bar ที่ aggregate ภายในร่วมกัน
Actionretire actor ตัวแรก แล้ว retire actor ตัวที่สองผ่าน trader
Event sequenceon_dispose ทำงานเสร็จ, command สำหรับ unsubscribe ถูกส่งออกไป และ actor ถูกยกเลิกการลงทะเบียน
Pass criteriaการ retire ครั้งแรกยังคงข้อมูลที่ใช้ร่วมกันไว้ การ retire ครั้งสุดท้ายปล่อย route ที่ถือไว้ และไม่เหลือ handler ของ actor ที่ retire แล้ว
Skip whenN/A

bar ที่ใช้ร่วมกันต้องยัง active หลัง actor ตัวแรก retire และหยุดหลัง actor ตัวสุดท้าย retire

ข้อควรพิจารณา:

  • DataTesterConfig ไม่ครอบคลุมการ retire หลาย actor ให้สร้าง actor สองตัวเอง แล้วลบออกผ่าน Trader::remove_actor
  • หาก on_dispose ล้มเหลว actor ต้องยังลงทะเบียนอยู่พร้อม subscription ครบถ้วน เพื่อให้การ retire ครั้งต่อไปปล่อย subscription ได้โดยไม่เรียก hook ที่ล้มเหลวซ้ำ
  • on_stop หรือ on_fault ที่ล้มเหลวต้องไม่ขัดขวางการ retire: การ dispose และการยกเลิกการลงทะเบียนต้องยังทำงานจนเสร็จ จาก state ระหว่างทางที่สอดคล้องกัน

TC-D74: DeFi shared pool demand

FieldValue
PrerequisiteDeFi data client หนึ่งตัว และ actor สองตัว subscribe pool เดียวกันผ่าน subscription type เดียวกันหรือที่ซ้อนทับกัน
Actionretire หรือ unsubscribe actor ตัวหนึ่ง แล้วอีกตัว โดยทดสอบทั้งสองลำดับ
Event sequenceการปล่อยครั้งแรกไม่ส่ง unsubscribe ไปยัง client สำหรับ type ที่ใช้ร่วมกัน การปล่อยครั้งสุดท้ายจะ unsubscribe และหยุด pool updater
Pass criteriaevent ของ pool ยังไปถึง actor ที่เหลือและ profiler จนถึงการปล่อยครั้งสุดท้าย และไม่มีอะไรไหลเข้ามาหลังจากนั้น
Skip whenadapter ไม่ให้บริการการ subscribe DeFi pool

ครอบคลุมการซ้อนทับเหล่านี้:

  • actor สองตัวที่ใช้ subscription type เดียวกัน retire ในลำดับใดก็ได้
  • SubscribePool คู่กับ type ที่แคบกว่าแต่ละแบบ (swap, การอัปเดต liquidity, การเก็บค่าธรรมเนียม, flash event) unsubscribe ทั้งสองลำดับ ตัวกรอง event ที่แคบกว่าต้องยัง active ตราบที่ยังมี subscription ใดเหลืออยู่
  • pool เดียวกันบน data client สองตัว client แต่ละตัวเก็บ demand ของตัวเอง และ pool updater ยัง active จนกว่าทั้งสอง จะปล่อย

ข้อควรพิจารณา:

  • DataTesterConfig ไม่ครอบคลุมการ subscribe DeFi pool ให้สร้าง actor เอง
  • การ unsubscribe ซ้ำจาก actor ตัวหนึ่งต้องไม่ปล่อย demand ของ actor อีกตัว

TC-D75: DeFi bootstrap cancel

FieldValue
PrerequisiteDeFi data client หนึ่งตัว และ pool ยังไม่อยู่ใน cache ดังนั้นการ subscribe จะ request snapshot ของ pool
Actionsubscribe, ปล่อยเจ้าของรายสุดท้ายก่อนที่นิยามของ pool จะมาถึง แล้ว subscribe อีกครั้ง
Event sequencesnapshot request สองครั้งถูกส่งออกไป และ response ของครั้งแรกมาถึงหลังการ subscribe ครั้งที่สอง
Pass criteriaengine ทิ้ง response แรก และมีเพียง response ของ request ปัจจุบันเท่านั้นที่ติดตั้ง profiler
Skip whenadapter ไม่ให้ snapshot ของ pool

ข้อควรพิจารณา:

  • การ subscribe ครั้งที่สองจะ request snapshot ใหม่ก็ต่อเมื่อ pool ยังไม่อยู่ใน cache เท่านั้น เมื่อนิยามของ pool จาก request แรกมาถึงแล้ว การ subscribe ครั้งถัดไปจะสร้าง profiler จาก pool ใน cache แทน case นี้จึงต้องการ response ที่มาช้า
  • การ reset engine หรือการ disconnect ก็ยกเลิก bootstrap ที่ค้างอยู่เช่นกัน response ที่มาถึงหลังจากนั้นต้องไม่ติดตั้ง profiler

เอกสารอ้างอิง configuration ของ DataTester

DataTesterConfig รับพารามิเตอร์ด้านล่าง ค่าเริ่มต้นคือค่าที่ resolve แล้วหลังการสร้าง การ request quote, trade และ bar ย้อนหลังใช้ช่วงย้อนหลังหนึ่งชั่วโมง ส่วนการ request funding rate ใช้เจ็ดวัน ช่วงย้อนหลังนี้ตั้งค่าผ่าน DataTesterConfig ไม่ได้

ParameterDefaultกลุ่มที่เกี่ยวข้อง
actor_idNoneทั้งหมด
client_idNoneทั้งหมด
instrument_ids[]ทั้งหมด
bar_typesNone5
subscribe_book_deltasfalse2
subscribe_book_depthfalse2
subscribe_book_at_intervalfalse2
subscribe_quotesfalse3
subscribe_tradesfalse4
subscribe_mark_pricesfalse6
subscribe_index_pricesfalse6
subscribe_funding_ratesfalse6
subscribe_barsfalse5
subscribe_instrumentfalse1
subscribe_instrument_statusfalse7
subscribe_instrument_closefalse7
subscribe_option_greeksfalse8
can_unsubscribetrue9
request_instrumentsfalse1
request_book_snapshotfalse2
request_book_deltasfalseยังไม่ได้ implement
request_quotesfalse3
request_tradesfalse4
request_barsfalse5
request_funding_ratesfalse6
book_depthNone2
book_interval_ms10002
book_levels_to_print102
manage_booktrue2
log_datatrueทั้งหมด
stats_interval_secs5ทั้งหมด
log_eventstrueทั้งหมด
log_commandstrueทั้งหมด

builder ของ Rust ยังมีพารามิเตอร์เหล่านี้ด้วย:

ParameterTypeDefaultกลุ่มที่เกี่ยวข้อง
book_typeBookTypeL2_MBP2
subscribe_paramsParams?None9
request_paramsParams?None9

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

ในหน้านี้

สิ่งที่ต้องเตรียมสเกลของ timestampความสอดคล้องของการ sync order bookข้อตกลงของ book streamระดับของการตรวจสอบแคตตาล็อกของ faultเทคนิคการบังคับให้เกิดสถานการณ์OracleStress harnessการตรวจสอบแบบ in-bandกลุ่ม 1: InstrumentTC-D01: Request instrumentsTC-D02: Subscribe instrumentTC-D03: Load specific instrumentกลุ่ม 2: Order bookTC-D10: Subscribe book deltasTC-D11: Subscribe book at intervalTC-D12: Subscribe book depthTC-D13: Request book snapshotTC-D14: Managed book from deltasกลุ่ม 3: QuoteTC-D20: Subscribe quotesTC-D21: Request historical quotesกลุ่ม 4: TradeTC-D30: Subscribe tradesTC-D31: Request historical tradesกลุ่ม 5: BarTC-D40: Subscribe barsTC-D41: Request historical barsกลุ่ม 6: ข้อมูลอนุพันธ์TC-D50: Subscribe mark pricesTC-D51: Subscribe index pricesTC-D52: Subscribe funding ratesTC-D53: Request historical funding ratesกลุ่ม 7: Instrument statusTC-D60: Subscribe instrument statusTC-D61: Subscribe instrument closeกลุ่ม 8: Option greeksTC-D62: Subscribe option greeksTC-D63: Subscribe option chainกลุ่ม 9: LifecycleTC-D70: Unsubscribe on stopTC-D71: Custom subscribe paramsTC-D72: Custom request paramsTC-D73: Retirement cleanupTC-D74: DeFi shared pool demandTC-D75: DeFi bootstrap cancelเอกสารอ้างอิง configuration ของ DataTester