附錄 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) | 判斷是否持有多頭部位 |