NautilusTrader Docs · ภาษาไทย

Synthetics

Synthetic instrument คือ instrument ที่กำหนดขึ้นที่ฝั่ง local โดยราคาได้มาจาก instrument อื่น สามารถรวม component จาก venue เดียวหรือหลาย venue แล้วนำผลลัพธ์มาแสดงเป็น instrument มาตรฐานของ Nautilus ภายใต้ venue code สังเคราะห์ SYNTH

synthetic instrument มีประโยชน์สำหรับ:

  • ให้ component ประเภท DataActor และ Strategy subscribe feed ของ quote หรือ trade ได้
  • trigger emulated order จากราคาที่คำนวณขึ้น
  • สร้าง bar จาก quote หรือ trade สังเคราะห์

synthetic instrument ซื้อขายโดยตรงไม่ได้ มันมีอยู่เฉพาะภายในแพลตฟอร์มฝั่ง local และใช้ เป็นเครื่องมือวิเคราะห์ ในอนาคต Nautilus อาจรองรับการซื้อขาย instrument ที่เป็น component โดยอิงจาก พฤติกรรมของ synthetic instrument

ภาษาของ formula

synthetic instrument แต่ละตัวกำหนด formula สำหรับคำนวณราคา Nautilus จะประเมิน formula นี้ด้วย expression engine เชิงตัวเลขที่มีมาในตัว แล้วแปลงผลลัพธ์ตัวเลขสุดท้ายเป็น Price ของ synthetic

Syntax ที่รองรับ

formula สามารถอ้างอิงค่า InstrumentId ของ component ได้โดยตรง รวมถึง ID ที่มี / และ -

ConstructExampleNotes
Component referenceBTCUSDT.BINANCEใช้ข้อความ InstrumentId ดิบ
Component referenceAUD/USD.SIMID ที่มี / ใช้ได้
Component referenceETH-USDT-SWAP.OKXID ที่มี - ใช้ได้
Numeric literal1, 0.5, 1.2e-3ประเมินด้วย semantics ของ f64
Boolean literaltrue, falseใช้ในเงื่อนไขและ logical expression
Parentheses(a + b) / 2ใช้วงเล็บเพื่อเปลี่ยนลำดับความสำคัญ
Unary operators-x, !flagunary - กลับเครื่องหมายตัวเลข unary ! กลับค่า boolean
Binary operators+ - * / % ^, == !=, < <= > >=, && ||arithmetic ทำงานกับตัวเลข logical operator ทำงานกับ boolean
Local assignmentspread = a - b; spread / 2statement ทำงานจากซ้ายไปขวา และ formula ต้องจบด้วยค่า
Comments// line, /* block */comment จะถูกละเว้น

formula ใหม่ควรใช้ค่า InstrumentId ดิบ เพื่อความเข้ากันได้ย้อนหลัง formula ที่แทน - ด้วย _ ใน component ID ยังคงใช้ได้

ลำดับความสำคัญของ operator

expression engine ประเมิน operator ตามลำดับต่อไปนี้ จากลำดับความสำคัญสูงสุดไป ต่ำสุด:

LevelOperatorsNotes
Highest^ยกกำลัง เชื่อมจากขวา (right associative)
Unary -, unary !-2 ^ 2 ประเมินเป็น -(2 ^ 2)
*, /, %คูณ, หาร และ modulo
+, -บวกและลบ
<, <=, >, >=การเปรียบเทียบตัวเลข
==, !=เท่ากันและไม่เท่ากัน ทั้งสองฝั่งต้องเป็น type เดียวกัน
Lowest&&, ||operator แบบ boolean

assignment ไม่ใช่ expression operator ให้คั่น statement ด้วย ; และให้ statement สุดท้าย เป็นค่าที่ต้องการให้ synthetic สร้างออกมา

ฟังก์ชันในตัว

FunctionSignatureNotes
absabs(x)ค่าสัมบูรณ์
ceilceil(x)ปัดขึ้น
floorfloor(x)ปัดลง
roundround(x)ปัดเป็นจำนวนเต็มที่ใกล้ที่สุดตามกฎ f64 ของ Rust
minmin(x1, x2, ...)รับ argument ตัวเลขตั้งแต่หนึ่งตัวขึ้นไป
maxmax(x1, x2, ...)รับ argument ตัวเลขตั้งแต่หนึ่งตัวขึ้นไป
ifif(condition, when_true, when_false)condition ต้องเป็น boolean ทั้งสอง branch ต้องเป็น type เดียวกัน และจะประเมินเฉพาะ branch ที่ถูกเลือก

กฎของ type

  • input จาก component เป็นตัวเลข
  • arithmetic operator ต้องการ operand เป็นตัวเลขและคืนผลเป็นตัวเลข
  • <, <=, >, >= ต้องการ operand เป็นตัวเลขและคืนผลเป็น boolean
  • == และ != รับ type ใดก็ได้ที่ตรงกัน (ตัวเลขทั้งคู่หรือ boolean ทั้งคู่) และคืนผลเป็น boolean
  • &&, || และ unary ! ต้องการ operand เป็น boolean
  • && และ || เป็นแบบ short-circuit ฝั่งขวาจะถูกประเมินเฉพาะเมื่อจำเป็น
  • local variable ต้องถูก assign ก่อนใช้งาน
  • ชื่อ local variable ต้องขึ้นต้นด้วยตัวอักษร ASCII หรือ _ และตามด้วยตัวอักษร ASCII, ตัวเลข หรือ _
  • ผลลัพธ์สุดท้ายของ formula ต้องเป็นตัวเลข formula ที่จบด้วย assignment หรือให้ผลเป็น boolean ใช้กับ synthetic instrument ไม่ได้

ข้อจำกัด

expression engine บังคับใช้ข้อจำกัดตอน compile ต่อไปนี้ formula ที่เกินข้อจำกัดจะ เกิด error ที่ชัดเจนตอนสร้าง

LimitValueDescription
Stack depth32จำนวนค่าระหว่างกลางสูงสุดบน evaluation stack
Local variables16จำนวนชื่อ local variable ที่ไม่ซ้ำกันสูงสุด
Nesting depth128ความลึกสูงสุดของการซ้อน syntax และ expression tree โดย expression ระดับบนสุดนับเป็นหนึ่งระดับ

weighted sum ของ 8 component ใช้ stack depth สูงสุด 3 และไม่มี local เลย weighted sum ของ N component จะสร้าง tree ที่ลึก N + 1 ดังนั้นข้อจำกัด nesting depth จึงจำกัด weighted sum ไว้ที่ 127 component

ตัวอย่าง

  • spread แบบง่าย: BTCUSDT.BINANCE - ETHUSDT.BINANCE
  • ค่าเฉลี่ยของคู่ FX สองคู่: (AUD/USD.SIM + NZD/USD.SIM) / 2
  • นำค่าระหว่างกลางมาใช้ซ้ำ: spread = BTCUSDT.BINANCE - ETHUSDT.BINANCE; spread / 2
  • output แบบมีเงื่อนไข: if(BTCUSDT.BINANCE > ETHUSDT.BINANCE, BTCUSDT.BINANCE, ETHUSDT.BINANCE)

การสร้าง synthetic instrument

ก่อนสร้าง synthetic instrument ต้องแน่ใจว่า instrument ที่เป็น component ทั้งหมดมีอยู่ใน cache แล้ว ให้ subscribe feed ของ quote หรือ trade ของแต่ละ component รวมถึงของ synthetic ด้วย quote สังเคราะห์ได้มาจาก quote ของ component เท่านั้น และ trade สังเคราะห์ได้มาจาก trade ของ component เท่านั้น

เมื่อ tick ของ component มาถึง engine จะรวมเข้ากับราคาล่าสุดใน cache ของ component อื่น เพื่อ คำนวณราคาสังเคราะห์ จนกว่า ทุก component จะมี tick อย่างน้อยหนึ่งครั้ง synthetic จะไม่ publish อะไรออกมาเลย

หมายเหตุ: ต้นฉบับมีเฉพาะตัวอย่าง Python (สร้าง synthetic แทน spread ระหว่าง BTCUSDT.BINANCE และ ETHUSDT.BINANCE จาก actor หรือ strategy) จึงตัดออก

instrument_id ของ synthetic อยู่ในรูป {symbol}.SYNTH เช่น symbol BTC-ETH:BINANCE จะได้ BTC-ETH:BINANCE.SYNTH

การอัปเดต formula

สามารถอัปเดต formula ของ synthetic ได้ทุกเมื่อ

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

Trigger instrument ID

สามารถ trigger emulated order จากราคาสังเคราะห์ได้ โดย synthetic instrument จะปล่อย emulated order ออกไปเมื่อราคาสังเคราะห์ถึงเงื่อนไข trigger (กำหนดผ่าน emulation_trigger และ trigger_instrument_id ของ order)

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

ประสิทธิภาพ

formula ถูก compile ครั้งเดียวตอนสร้าง และถูกประเมินทุกครั้งที่ tick ราคาของ component เข้ามา expression engine ใช้ stack ของ f64 ที่ไม่มีการ allocate หน่วยความจำ (zero-allocation) ในการประเมิน จึงเพิ่ม overhead น้อยมากต่อเส้นทาง การประมวลผล tick

วัดบน Apple M4 Pro, rustc 1.94.1, release profile (opt-level 3):

การประเมิน (hot path)

Formula patternTime
(A + B) / 2.012 ns
A * 0.4 + B * 0.3 + C * 0.2 + D * 0.118 ns
if(A > B, A - B, B - A)12 ns
spread = A - B; mid = ...; mid + ...19 ns
max(min(A, B * 20), abs(A - B))15 ns

การ scale ของการประเมิน (weighted sum)

ComponentsTime
214 ns
418 ns
828 ns

การ compile (cold path)

Formula patternTime
Simple average675 ns
4-input weighted1.4 us
Conditional1.0 us
With locals1.3 us
Hyphenated IDs755 ns

การจัดการ error

Nautilus validate synthetic instrument ในทุกขอบเขต การ compile formula จะปฏิเสธ symbol ที่ไม่รู้จัก, error ด้าน type และการใช้ capacity เกิน ส่วนการประเมินจะปฏิเสธจำนวน input ที่ไม่ถูกต้องและราคาที่ไม่ใช่ค่าจำกัด (NaN, Infinity) ก่อนที่ค่าเหล่านั้นจะไปถึง formula

ดูข้อกำหนดของ input และ error ได้ที่ Rust API reference

  • Instruments - นิยามของ instrument และ instrument type เฉพาะของแต่ละ venue
  • Data - market data type ที่อ้างอิงถึง instrument
  • Orders - order สามารถใช้ synthetic instrument ID เป็น emulation trigger ได้

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