Python

class spdQuoteAPI

連線與登入

行情主機是否連線
# 回傳 TRUE 表示連線成功,FALSE 斷線. .        
#
def IsConnected():
連線登入行情主機
# IP                行情主機IP
# Port              行情主機Port
# ID                行情主機登入帳號.
# Password          行情主機帳號的密碼. 
# DownloadContracts 登入成功後是否自動下載商品基本資料.也可以登入成功後,主動呼叫DownloadContracts().
#
def Logon(self, IP, Port, ID, Password, DownloadContracts):

訂閱

用商品代碼訂閱行情
# Exchange 交易所
#          證交所:'TWSE'
#          櫃買中心:'OTC'
#          期交所:'TAIFEX'
# Symbol   商品代碼
# 回傳 TRUE 表示訂閱成功,FALSE表示訂閱失敗.超過訂閱數上限.       
#
def Subscribe(Exchange, Symbol):
用商品基本資料物件訂閱行情
# Contract 商品基本資料的物件. 型態為 ContractInfo    
# 回傳 TRUE 表示訂閱成功,FALSE表示訂閱失敗或超過訂閱數上限.       
#
def SubscribeContract(Contract ):

取消訂閱

解除訂閱所有商品行情
def UnsubscribeAll():

下載商品基本資料

下載商品基本資料
# 當下載完成時 OnContractDownloadComplete 事件會被呼叫.
#   
def DownloadContracts():

商品基本資料 class ContractInfo

商品基本資料 class ContractInfo
屬性 說明
Exchange 交易所名稱
Symbol 商品代碼
DisplayName 商品顯示名稱
MaturityDate 期貨商品結算年月 YYYYMM
Category 商品類別
BullPx 漲停價
BearPx 跌停價
RefPx 參考價
ContractMultiplier 契約成數
StrikePx 選擇權商品履約價
Market 市場別
TradeUnit 交易單位
TradeFlag 商品是否可交易 1:是 0:否
DayTrade 當沖註記.
'Yes':可雙向當沖
'OnlyBuy':可先買後賣當沖
'No':不可當沖
IsWarrant 是不是權證商品
WarringStock 警示股代碼.
0—正常
1—注意
2—處置
3—注意及處置
4—再次處置
'No':不可當沖
5—注意及再次處置
6—彈性處置
7—注意及彈性處置
CallPut 'Call': call的選擇權
'Put' : Put的選擇權
'None': 非選擇權商品

委託簿更新資料 class spdMsgOrderBook

委託簿更新資料 class spdMsgOrderBook
屬性 說明
BidPrice1 最佳買一價
BidPrice2 最佳買二價
BidPrice3 最佳買三價
BidPrice4 最佳買四價
BidPrice5 最佳買五價
BidQty1 最佳買一量
BidQty2 最佳買二量
BidQty3 最佳買三量
BidQty4 最佳買四量
BidQty5 最佳買五量
AskPrice1 最佳賣一價
AskPrice2 最佳賣二價
AskPrice3 最佳賣三價
AskPrice4 最佳賣四價
AskPrice5 最佳賣五價
AskQty1 最佳賣一量
AskQty2 最佳賣二量
AskQty3 最佳賣三量
AskQty4 最佳賣四量
AskQty5 最佳賣五量
DerivedBidPrice 衍生Bid價格.(僅期交所提供)
DerivedBidQty 衍生Bid數量.(僅期交所提供)
DerivedAskPrice 衍生Ask價格.(僅期交所提供)
DerivedAskQty 衍生Ask數量.(僅期交所提供)
IsTestMatch 是否為試撮

屬性

屬性
名稱 型態 說明 備註
Stocks Dictionary key:商品代碼 value:ContractInfo 股票商品基本資料 事件 OnContractDownloadComplete 被觸發後才有內容
Futures 期貨商品基本資料
Options 選擇權商品基本資料

事件

行情主機連線完成的Event. 由使用者實作繼承 spdQuoteAPI 類別後自行定義事件的處理邏輯
# self 物件本身. 
#
def OnConnected(self):
發生斷線的Event. 由使用者實作繼承 spdQuoteAPI 類別後自行定義事件的處理邏輯
# self 物件本身. 
#
def OnDisconnected(self):
行情主機登入結果回覆的Event. 由使用者實作繼承 spdQuoteAPI 類別後自行定義事件的處理邏輯
# self        物件本身. 
# IsSucceed   是否成功 True:成功 False:失敗 
# ReplyString 登入訊息 
#
def OnLogonResponse(self, IsSucceed, ReplyString):
通知商品基本資料下載完成的Event. 由使用者實作繼承 spdQuoteAPI 類別後自行定義事件的處理邏輯。
之後可以用 Stocks, Futures, Options 這幾個屬性(型態為Dictionary, key為商品代碼, value 為 ContractInfo) 取到商品基本資料
# self 物件本身. 
#
def OnContractDownloadComplete(self):
委託簿更新的Event. 由使用者實作繼承 spdQuoteAPI 類別後自行定義事件的處理邏輯
# self      物件本身. 
# Exchange  交易所
#           證交所    'TWSE'   
#           櫃買中心  'OTC'    
#           期交所    'TAIFEX' 
# Symbol    商品代碼 
# MsgTime   資料時間    格式為 HH:MM:SS.mmm 
# Msg       五檔行情資料 型態為 spdMsgOrderBook 
#
def OnOrderBook(self, Exchange, Symbol, MsgTime, Msg):
收到成交信息Event. 由使用者實作繼承 spdQuoteAPI 類別後自行定義事件的處理邏輯
# self        物件本身. 
# Exchange    交易所 
# Exchange    交易所
#             證交所    'TWSE'   
#             櫃買中心  'OTC'    
#             期交所    'TAIFEX' 
# Symbol      商品代碼      
# MatchTime   成交時間 格式為 HH:MM:SS.mmm 
# MatchPrice  成交價格
# MatchQty    成交數量
# IsTestMatch 是否為試撮 (True/False)
#
def OnTrade(self, Exchange, Symbol, MatchTime, MatchPrice, MatchQty, IsTestMatch):