此功能用於訂閲特定股票的 K線數據,數據每 1 分鐘更新一次,使用者可以實時追蹤股價的每次變動。
api.USQuote.subscribe_kbar('TSM')
KBar_USStock_v0(
symbol='TSM',
datetime='202512080426',
timeframe=1,
open=300.49,
high=300.49,
low=300.49,
close=300.49,
volume=728
)
| 參數 | 資料型態 | 說明 |
|---|---|---|
| symbol | str | 指定欲訂閱的股票代碼,例如 'TSM'。 |
此方法不直接返回值,而是會顯示訂閲相關信息。訂閲成功後,當有新的成交數據時,系統會通過 callback 機制回傳 kbar 實體。
kbar 實體包括以下詳細信息:
| 參數 | 資料型態 | 說明 |
|---|---|---|
| symbol | str | 股票代碼 |
| datetime | str | 數據的日期和時間,格式為 YYYYMMDDHHMM |
| timeframe | int | K 線週期(以分鐘為單位),若未提供則為 None |
| open | float | K 線開盤價 |
| high | float | K 線最高價 |
| low | float | K 線最低價 |
| close | float | K 線收盤價 |
| volume | int | K 線成交量 |