此功能用於訂閱特定股票的 BidAsk數據,使用者可實時追蹤股價每一次的變動。
api.Quote.subscribe_bidask('2883' ,odd_lot=False)
Try to subscribe stock[2883] quoteType[qtBidAsk] is_odd[0] version[v1]
BidAsk_Stock_v1(
exchange='TWStock',
symbol='2883',
delay_time=0.0,
odd_lot=False,
datetime='20251208143000',
bid_prices=[16.15, 16.1, 16.05, 16.0, 15.95],
bid_volumes=[1337, 1109, 2616, 3679, 1200],
ask_prices=[16.2, 16.25, 16.3, 16.35, 16.4],
ask_volumes=[1962, 6890, 6840, 2597, 1653],
diff_ask_vol=[1962, 6890, 6840, 2597, 1653],
diff_bid_vol=[1337, 1109, 2616, 3679, 1200],
simtrade=0,
suspend=0
)
| 參數 | 資料型態 | 說明 |
|---|---|---|
| symbol | str | 指定欲訂閱的股票代碼,例如 '2883'。 |
| odd_lot | bool | True為零股,False為整股,默認為False。 |
此方法不直接返回值,而是會顯示訂閲相關信息。訂閲成功後,當有新的成交數據時,系統會通過 callback 機制回傳 BidAsk 實體。
每個 BidAsk 實體包含以下詳細信息:
| 參數 | 資料型態 | 說明 |
|---|---|---|
| exchange | str | 交易所代碼 |
| symbol | str | 股票代碼 |
| delay_time | float | 延遲時間 |
| odd_lot | bool | 是否為零股交易 |
| datetime | str | 數據的日期和時間,格式為 YYYYMMDDHHMMSS |
| bid_prices | list | 買方價格列表 |
| bid_volumes | list | 買方價格的數量列表 |
| ask_prices | list | 賣方價格列表 |
| ask_volumes | list | 賣方價格的數量列表 |
| diff_ask_vol | list | 賣價增減量 |
| diff_bid_vol | list | 買價增減量 |
| simtrade | int | 試撮標示:0 表示非試撮交易;1 表示試撮交易 |
| suspend | int | 股票是否暫停交易 |