此功能用於訂閱特定股票的 Tick數據,使用者可實時追蹤股價每一次的變動。
api.USQuote.subscribe_tick('TSM')
Try to subscribe usstock[TSM] quoteType[qtTick] version[v1]
Tick_USStock_v1(
symbol='TSM',
delay_time=0.0,
datetime='20251205160000',
open=296.05,
high=300.8,
low=293.25,
close=294.72,
volume=0,
total_volume=10275297,
price_chg=1.79,
pct_chg=0.61,
amount=0
)
| 參數 | 資料型態 | 說明 |
|---|---|---|
| symbol | str | 指定欲訂閱的股票代碼,例如 'TSM'。 |
此方法不直接返回值,而是會顯示訂閲相關信息。
訂閲成功後,當有新的成交數據時,系統會通過 callback 機制回傳
Tick 實體。
收到的 Tick 對象包含了該股票的實時交易數據:
| 參數 | 資料型態 | 說明 |
|---|---|---|
| symbol | str | 股票代碼 |
| delay_time | float | 延遲時間 |
| datetime | str | 數據的日期和時間,格式為 YYYYMMDDHHMMSS |
| open | float | 開盤價格 |
| high | float | 當日最高價格 |
| low | float | 當日最低價格 |
| close | float | 收盤價格 |
| volume | int | 最近一筆成交的股票數量,為 0 表示沒有成交 |
| total_volume | int | 當日累計成交股票數量 |
| price_chg | float | 與參考價格相比的價格變動 |
| pct_chg | float | 股價百分比變動 |
| amount | int | 最近一筆成交的金額,為 0 表示沒有金額交易 |