此功能用於訂閲特定股票的 K 線數據,數據每 N 分鐘更新一次,使用者可以實時追蹤股價的每次變動。
此功能支援的時間間隔包括
1, 3, 5, 15, 30, 60 分鐘。
api.Quote.subscribe_kbar('2883',1)
KBar_Stock_v0(
exchange='TWSE',
symbol='2883',
datetime='202512081330',
timeframe=1,
open=16.2,
high=16.2,
low=16.2,
close=16.2,
volume=4303,
avg_price=16.17,
total_amount=547494.3
)
| 參數 | 資料型態 | 說明 |
|---|---|---|
| symbol | str | 指定欲訂閱的股票代碼,例如 '2883'。 |
| minute | int | 設定 K 線數據更新的時間間隔(單位:分鐘)。 |
此方法不直接返回值,而是會顯示訂閲相關信息。訂閲成功後,當有新的成交數據時,系統會通過 callback 機制回傳 kbar 實體。
kbar 實體包括以下詳細信息:
| 參數 | 資料型態 | 說明 |
|---|---|---|
| exchange | str | 交易所 |
| symbol | str | 股票代碼 |
| datetime | str | 數據的日期和時間,格式為 YYYYMMDDHHMM |
| timeframe | int | K 線週期 (1, 3, 5, 15, 30, 60)(以分鐘為單位) 預設週期為1分鐘 |
| open | float | K 線開盤價 |
| high | float | K 線最高價 |
| low | float | K 線最低價 |
| close | float | K 線收盤價 |
| volume | int | K 線成交量 |
| avg_price | float | K 線期間的成交均價 |
| total_amount | float | 累計成交金額 |