附錄 B:API 速查表策略開發中最常用的函數與對象方法參考

1. 數據訂閱 (Data Subscriptions)

方法用途
self.subscribe_quote_ticks(instrument_id)訂閱最佳買賣價報價
self.subscribe_trade_ticks(instrument_id)訂閱逐筆成交數據
self.subscribe_bars(bar_type)訂閱 K 線數據 (Bar)
self.subscribe_order_book_at_interval(instrument_id, depth, interval_ms)定時獲取訂單簿快照

2. 訂單管理 (Order Management)

方法用途
self.order_factory.market(...)創建市價訂單
self.order_factory.limit(...)創建限價訂單
self.order_factory.stop_market(...)創建止損市價單
self.submit_order(order)提交訂單到執行引擎
self.cancel_order(order)取消特定訂單
self.cancel_all_orders(instrument_id)取消特定品種的所有掛單

3. 緩存查詢 (Cache Queries)

方法用途
self.cache.instrument(instrument_id)獲取金融工具定義
self.cache.orders_open(instrument_id)查詢當前所有掛單
self.cache.positions_open(instrument_id)查詢當前品種持倉
self.cache.quote_tick(instrument_id)獲取最新報價快照
self.cache.bar(bar_type)獲取最新一根 Bar
self.cache.account(account_id)查詢帳戶餘額和狀態

4. 投資組合 (Portfolio)

方法用途
self.portfolio.unrealized_pnl(instrument_id)獲取特定品種未實現盈虧
self.portfolio.realized_pnl()獲取總已實現盈虧
self.portfolio.is_flat(instrument_id)判斷特定品種是否無持倉
self.portfolio.is_net_long(instrument_id)判斷是否持有多頭部位