C#

class spdQuoteAPI

連線與登入

行情主機是否連線
/*  
  回傳 true 表示連線中, false 表示連線已中斷       
*/
public bool IsConnected()
連線登入行情主機
/*
  IP                行情主機IP
  Port              行情主機Port
  ID                行情主機登入帳號.
  Password          行情主機帳號的密碼. 
  DownloadContracts 登入成功後是否自動下載商品基本資料.也可以登入成功後,主動呼叫 DownloadContracts().
  回傳值            false 表示身分驗證錯誤或行情主機連線失敗  
*/
public bool Logon(string IP, int Port, string ID, string Password, bool DownloadContracts)

訂閱

用商品代碼訂閱行情
/*
  Exchange 交易所
            證交所:  "TWSE"
            櫃買中心:"OTC"
            期交所:  "TAIFEX"
  Symbol   商品代碼
  回傳 true 表示訂閱成功, false 表示訂閱失敗.超過訂閱數上限.      

*/
public bool Subscribe(string Exchange, string Symbol)
用商品基本資料物件訂閱行情
/*
  Contract 商品基本資料的物件    
  回傳 true 表示訂閱成功, false 表示訂閱失敗或超過訂閱數上限.      
  
*/
public bool SubscribeContract(ContractInfo contract)

取消訂閱

解除訂閱所有商品行情
public void UnsubscribeAll()

下載商品基本資料

下載商品基本資料
/* 
  當下載完成時 OnContractDownloadComplete 事件會被呼叫.
*/  
public void DownloadContracts()

商品基本資料 struct ContractInfo

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

委託簿更新資料 struct spdMsgOrderBook

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

屬性

屬性
屬性 型態 說明 備註
Stocks Dictionary<string, ContractInfo> 股票商品基本資料 事件 OnContractDownloadComplete 被觸發後才有內容
Futures Dictionary<string, ContractInfo> 期貨商品基本資料
Options Dictionary<string, ContractInfo> 選擇權商品基本資料

事件

行情主機連線完成的Event. 使用者透過 spdQuoteAPI 的 property evOnConnected 跟 delegate 型態 OnQuoteConnected 指定 event 觸發時哪個 method 被呼叫。
public delegate void OnQuoteConnected();
public OnQuoteConnected evOnConnected;
發生斷線的Event. 使用者透過 spdQuoteAPI 的 property evOnConnected 跟 delegate 型態 OnQuoteConnected 指定 event 觸發時哪個 method 被呼叫。
public delegate void OnQuoteDisconnected();
public OnQuoteDisconnected evOnDisconnected;
行情主機登入結果回覆的Event. 使用者透過 spdQuoteAPI 的 property evOnConnected 跟 delegate 型態 OnQuoteConnected 指定 event 觸發時哪個 method 被呼叫。
/*
  isLogonOK    是否成功 true:成功 false:失敗 
  ReplyString  登入訊息 

*/
public delegate void OnQuoteLogonResponse(bool isLogonOK, string ReplyMsg);
public OnQuoteLogonResponse evOnLogonResponse;
通知商品基本資料下載完成的Event. 使用者透過 spdQuoteAPI 的 property evOnContractDownloadComplete 跟 delegate 型態 OnQuoteContractDownloadComplete 指定 event 觸發時哪個 method 被呼叫。
event 被觸發之後可以用 Stocks, Futures, Options 這幾個屬性取到商品基本資料。
/*
TotalContracts  下載的商品檔數量

*/
public delegate void OnQuoteContractDownloadComplete(int TotalContracts);
public OnQuoteContractDownloadComplete evOnContractDownloadComplete;
委託簿更新的Event. 使用者透過 spdQuoteAPI 的 property evOnOrderBook 跟 delegate 型態 OnQuoteOrderBook 指定 event 觸發時哪個 method 被呼叫。
/*
  Exchange  交易所
            證交所        "TWSE"   
            櫃買中心      "OTC"    
            期交所        "TAIFEX" 
  Symbol    商品代碼      
  MsgTime   資料時間      格式為 HH:MM:SS.mmm 
  OrderBook 五檔行情資料 
  
 */
 public delegate void OnQuoteOrderBook(string Exchange, string Symbol, string MsgTime, MsgOrderBook OrderBook);
 public OnQuoteOrderBook evOnOrderBook;
收到成交信息Event. 使用者透過 spdQuoteAPI 的 property evOnTrade 跟 delegate 型態 OnQuoteTrade 指定 event 觸發時哪個 method 被呼叫。
/*
  Exchange    交易所
              證交所    "TWSE"   
              櫃買中心  "OTC"    
              期交所    "TAIFEX" 
  Symbol      商品代碼       
  MatchTime   成交時間  格式為 HH:MM:SS.mmm 
  MatchPrice  成交價格
  MatchQty    成交數量
  IsTestMatch 是否為試撮
  
 */
 public delegate void OnQuoteTrade(string Exchange, string Symbol, string MatchTime, double MatchPrice, int MatchQty, bool isTestMatch);
 public OnQuoteTrade evOnTrade;