Quote.subscribe_kbar 訂閲kbar

此功能用於訂閲特定股票的 K 線數據,數據每 N 分鐘更新一次,使用者可以實時追蹤股價的每次變動。
此功能支援的時間間隔包括 1, 3, 5, 15, 30, 60 分鐘。

Example

input
api.Quote.subscribe_kbar('2883',1)
output
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
)

Attribute

參數 資料型態 說明
symbol str 指定欲訂閱的股票代碼,例如 '2883'。
minute int 設定 K 線數據更新的時間間隔(單位:分鐘)。

Return Attribute

此方法不直接返回值,而是會顯示訂閲相關信息。
訂閲成功後,當有新的成交數據時,系統會通過 callback 機制回傳 kbar 實體。

kbar 實體包括以下詳細信息:

參數 資料型態 說明
exchangestr交易所
symbolstr股票代碼
datetimestr數據的日期和時間,格式為 YYYYMMDDHHMM
timeframeintK 線週期 (1, 3, 5, 15, 30, 60)(以分鐘為單位)
預設週期為1分鐘
openfloatK 線開盤價
highfloatK 線最高價
lowfloatK 線最低價
closefloatK 線收盤價
volumeintK 線成交量
avg_pricefloatK 線期間的成交均價
total_amountfloat累計成交金額