此功能用於訂閱特定股票的 Tick數據,使用者可實時追蹤股價每一次的變動。
api.Quote.subscribe_tick('2883' ,odd_lot=False)
Try to subscribe stock[2883] quoteType[qtTick] is_odd[0] version[v1]
Tick_Stock_v1(
exchange='TWSE',
symbol='2883',
delay_time=0.0,
odd_lot=False,
datetime='20251208143000',
open=16.1,
high=16.25,
low=16.0,
close=16.2,
volume=33,
total_volume=33857.0,
chg_type=2,
price_chg=0.15,
pct_chg=0.93,
simtrade=0,
suspend=0,
amount=534.6
)
| 參數 | 資料型態 | 說明 |
|---|---|---|
| symbol | str | 指定欲訂閱的股票代碼,例如 '2883'。 |
| odd_lot | bool | True為零股,False為整股,默認為False。 |
此方法不直接返回值,而是會顯示訂閲相關信息。
訂閲成功後,當有新的成交數據時,系統會通過 callback 機制回傳
Tick 實體。
收到的 Tick 對象包含了該股票的實時交易數據:
| 參數 | 資料型態 | 說明 |
|---|---|---|
| exchange | str | 交易所代碼 |
| symbol | str | 股票代碼 |
| delay_time | float | 延遲時間 |
| odd_lot | bool | 是否為零股交易 |
| datetime | str | 數據的日期和時間,格式為 YYYYMMDDHHMMSS |
| open | float | 開盤價格 |
| high | float | 當日最高價格 |
| low | float | 當日最低價格 |
| close | float | 收盤價格 |
| volume | int | 最近一筆成交的股票數量 |
| total_volume | float | 當日累計成交股票數量 |
| chg_type | int | 漲跌註記 |
| price_chg | float | 與參考價格相比的價格變動 |
| pct_chg | float | 股價百分比變動 |
| simtrade | int | 試撮標示:0 表示非試撮交易;1 表示試撮交易 |
| suspend | int | 股票是否暫停交易 |
| amount | float | 最近一筆成交的金額 |