本篇重点

• api.quote.subscribe简介
• 订阅个股盘中tick资讯
• 订阅个股盘中bidask资讯

api.quote.subscribe简介

官方说明文件：https://sinotrade.github.io/tutor/market_data/streaming/stocks/
对於程序交易，会需要在盘中的时候取得盘中的报价或成交资讯。虽然在盘中，也是可以用snapshots或kbars来取得盘中资讯，但在取得这类资讯时，不管对服务器端或是客户端，都是比较占用资源的。透过subscribe，你可以订阅多个金融商品的报价或成交资讯，也可以针对回传的内容，撰写对应的执行动作(程序)。
另外，跟其它报价资讯相比，目前subscribe是一个连线最多可以订阅200个内容。

api.quote.subscribe(
    contract: shioaji.contracts.Contract, #contract金融商品资讯
    quote_type: shioaji.constant.QuoteType = <QuoteType.Tick: 'tick'>, #报价类型，预设为tick资料
    intraday_odd: bool = False, #盘中零股，预设为False，即现股资料
    version: shioaji.constant.QuoteVersion = <QuoteVersion.v0: 'v0'>, #报价资讯类型，预设为v0版
)

若要取消订阅，可呼叫api.quote.unsubscribe，使用方式及参数与subscribe相同

subscribe在使用上，stock跟future没有差别，但在回传的资讯上有些微的不同，所以此部份会把stock跟future分开说明，此篇先说明stock个股的部份。
而QuoteVersion有分v1和v0版，v0版是简易的报价内容，v1版是详细的报价内容，以下也会分别说明v0版及v1版的使用方式及报价内容。

订阅个股盘中tick资讯

如同之前所介绍的，tick是指成交的报价内容，所以只要有成交，就会回传一笔资料。
订阅个股盘中tick v1版报价资讯，范例如下：

from shioaji import TickSTKv1, Exchange #从shioaji模组，汇入TickSTKv1及Exchange物件
from threading import Event #threading模组，汇入Event物件
#订阅个股盘中tick资讯
api.quote.subscribe(
    api.Contracts.Stocks["2330"], 
    quote_type = sj.constant.QuoteType.Tick, # or 'tick'
    version = sj.constant.QuoteVersion.v1 # or 'v1'
)

Event().wait() #盘中执行程序时，若看不到quote_callback的执行结果，请加入此行
# 定义quote_callback，即回传报价资讯时所要执行的动作
@api.on_tick_stk_v1()
def quote_callback(exchange: Exchange, tick:TickSTKv1):
    print(f"Exchange: {exchange}, Tick: {tick}") #将报价资讯内容输出至console中

Tick QuoteVersion.v1，quote_callback的执行结果

Exchange.TSE Tick(code='2330', datetime=datetime.datetime(2021, 9, 24, 11, 19, 42, 535354), open=Decimal('591'), avg_price=Decimal('593.06'), close=Decimal('596'), high=Decimal('597'), low=Decimal('590'), amount=Decimal('596000'), total_amount=Decimal('5626423000'), volume=1, total_volume=9487, tick_type=1, chg_type=2, price_chg=Decimal('8'), pct_chg=Decimal('1.36'), bid_side_total_vol=7328, ask_side_total_vol=2159, bid_side_total_cnt=1654, ask_side_total_cnt=489, closing_oddlot_shares=0, fixed_trade_vol=0, suspend=0, simtrade=0, intraday_odd=0)

Tick QuoteVersion.v1的报价内容说明

订阅个股盘中tick v0版报价资讯，范例如下：

api.quote.subscribe(
    api.Contracts.Stocks["2330"], 
    quote_type = sj.constant.QuoteType.Tick, # 报价类型为Tick
    version = sj.constant.QuoteVersion.v0 # 回传资讯版本为v0
)
# 定义quote_callback，即回传报价资讯时所要执行的动作
@api.quote.on_quote
def quote_callback(topic: str, quote: dict):
    print(f"Topic: {topic}, Quote: {quote}")

Tick QuoteVersion.v0，quote_callback的执行结果

MKT/idcdmzpcr01/TSE/2330 {'AmountSum': [5641317000.0], 'Close': [596.0], 'Date': '2021/09/24', 'TickType': [1], 'Time': '11:23:30.154501', 'VolSum': [9512], 'Volume': [2]}

Tick QuoteVersion.v0的报价内容说明

订阅个股盘中bidask资讯

bidask是指委买委卖的资讯，也就是看盘软件中最佳五档的资料内容
订阅个股盘中bidask v1版报价资讯，范例如下：

api.quote.subscribe(
    api.Contracts.Stocks["2330"], 
    quote_type = sj.constant.QuoteType.BidAsk, #报价类型为BidAsk
    version = sj.constant.QuoteVersion.v1 # 回传资讯版本为v1
)
Event().wait()
# 定义quote_callback，即回传报价资讯时所要执行的动作
@api.on_bidask_stk_v1()
def quote_callback(exchange: Exchange, bidask:BidAskSTKv1):
    print(f"Exchange: {exchange}, BidAsk: {bidask}")

BidAsk QuoteVersion.v1，quote_callback的执行结果

Exchange.TSE BidAsk(code='2330', datetime=datetime.datetime(2021, 9, 24, 11, 27, 11, 42526), bid_price=[Decimal('595'), Decimal('594'), Decimal('593'), Decimal('592'), Decimal('591')], bid_volume=[405, 245, 746, 454, 260], diff_bid_vol=[0, 0, 0, 0, 0], ask_price=[Decimal('596'), Decimal('597'), Decimal('598'), Decimal('599'), Decimal('600')], ask_volume=[121, 364, 359, 415, 657], diff_ask_vol=[-1, 0, 0, 0, 0], suspend=0, simtrade=0, intraday_odd=0)

Tick QuoteVersion.v1的报价内容说明

订阅个股盘中bidask v0版报价资讯，范例如下：

api.quote.subscribe(
    api.Contracts.Stocks["2330"], 
    quote_type = sj.constant.QuoteType.BidAsk, #报价类型为BidAsk
    version = sj.constant.QuoteVersion.v0 # 回传资讯版本为v0
)
Event().wait()
@api.quote.on_quote
def quote_callback(topic: str, quote: dict):
    print(f"Topic: {topic}, Quote: {quote}")

BidAsk QuoteVersion.v0，quote_callback的执行结果

QUT/idcdmzpcr01/TSE/2330 {'AskPrice': [596.0, 597.0, 598.0, 599.0, 600.0], 'AskVolume': [124, 381, 358, 416, 656], 'BidPrice': [595.0, 594.0, 593.0, 592.0, 591.0], 'BidVolume': [407, 246, 745, 454, 260], 'Date': '2021/09/24', 'Time': '11:28:01.797097'}

Tick QuoteVersion.v0的报价内容说明