此功能用於訂閱特定股票的 BidAsk 數據,使用者可實時追蹤股價每一次的變動。
目前僅提供TXF此檔商品供訂閱
api.FutQuote.subscribe_bidask('TXF')
Try to subscribe future[TXF] quoteType[qtBidAsk] version[v0]
BidAsk_Future_v0(
exchange='TAIFEX',
symbol='TXFL5',
delay_time=0.002,
datetime='20251208180950',
bid_prices=[28295.0, 28294.0, 28293.0, 28292.0, 28291.0],
bid_volumes=[4, 6, 9, 10, 8],
ask_prices=[28298.0, 28299.0, 28300.0, 28301.0, 28302.0],
ask_volumes=[3, 8, 11, 13, 7]
)
| 參數 | 資料型態 | 說明 |
|---|---|---|
| symbol | str | 指定欲訂閱的股票代碼,例如 'TXF'。 |
此方法不直接返回值,而是會顯示訂閲相關信息。訂閲成功後,當有新的成交數據時,系統會通過 callback 機制回傳 BidAsk 實體。
每個 BidAsk 實體包含以下詳細資訊:
| 參數 | 資料型態 | 說明 |
|---|---|---|
| exchange | str | 交易所代碼 |
| symbol | str | 股票代碼 |
| delay_time | float | 延遲時間 |
| datetime | str | 數據的日期和時間,格式為 YYYYMMDDHHMMSS |
| bid_prices | list | 買方價格列表 |
| bid_volumes | list | 買方價格的數量列表 |
| ask_prices | list | 賣方價格列表 |
| ask_volumes | list | 賣方價格的數量列表 |