ลำดับการทำงานของ Backtest Execution
backtest loop จะประมวลผลสถานะตลาดก่อนเรียก callback ของ strategy จากนั้นจึง settle command ที่เกิดขึ้น ใน timestamp เดียวกัน
ลำดับของข้อมูลและ message
backtest loop หลักจะนำ market data ใหม่ไปประมวลผลเพื่อ execute order ก่อนที่ data engine จะ dispatch ข้อมูลนั้นไปยัง actor และ strategy
ลำดับการทำงานของ main loop
สำหรับข้อมูลแต่ละจุด engine จะทำงานสามขั้นตอน:
- การประมวลผลของ exchange: simulated exchange อัปเดต order book จาก market data ที่เข้ามา และ iterate matching engine ซึ่งจะ fill order ที่มีอยู่เดิมซึ่ง match กับสถานะตลาดใหม่
- Callback ของ strategy: data engine dispatch ข้อมูลไปยัง actor และ strategy ผ่าน
callback (เช่น
on_quote,on_bar) strategy อาจ submit, cancel หรือ modify order ระหว่าง callback เหล่านี้ได้ - การ settle venue: engine ดึง venue command ที่อยู่ในคิวออกมาทั้งหมด แล้ว iterate matching engine เพื่อ fill
order ที่เพิ่ง submit ทำซ้ำจนกว่าจะไม่มี command ที่พร้อมทำงาน ดังนั้น order ที่เกิดต่อเนื่องกัน (เช่น hedge
ที่ submit จาก
on_order_filled) จะ settle ภายใน timestamp เดียวกัน ส่วน command ที่ถูกหน่วงด้วย latency ก่อนหน้านั้นจะเป็นไปตามกฎระดับ instrument ใน การ settle command
sequenceDiagram
participant BL as Backtest Loop
participant Exch as SimulatedExchange
participant ME as MatchingEngine
participant DE as DataEngine
participant Stgy as Strategy
BL->>BL: next data point (ts=T)
rect rgb(240, 248, 255)
note right of BL: Phase 1 - Exchange processes data
BL->>Exch: process_quote_tick / process_bar
Exch->>ME: update book + iterate()
note right of ME: Matches existing orders<br/>against new market state
note right of ME: Option expiry cancels open orders<br/>Settlement waits for the expiry timer
end
rect rgb(245, 255, 245)
note right of BL: Phase 2 - Strategy receives data
BL->>DE: process(data)
DE->>Stgy: on_quote() / on_bar()
Stgy-->>Exch: submit_order (queued or immediate)
end
rect rgb(255, 248, 240)
note right of BL: Phase 3 - Settle venues
BL->>BL: _process_and_settle_venues(T)
BL->>Exch: _drain_commands(T)
note right of Exch: Processes queued commands,<br/>adds orders to matching core
BL->>ME: _core.iterate(T)
note right of ME: Matches newly added orders<br/>against current market state
note right of ME: Fills may trigger strategy callbacks<br/>that enqueue further commands,<br/>repeats until no eligible commands
BL->>Exch: run simulation modules
end
สามขั้นตอนนี้ทำให้ order ที่วางรออยู่ (resting order) เห็นข้อมูลตลาดที่เข้ามาก่อน order ที่เพิ่ง submit
timer event ใช้กลไก settle แบบเดียวกัน โดยจัดเป็นกลุ่มตาม timestamp callback ทั้งหมดที่ timestamp T จะทำงานก่อน จากนั้น venue จะ settle สำหรับ T ก่อนที่ clock จะเดินไป T+1 timestamp ที่มีเพียง timer ของ portfolio snapshot จะไม่ปล่อย command เก่าที่ถูกเลื่อนด้วย latency
สำหรับ timer ที่ใช้กับ bar ที่ aggregate ภายใน ดู จังหวะเวลาของการ aggregate bar ภายใน
การเลื่อน settlement ของ option
ที่ timestamp หมดอายุของ option การตรวจสอบการหมดอายุอัตโนมัติจะปิดตลาดของ option นั้น cancel order ที่เปิดอยู่ และ reject order ใหม่ การ settle position จะรอจนกว่า market data ทั้งหมดที่ timestamp นั้นถูกประมวลผลแล้ว เพื่อให้ settlement เห็นราคา underlying ล่าสุดที่มีสำหรับ timestamp นั้น
InstrumentClose ที่ระบุชัดเจนด้วย InstrumentCloseType::ContractExpired จะพยายาม settle ทันที
batch แบบ streaming ต้องเก็บ ข้อมูลทั้งหมดของ timestamp เดียวกันไว้ด้วยกัน ซึ่ง BacktestNode ทำให้อัตโนมัติ
SimulatedVenueConfig.defer_option_settlement มีค่า default เป็น true backtest engine จะกำหนดเวลา
settlement หลังจาก market data ทั้งหมดที่ timestamp หมดอายุ โดยไม่ต้องรอ timestamp ถัดไป
เมื่อขับ SimulatedExchange โดยตรง ให้กำหนดเวลาการประมวลผลการหมดอายุไว้หลังข้อมูลของ timestamp นั้น
หรือตั้ง defer_option_settlement เป็น false อย่างชัดเจนเพื่อ settle ทันที การ settle ทันที
อาจใช้ ราคา underlying ที่เก่ากว่า หากยังมี update ที่ timestamp เดียวกันที่ยังไม่ได้ประมวลผล
การ settle command
Command ในรอบเดียวกัน
fill ของ order อาจกระตุ้น callback ของ strategy ที่ submit order อื่น เช่น stop-loss จาก
on_order_filled engine จะดึงคิว venue command และประมวลผล command ที่เกิดจาก event เหล่านั้น
จนกว่าจะไม่มี command ที่พร้อมทำงานในรอบปัจจุบัน command ที่สร้างขึ้นใน timestamp นั้นและถึงกำหนดแล้วจะ settle
ภายในรอบเดียวกัน รวมถึง command แบบ zero-latency และ same-tick ของ instrument อื่นด้วย
simulation module จะทำงานครั้งเดียว หลังจาก command loop เสร็จสิ้น
Command ที่ถูกหน่วงด้วย latency
LatencyModel จะวาง command แต่ละตัวไว้ในคิว inflight ของ venue
พร้อม timestamp ที่จะมาถึง เมื่อ command ถึงกำหนด จุด settlement จะเป็นตัวกำหนดว่า
engine จะปล่อย command นั้นหรือไม่:
| จุด settlement | Command ที่ถึงกำหนดซึ่งถูกปล่อย |
|---|---|
| Market data | command ใน timestamp เดียวกัน และ command เก่าของ instrument ของข้อมูลนั้น |
| เฉพาะ timer ของ portfolio snapshot | command ใน timestamp เดียวกัน |
| timer อื่น ๆ | command ทั้งหมดที่ถึงกำหนด ณ timestamp ของ timer |
| การ settle funding rate | command ทั้งหมดที่ถึงกำหนด ณ timestamp ของ funding settlement |
| การ drain ตอน shutdown | command ทั้งหมดที่ถึงกำหนดขณะที่ clock เดินผ่านเวลามาถึงของ inflight ตัวสุดท้าย |
market data ของ instrument อื่นจะไม่ทำให้ command เก่าทำงานกับสถานะตลาดที่ล้าสมัย command ที่มี timestamp มาถึงในอนาคตจะยังอยู่ในคิว inflight
Inbound latency ของ sandbox
SandboxExecutionClientConfig.latency_model รับ StaticLatencyModel โดยใช้รูปแบบเดียวกับการตั้งค่า
fee_model model นี้จะหน่วง submit, modify และ cancel ตามขา insert, update และ delete ของ
model ตามลำดับ ก่อนที่จะไปถึง matching engine
event ที่ venue สร้างขึ้น (accept, fill, cancel, expiration) จะไม่ถูกหน่วง ดังนั้น model จึงครอบคลุม เฉพาะ ขาขาเข้า (inbound leg) หากไม่มี latency model พฤติกรรมของ client จะไม่เปลี่ยนแปลง
หมายเหตุ: ต้นฉบับมีเฉพาะตัวอย่าง Python จึงตัดออก
จังหวะเวลาของ event และ command
event ของ client แต่ละตัวใช้ execution channel ของ runner ตามลำดับที่ปล่อยออกมา ไม่ว่าจะมี latency model หรือไม่:
OrderSubmittedของ order จะมาก่อน venue event ของ order นั้น- fill จาก market data จะมาก่อน response ของ command ใด ๆ ที่ถูกปล่อยหลังจากนั้น
จังหวะเวลาของ command:
- command จะมีผลก่อน market data ใด ๆ ที่ประมวลผลหลังเวลาที่ถึงกำหนด client จะ drain คิวก่อน แต่ละ tick และ clock alert ของ client จะปล่อย command ในคิวเมื่อไม่มีข้อมูลไหลเข้ามา
- command ที่มีขา latency เป็นศูนย์จะมีผลทันทีที่มาถึง เว้นแต่มี command อื่นที่ถึงกำหนดแล้วแต่ยังไม่ถูกปล่อย ในกรณีนั้น command จะต่อคิวหลัง command ดังกล่าว
- cancel-all จะ cancel เฉพาะ order ที่ venue ได้รับแล้วเท่านั้น order ที่ submit ยังอยู่ระหว่างทาง จะไม่ถูกแตะต้องจนกว่า venue จะประมวลผล submit นั้น
Contingent order
ทั้งใน backtest และ sandbox การทำงานแบบ contingent จะเคารพการรับของ venue:
- fill, update, expiration และ cancellation ไม่สามารถ activate, แก้ไข หรือ cancel order ที่ผูกกันอยู่ ซึ่ง venue ยังไม่ได้รับได้
- submit list แต่ละชุดจะมาถึงพร้อมกันเป็นหน่วยเดียว
- OTO child ที่ venue ได้รับแล้วยังคง activate ได้เมื่อ parent ถูก fill
- submit ที่มาช้าจะถูกตรวจสอบกับสถานะปัจจุบันของ order ที่ผูกกันอยู่ และอาจถูก reject หาก order ที่ผูกไว้ ปิดไปแล้ว
- การเปลี่ยนจำนวนแบบ contingent ที่ถูกข้ามไปก่อน venue ได้รับ จะไม่ถูก replay เมื่อ submit มาถึง order จะคง จำนวนที่ submit ไว้ เว้นแต่มีกฎอื่นที่เกี่ยวข้องเปลี่ยนแปลงมัน
การหยุดขณะที่มี command อยู่ระหว่างทาง
การหยุด client จะทิ้งทุกอย่างที่ยังอยู่ระหว่างทาง:
- submit, modify หรือ cancel แบบระบุเป้าหมายที่ถูกทิ้งจะถูก reject (
OrderRejected,OrderModifyRejected,OrderCancelRejected) เพื่อไม่ให้ order ค้างอยู่ในสถานะSUBMITTEDหรือ pending ตลอดไป เนื่องจาก sandbox ไม่สร้าง order status report จึงไม่มีอะไรอื่นมา resolve ให้ CancelAllOrdersที่ถูกทิ้งจะถูกละไป strategy ไม่ได้ mark order ใดเป็นPENDING_CANCELสำหรับมัน จึงไม่มีสถานะ pending ที่ต้องปล่อย
ความหมายของการ shutdown
BacktestEngine::end() แยกจากการตั้งค่า shutdown_on_error ใน
backtest API และการรันซ้ำ มันจะเรียก handler on_stop
ของแต่ละ strategy แล้ว drain และ settle command ที่ปล่อยออกมา (เช่น close_all_positions, cancel_all_orders)
จากนั้นจึงหยุด engine
- command จาก
on_stopใช้การเข้าคิวและ latency ของ venue ตามปกติ ไม่ได้รับสิทธิ์ก่อน command inflight ที่มาก่อนหน้า - หาก order ที่ส่งก่อนหยุดไปถึง venue ก่อน cancel จาก
on_stopก็ยังอาจถูก fill ได้ และ close แบบ reduce-only ที่ตามมาทีหลังอาจถูก reject หาก fill นั้นเปลี่ยน net exposure ไปแล้ว - strategy ที่ต้องการปิด position อย่าง deterministic ควรเข้าสู่สถานะ exit-only ก่อนหยุด และ หลีกเลี่ยงการเปิด order ใหม่ขณะที่ command cancel และ close ยังอยู่ระหว่างทาง
- event handler ของ strategy จะไม่ทำงานสำหรับ event ที่เกิดตามมา เพราะ strategy อยู่ในสถานะ
Stoppedแล้วOrderFilledและ event ที่คล้ายกันจะถูก log แต่ข้ามon_order_filledและ handler ที่เกี่ยวข้อง logic ที่ตอบสนองต่อ fill ต้องทำงานก่อนที่on_stopจะ return - simulation module จะไม่ทำงานซ้ำตอน shutdown
SimulationModule::processทำงานครั้งเดียวต่อ timestamp การเรียก ครั้งที่สองจะทำให้ผลข้างเคียงถูกนำไปใช้ซ้ำ เช่น ดอกเบี้ย FX rollover LatencyModelจะเพิ่ม delay ให้กับ command ท้าย ๆ (command ที่ปล่อยออกมาใน data tick สุดท้ายหรือในon_stop) เส้นทาง shutdown จะเลื่อน clock ของ engine ไปยัง timestamp ที่ inflight ตัวล่าสุดมาถึง เพื่อให้ command เหล่านั้นยัง settle ได้ก่อน engine หยุด
Backtest ที่มีเฉพาะ timer
backtest engine รองรับการรันที่มี timer แต่ไม่มี market data ซึ่งมีประโยชน์สำหรับงานที่ตั้งเวลาไว้ หรือการทดสอบ logic ที่ขึ้นกับ timer timer จะทำงานตามลำดับเวลา
Trade ID แบบ deterministic
simulated exchange (ใช้ทั้งใน backtest และ sandbox execution) จะปล่อย TradeId แบบ deterministic สำหรับ
fill แต่ละตัวที่สร้างขึ้น ID มีรูปแบบ T-{hash:016x}-{count:03d} ส่วน hex 16 ตัวอักษรคือ hash แบบ FNV-1a ของ
(venue, raw_id, ts_init) ส่วนตัวนับท้ายใช้แยก fill หลายตัวที่ ts_init เดียวกัน (เช่น
หลาย leg ของ fill ที่ขับเคลื่อนด้วย bar)
Trade ID แบบ deterministic มีคุณสมบัติดังนี้:
- Deterministic ข้ามการรัน: ข้อมูลที่ replay ชุดเดียวกันจะได้
TradeIdเดียวกันทุกครั้ง ทำให้ การ dedup ในขั้นถัดไปและการเปรียบเทียบกับ golden output มีความเสถียร - ไม่ชนกันข้ามการ reset:
ts_initถูกตรึงไว้ในข้อมูล backtest และเพิ่มขึ้นเสมอใน live/sandbox ดังนั้นBacktestEngine.reset()จึงไม่สามารถสร้างTradeIdที่ชนกับตัวที่อยู่ใน cache แล้วได้ การรับประกันเดียวกัน ใช้กับการ resetIdsGeneratorในหน่วยความจำใน sandbox ที่มี order ถูก persist ไว้ด้วย - ความยาวจำกัด: hash ทำให้ identifier ยาวไม่เกินขีดจำกัด 36 ตัวอักษรของ
TradeIdไม่ว่า ชื่อ venue จะยาวเท่าใด
flag use_random_ids ของ venue ยังคงควบคุมการสร้าง VenueOrderId และ PositionId แต่
TradeId จะเป็นแบบ deterministic เสมอและไม่ได้รับผลจาก flag นี้
แปลจาก เอกสาร NautilusTrader © Nautech Systems Pty Ltd และผู้ร่วมพัฒนา เผยแพร่ภายใต้ LGPL-3.0 ฉบับแปลนี้ตัดเนื้อหาเฉพาะ Python ออกและเน้น Rust