USQuote.set_cb 設定callback

此功能允許用戶為訂閲方法設定一個回調函數。 這樣,每當訂閱的股票數據更新時,設定的自定義回調函數將被調用,即時處理股市數據。

Example 1:設定tick的callback並訂閱

input
def callback(data):
    display('=====set_USTick=====')
    display(data)
                                
api.USQuote.set_cb_tick(callback)
api.USQuote.subscribe_tick('AAPL')
output
Callback for [USStock] [tick] version[v1] set successfully.
Try to subscribe usstock[AAPL] quoteType[qtTick] version[v1]

'=====set_USTick====='
Tick_USStock_v1(
	symbol='AAPL', 
	delay_time=0.0, 
	datetime='20251205160000', 
	open=280.54, 
	high=281.14, 
	low=278.05, 
	close=278.78, 
	volume=0, 
	total_volume=47265845, 
	price_chg=-1.92, 
	pct_chg=-0.68, 
	amount=0
)

Example 2:設定bidask的callback並訂閱

input
def callback(data):
	display('=====set_USBidAsk=====')
	display(data)
	
api.USQuote.set_cb_bidask(callback)
api.USQuote.subscribe_bidask('AAPL')
output
Callback for [USStock] [BidAsk] version[v0] set successfully.
Try to subscribe usstock[AAPL] quoteType[qtBidAsk] version[v0]

'=====set_USBidAsk====='
BidAsk_USStock_v0(
	symbol='AAPL', 
	delay_time=0.0, 
	datetime='20251229195820', 
	best_bid_price=273.51, 
	best_bid_volume=50, 
	best_ask_price=273.75, 
	best_ask_volume=22
)

Example 3:設定kbar的callback並訂閱

input
def callback(data):
    display('=====set_USKbar=====')
    display(data)
                                
api.USQuote.set_cb_kbar(callback) 
api.USQuote.subscribe_kbar('TSM')
output
Callback for [USStock] [KBar] version[v0] set successfully.

'=====set_USKbar====='				
KBar_USStock_v0(
	symbol='AAPL', 
	datetime='202512080423', 
	timeframe=1, 
	open=278.41, 
	high=278.41, 
	low=278.41, 
	close=278.41, 
	volume=147
)

Attribute

callback:回調函數,當訂閲的股票數據更新時將被呼叫。
回調函數需要定義一個接收數據的參數,該參數會在股票數據更新時傳遞給函數。

Return Attribute

此方法不直接返回值,而是在訂閲股票後,根據callback的編制邏輯,當有相關數據更新時執行回調函數,從而實現即時數據處理和反應。