NautilusTrader Docs · ภาษาไทย

Reports

คู่มือนี้อธิบายว่า report จาก ReportProvider ช่วยในการวิเคราะห์ portfolio, การทำบัญชี PnL และการวิเคราะห์ผลหลังรัน backtest อย่างไร

หมายเหตุ: ต้นฉบับมีตัวอย่างการสร้าง report เฉพาะ Python (pandas) จึงตัดออก หน้านี้คงไว้เฉพาะโครงสร้างของ report และแนวคิดที่ไม่ขึ้นกับภาษา

ภาพรวม

ReportProvider แปลง order, fill, position และ account state ที่อยู่ใน cache ให้เป็นตาราง (DataFrame) สำหรับการวิเคราะห์และการแสดงผล report เหล่านี้ช่วยประเมินผลงานของ strategy วิเคราะห์คุณภาพการ execute และตรวจสอบการทำบัญชี PnL report ชุดเดียวกันใช้ได้ทั้งใน backtest และ live trading ทำให้การประเมินผลงานและ การเปรียบเทียบ strategy สอดคล้องกันทั้งสองแบบ

สร้าง report ได้สองแนวทาง:

  • เมธอดของ backtest: generate_orders_report() และเมธอดในกลุ่มเดียวกันของ BacktestEngine จะอ่านจาก cache ของ engine เอง BacktestNode ก็มีเมธอดชุดเดียวกัน โดยรับ ID ของ run config เป็น argument แรก
  • ใช้ ReportProvider โดยตรง: ส่งชุดของ order หรือ position ใดก็ได้ เช่น cache ของ live node หรือผลการ query cache ที่กรองแล้ว

ทุกเมธอดจะคืนตารางว่างเมื่อไม่มีข้อมูลที่ตรงเงื่อนไข

Report ที่มีให้ใช้

ReportProvider มี static method ที่คืนตาราง (DataFrame) จากข้อมูลการเทรด แต่ละ report มี column และ index ของตัวเองสำหรับการวิเคราะห์

Orders report

สร้างภาพรวมของ order ทั้งหมด column ได้แก่:

Columnคำอธิบาย
client_order_idIndex - ตัวระบุ order ที่ไม่ซ้ำกัน
instrument_idinstrument ที่เทรด
strategy_idstrategy ที่สร้าง order
trader_idตัวระบุ trader
account_idตัวระบุ account (ถ้ามีการกำหนด)
venue_order_idorder ID ที่ venue กำหนด (ถ้าถูก accept)
sideBUY หรือ SELL
typeMARKET, LIMIT ฯลฯ
statusสถานะปัจจุบันของ order
quantityปริมาณเดิมของ order (string)
filled_qtyปริมาณที่ fill แล้ว (string)
priceราคา limit (string ขึ้นกับประเภท order)
avg_pxราคา fill เฉลี่ย (string ถ้ามีการ fill)
time_in_forceคำสั่ง time-in-force
ts_inittimestamp ตอน initialize order (Unix nanoseconds)
ts_lasttimestamp ของการอัปเดตล่าสุด (Unix nanoseconds)

column เพิ่มเติมจะแตกต่างกันตามประเภท order เช่น trigger_price สำหรับ stop order และ expire_time_ns สำหรับ order แบบ GTD

Order fills report

ให้สรุปของ order ที่ fill แล้ว (หนึ่งแถวต่อหนึ่ง order)

report นี้มีเฉพาะ order ที่ filled_qty > 0 มี column เหมือน orders report แต่กรองเฉพาะ order ที่ execute แล้ว และแปลง ts_init กับ ts_last เป็น datetime สำหรับการวิเคราะห์

Fills report

แสดงรายละเอียดของ fill event แต่ละรายการ (หนึ่งแถวต่อหนึ่ง fill) column ได้แก่:

Columnคำอธิบาย
client_order_idIndex - ตัวระบุ order
trade_idตัวระบุ trade/fill ที่ไม่ซ้ำกัน
venue_order_idorder ID ที่ venue กำหนด
instrument_idinstrument ที่เทรด
strategy_idstrategy ที่สร้าง order
account_idตัวระบุ account
position_idposition ID ที่เกี่ยวข้อง (ถ้ามี)
order_sideBUY หรือ SELL
order_typeประเภท order (MARKET, LIMIT ฯลฯ)
last_pxราคาที่ fill (string)
last_qtyปริมาณที่ fill (string)
currencyสกุลเงินของ fill
liquidity_sideMAKER หรือ TAKER
commissionจำนวนและสกุลเงินของค่า commission (string)
ts_eventtimestamp ของ fill (datetime)
ts_inittimestamp ตอน initialize (datetime)

report นี้ตัด column type ออก

Positions report

การวิเคราะห์ position รวมถึง snapshot ด้วย เมื่อสร้างจาก cache โดยตรง ให้ส่ง position snapshot ไปด้วย เพราะจำเป็นสำหรับยอดรวมของ OMS แบบ NETTING (report จากการรัน backtest ที่เสร็จแล้วจะรวม snapshot ให้อัตโนมัติ) column ได้แก่:

Columnคำอธิบาย
position_idIndex - ตัวระบุ position ที่ไม่ซ้ำกัน
instrument_idinstrument ที่เทรด
strategy_idstrategy ที่ดูแล position
trader_idตัวระบุ trader
account_idตัวระบุ account
opening_order_idorder ID ที่เปิด position
closing_order_idorder ID ที่ปิด position
entryฝั่งที่เข้า (BUY หรือ SELL)
sideฝั่งของ position (LONG, SHORT หรือ FLAT)
quantityขนาด position ปัจจุบัน (string)
peak_qtyขนาดสูงสุดที่เคยถึง (string)
avg_px_openราคาเข้าเฉลี่ย (decimal string)
avg_px_closeราคาออกเฉลี่ย (decimal string ถ้าปิดแล้ว)
commissionsค่า commission ที่จ่าย หนึ่งรายการต่อสกุลเงิน (list)
realized_pnlกำไร/ขาดทุนที่ realize แล้วใน cost currency (string)
realized_returnผลตอบแทนที่ realize แล้วเป็นอัตราส่วน (float) เช่น 0.05 คือ 5%
ts_inittimestamp ตอน initialize position (Unix nanoseconds)
ts_openedtimestamp ตอนเปิด (datetime)
ts_lasttimestamp ของการอัปเดตล่าสุด (Unix nanoseconds)
ts_closedtimestamp ตอนปิด (datetime หรือ NA)
duration_nsระยะเวลาของ position หน่วยนาโนวินาที
is_snapshotเป็น snapshot ในอดีตหรือไม่

แถวที่เป็น snapshot ใช้ index เป็น ID ที่สร้างขึ้นจาก position ID เดิม ให้ใช้ is_snapshot แทน index ในการแยกรอบที่ archive ไว้ออกจาก position ที่ยังเปิดอยู่ report นี้ตัด signed_qty, base_currency, quote_currency และ settlement_currency ออก

Account report

ติดตามการเปลี่ยนแปลงของ balance และ margin ของ account ตามเวลา

เมื่อสร้างจาก BacktestEngine ต้องระบุ venue หรือ account_id อย่างใดอย่างหนึ่ง หากไม่ระบุทั้งคู่จะเกิด error หากระบุทั้งคู่ account_id จะมีลำดับความสำคัญกว่า และ account ที่ไม่รู้จักจะได้ตารางว่าง

column ได้แก่:

Columnคำอธิบาย
ts_eventIndex - timestamp ที่ account state เปลี่ยน
account_idตัวระบุ account
account_typeประเภท account (เช่น CASH, MARGIN)
base_currencybase currency ของ account
totalยอด balance ทั้งหมด (string)
freebalance ที่ใช้ได้ (string)
lockedbalance ที่ถูก lock ไว้ใน order (string)
currencyสกุลเงินของ balance
reportedbalance ถูกรายงานโดย venue หรือไม่
marginsข้อมูล margin (list ถ้ามี)
infoข้อมูลเพิ่มเติมเฉพาะของ venue

แต่ละแถวแทนรายการ balance หนึ่งรายการ account ที่มีหลายสกุลเงินจะได้หลายแถวต่อ account state event หนึ่งครั้ง

ข้อควรพิจารณาในการทำบัญชี PnL

การทำบัญชี PnL ขึ้นอยู่กับการคำนวณ position, สกุลเงิน และ snapshot

PnL ที่อิงตาม position

  • Realized PnL: คำนวณเมื่อ position ถูกปิดบางส่วนหรือทั้งหมด
  • Unrealized PnL: mark-to-market ด้วยราคาปัจจุบัน Position.unrealized_pnl(last) จะ mark position ที่เปิดอยู่ด้วย Price ที่กำหนด
  • ผลของ commission: นับรวมเฉพาะเมื่ออยู่ใน cost currency ของ position ดู Positions ว่า commission ที่เป็น base currency ของคู่ spot จะไปปรับขนาด position แทนอย่างไร

position snapshot จะเก็บ PnL ในอดีตไว้เมื่อ position ที่ปิดแล้วถูกเปิดใหม่ภายใต้ ID เดิม ทั้งใน OMS แบบ NETTING และ HEDGING ให้รวม snapshot ไว้ใน report เพื่อให้คำนวณ PnL รวมได้ถูกต้อง ดู Position snapshotting สำหรับพฤติกรรมการเปิดใหม่และการกลับฝั่ง

การทำบัญชีหลายสกุลเงิน

เมื่อทำงานกับหลายสกุลเงิน:

  • แต่ละ position ติดตาม PnL ใน cost currency ของตัวเอง: quote สำหรับสัญญา linear, base สำหรับสัญญา inverse และ settlement สำหรับสัญญา quanto
  • การรวมระดับ portfolio ต้องแปลงสกุลเงิน Portfolio ทำได้ด้วย realized_pnls โดยระบุ target currency ซึ่งใช้ exchange rate ใน cache ดู Supported conversions
  • สกุลเงินของ commission อาจต่างจาก cost currency ของ position

ข้อควรพิจารณาเรื่อง snapshot

สำหรับ OMS แบบ NETTING ยอดรวมที่ถูกต้องของ instrument คือการบวก realized PnL ของแต่ละรอบที่ archive ไว้ เข้ากับ position ที่ยังเปิดอยู่ (รอบที่ archive ไว้ถูกเก็บภายใต้ ID ของ position ที่ยังเปิดอยู่ และควรรวมแยกตามสกุลเงิน) ดู Position snapshotting ว่า execution engine archive รอบที่ปิดแล้วอย่างไร

การวิเคราะห์หลังรัน backtest

เมื่อ backtest จบ สามารถวิเคราะห์ผลได้จาก result statistics และ report ที่สร้างขึ้น หรือเข้าถึง order, position และ position snapshot ใน cache ของ engine โดยตรงเพื่อวิเคราะห์ตามต้องการ

สถิติของ portfolio

ผลลัพธ์ของ backtest ให้ metric ด้านผลงาน แบ่งเป็นกลุ่ม stats_pnls (key ด้วยรหัสสกุลเงิน แล้วตามด้วยชื่อสถิติ), stats_returns (key ด้วยชื่อสถิติ) และ stats_general (key ด้วยชื่อสถิติ)

สถิติแต่ละตัวจะมีส่วนในกลุ่มที่มันมีการคำนวณรองรับ ได้แก่ realized PnL, returns หรือ positions สถิติที่เขียนเองสามารถอยู่ได้มากกว่าหนึ่งกลุ่ม

ดู คู่มือ Portfolio สำหรับชุดสถิติเริ่มต้น วิธีคำนวณของแต่ละกลุ่ม และความแตกต่างระหว่าง position returns กับ portfolio returns

report ถูกสร้างจากโครงสร้างข้อมูลในหน่วยความจำ สำหรับการวิเคราะห์ขนาดใหญ่หรือระบบที่รันต่อเนื่องเป็นเวลานาน ควรพิจารณาบันทึก report ลงฐานข้อมูลเพื่อให้ query ได้อย่างมีประสิทธิภาพ ดูตัวเลือกด้าน persistence ได้ที่ คู่มือ Cache

การทำงานร่วมกับ component อื่น

ReportProvider ทำงานร่วมกับ component หลายตัวในระบบ:

  • Cache: แหล่งข้อมูลการเทรดทั้งหมด (order, position, account) สำหรับ report
  • Portfolio: คำนวณสถิติของตัวเองจากข้อมูลชุดเดียวกันใน cache อย่างอิสระ ไม่ได้คำนวณจาก report เหล่านี้
  • BacktestEngine: มีเมธอดสร้าง report ที่ใช้วิเคราะห์ผลหลังรันและแสดงผล
  • Position snapshots: จำเป็นสำหรับการรายงาน PnL ที่ถูกต้องใน OMS แบบ NETTING
  • Visualization - tearsheet และกราฟแบบ interactive จากผล backtest
  • Portfolio - สถิติของ portfolio และ metric ด้านผลงาน
  • Backtesting - การรัน backtest ที่สร้าง report
  • Cache - ระบบ cache ที่เก็บข้อมูลสำหรับ report

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