兆源股份有限公司研發部 2017 年 8 月 23 NetStockOrder ActiveX 控制項使用說明 NetStockOrder ActiveX 控制項怎麼使用? 答 : 在專案中添加該控制項及控制項中的相應事件, 調用所需功能的方法後, 在該功能的事件中得出相應的結果和處理這個結果注

Size: px

Start display at page:

Download "兆源股份有限公司研發部 2017 年 8 月 23 NetStockOrder ActiveX 控制項使用說明 NetStockOrder ActiveX 控制項怎麼使用? 答 : 在專案中添加該控制項及控制項中的相應事件, 調用所需功能的方法後, 在該功能的事件中得出相應的結果和處理這個結果注"

壹泗锺
4 years ago
Views:

1 NetStockOrder ActiveX 控制項使用說明 NetStockOrder ActiveX 控制項怎麼使用? 答 : 在專案中添加該控制項及控制項中的相應事件, 調用所需功能的方法後, 在該功能的事件中得出相應的結果和處理這個結果注 : 將 Config.ini 文件與執行檔放在相同的資料夾下 C# 事例 : 在 vs2010 開發環境下以 C# 語言演示第 1 步 : 打開 vs2010 第 2 步 : 新建 c# 專案選擇 windows 表單應用程式創建第 3 步 : 在工具箱中查找是否存在 NetStockOrder control, 如果存在, 將它添加至視窗中 ; 如果不存在, 則選擇功能表攔中工具選項, 點擊選擇工具箱項選擇 com 元件, 在清單中查找 NetStockOrder control 如果存在, 則選中該元件, 點擊確定將它添加至工具箱中如果不存在, 則點擊流覽選擇該組件檔將它添加至 com 組件清單中第 4 步 : 在視窗中選擇 NetStockOrder control 元件, 打開屬性介面, 點擊介面上事件按鈕, 在事件清單中添加相應事件 1 怎样進行連線? 答 : 調用連線函數 OnLink, 輸入交易主機位置和埠號進行連線 2 如何登陸? 答 : 根據 Username 用戶名及 Password 密碼來調用登陸函數 Login() 實現登陸 ( 登陸回報資料在 OnEvent 事件中返回, 請參考 OnEvent 1 / 20

2 事件說明 ) 3 如何登出? 答 : 調用登出函數 Logout() 登出 4 怎样進行交易證券商品? 答 : 調用函數 SendStockOrder() 可下證券單回傳值 : 0= 設置成功, 非 0= 設置失敗,-1: 價格錯誤,1: 帳號不存在,4: 此帳號不可下單, 5+6: 交易股市別或商品不存在,8: 憑證錯誤,10: 憑證過期,6: 製作電文格式錯誤, 在製作過程出錯注 : 定義值請參考下表參數名稱 ltype BranchNo Account mexch sexch Symbol Tran otype BuySell Price Qty OrderInfo 說明登入類別分公司代號帳號主股市別次股市別商品代碼交易股市別 : C= 普通, F= 定盤, D= 零股交易別 :0= 現股, 1= 融資 ( 代 ), 2= 融券 ( 代 ), 3= 融資 ( 自 ), 4= 融券 ( 自 ),7 = 現沖賣買賣別 :B= 買,S= 賣委託價格 : M0= 漲停價,D0= 跌停價, 00= 平盤價, S0= 定盤價委託數量該委託單類型標記 ( 該值與委託回報中的標記欄位元的值相匹配, 一般為空 ) 5 怎样進行交易期貨商品? 答 : 調用函數 SendFutureOrder() 可下期貨單回傳值 : 0= 設置成功, 非 0= 設置失敗,-1: 價格錯誤,1: 帳號不存在,4: 此帳號不可下單, 5+6: 交易股市別或商品不存在,8: 憑證 2 / 20

3 錯誤,10: 憑證過期,6: 製作電文格式錯誤, 在製作過程出錯注 : 定義值請參考下表參數名稱說明 ltype 登入類別 BranchNo 分公司代號 Account 帳號 mexch 主股市別 sexch 次股市別 Symbol 商品代碼 Tran 交易股市別 : T= 期貨, O= 選擇權 otype 交易別 :0= 新倉,1= 平倉,9= 自動 BuySell 買賣別 :B= 買,S= 賣 Fordt 委託條件 ROD=ROD,IOC=IOC,FOK=FOK, Prcml 限市價 : MKT= 市價,LMT= 限價 DayTrade 當沖 : Y=Yes, N=No Price 委託價格 :M0= 漲停價,D0= 跌停價,S0= 市價 Qty 委託數量 Symbol2 複式單商品 2 代碼 BuySell2 複式單商品 2 買賣別 MTType 複式委託組合 < 空格 >: 單式委託, 1: 執行價格價差, 2: 跨月價差, 3: 跨式組合, 4: 勒式組合, 5: 轉換 / 逆轉組合, Z: 其他組合方式 FTimes 複式委託重複次數, 單式委託為 0, 複式委託為 1 OrderInfo 該委託單類型標記 ( 該值與委託回報中的標記欄位元的值相匹配, 一般為空 ) 6 如何取消委託單? 答 : 調用函數 CancelOrder () 可取消委託單回傳值 : 0= 設置成功, 非 0= 設置失敗注 : 定義值請參考下表參數名稱 ltype 說明登入類別 3 / 20

4 BranchNo Account KeyNo OrderSheet OrderNo bdate 分公司代號帳號電子單號委託書號交易單號下單交易日期 7 怎樣修改委託單中的委託量和委託價? 答 : 調用函數 ChangeOrder () 可修改委託量和委託價回傳值 : 0= 設置成功, 非 0= 設置失敗, 錯誤原因 : 價格帶 0, 委託單不存在注 : 定義值請參考下表參數名稱說明 ltype 登入類別 BranchNo 分公司代號 Account 帳號 KeyNo 電子單號 OrderSheet 委託書號 OrderNo 交易單號 bdate 下單交易日期 Fordt 委託條件 ( 期權 ) ROD=ROD,IOC=IOC,FOK=FOK, ROC=ROC,SLOs=SLOs,MOO=MOO,MOC=MOC, AO=AO,OCO=OCO Prcml 限市價 : ( 期權 ) MKT= 市價,LMT= 限價 Price 委託價 StopPrice 觸價價格 RecoverPrice 追價價格 Qty 數量 ChgPrice 改價量別 :Y= 改價,N= 改量 8 如何查詢委託成交回報? 答 : 調用函數 GetReport () 可查詢委託成交回報 4 / 20

5 回傳值 : 0= 設置成功, 非 0= 設置失敗結果 : 回傳至 OnEvent 事件, 請參考該事件說明注 : 定義值請參考下表參數名稱 AccountType BranchNo Account 說明帳號類型 :T= 股票,F= 期貨,M= 證期,S= 國外期貨分公司代號帳號 9 如何庫存手動查詢? 答 : 調用函數 OnGetOpenInterest () 可查詢庫存回傳值 : 0= 設置成功, 非 0= 設置失敗結果 : 回傳至 OnEvent 事件, 請參考該事件說明注 : 定義值請參考下表參數名稱 AccountType BranchNo Account 說明帳號類型 :T= 股票 F= 期貨 M= 證期,S= 國外期貨分公司代號帳號 10 如何載入 CA 相關檔? 答 : 統一 : 將 URLFile 資料夾 CertSigner.dll 和 FSCAPIATL2.dll 與執行檔放在相同的資料夾下注 : 需註冊 FSCAPIATL2.dll 大昌 : 將 URLFile 資料夾 CertSigner.dll au_driver.dll jrsyscryptodll.dll 和 JrsysMSCrypto.dll 與執行檔放在相同的資料夾下注 : 需註冊 JrsysMSCrypto.dll 兆丰 : 將 URLFile 資料夾 CertSigner.dll 和 MEGASECCAPIATL.dll 與執行檔放在相同的資料夾下注 : 需註冊 MEGASECCAPIATL.dll 5 / 20

6 11 如何獲取 CA 相關資料? 答 : 調用函數 GetCAInfo (InfoType) 可獲取 CA 資料通過設置參數 InfoType 獲取相關資料, 該資料通過函數 GetCAInfo() 返回 InfoType 定義如下 : Info 定義含義 0 SIGN_STATUS 1 DATA_STATUS 2 CA_DATA 3 CA_TIME 設置 CA 結果資料獲取 CA 到期時間結果資料 CA 到期日期 CA 到期時間 12 OnEvent 事件使用說明如下? 答 : 添加 OnEvent 事件後, 可通過 EventType,Field 和 FieldData 參數接收相應資料 EventType 參數定義 : Info 定義含義 -1 MSF_BEGIN 0 MSG_END 1 CONNECT_EVENT 2 ACCOUNT_EVENT 開始接收當條資料當條資料接收完成連線回檔消息帳號回檔消息 6 / 20

7 3 INVENTORY 4 ORDER_REPORT 5 DEAL_REPORT 6 STATE_REPORT 7 ACTIVE_EVENT 庫存回檔消息委託回報消息成交回報消息股票狀態回報消息主動事件回報消息注 : 相關常量定義請參考附錄一 Field 參數定義 : 注 : 請參考附錄二 FieldData 參數定義 : Field 欄位元所對應的資料 13 如何交易夜盤商品? 答 : 夜盤商品送單的參數按照該商品日盤的送單參數送出例 : 台指期, 該商品日盤主股市別為 2, 夜盤主股市為 12, 如要下該商品夜盤單, 則主股識別送 2; 14 如何設置文件簽章(CA)?( 目前兆丰采用該簽章方式 ) 答 : 調用 SetCAInfo () 設置相關函數注 : 下單連線登錄前調用該函數進行檔簽章設置參數名稱說明 CAPath 簽章檔的所在路徑 CAFile 簽章檔的名稱 ( 需帶該簽章檔的尾碼 ) 7 / 20

8 CAPassWord 簽章檔的密碼附錄一委託成交回報類型 Info 定義含義 0 REPORT_FLAG_HIS_TRUST 1 REPORT_FLAG_HIS_MATCH 2 REPORT_FLAG_HIS_SUMMARY 3 REPORT_FLAG_RT_TRUST 4 REPORT_FLAG_RT_MATCH 5 REPORT_FLAG_RT_SUMMARY 6 REPORT_FLAG_RTS_TRUST 7 REPORT_FLAG_RTS_MATCH 歷史回報 ( 委託 ) 歷史回報 ( 成交 ) 歷史回報 ( 匯總 ) 即時回報 ( 委託 ) 即時回報 ( 成交 ) 即時回報 ( 匯總 ) 即時回報 ( 單筆委託 ) 即時回報 ( 單筆成交 ) CA 錯誤定義 Info 定義含義 0 CS_SUCCESS -1 CS_ERROR_INIT_LIB 成功初始化元件錯誤 : 簽章元件載入錯誤或呼叫函式錯誤 -2 CS_ERROR_CERTSIGN 憑證簽章錯誤 8 / 20

9 連線返回消息種類 Info 定義含義 0 CONNECT_SUCCESS -1 CONNECT_FAILURE -2 CONNECT_ERROR_PARAM -3 CONNECT_ERROR_STARTUP 連線成功連線失敗連線參數錯誤網路啟動錯誤主動訊息回報種類 Info 0x0000 0x0001 定義 ACTIVE_ACTIONSTATE ACTIVE_SERVER_ECHO 含義狀態回報伺服器回報 0x0100 0x0101 0x0102 0x0103 0x0104 ACTIVE_SYMBOLLIST_UPDATE_START ACTIVE_SYMBOLLIST_UPDATE_FINISH ACTIVE_SNOR_UPDATE_START ACTIVE_SNOR_UPDATE_FINISH ACTIVE_EXCHCATE_UPDATE_START 交易商品代碼表更新開始交易商品代碼表更新完成期貨選擇權類別表更新開始期貨選擇權類別表更新完成可交易股市清單更新開始 9 / 20

10 0x0105 0x0106 0x0107 0x0108 0x0109 0x0200 0x0201 0x0202 0x0203 0x0204 0x0205 0x0206 ACTIVE_EXCHCATE_UPDATE_FINISH ACTIVE_FIELDREF_UPDATE_START ACTIVE_FIELDREF_UPDATE_FINISH ACTIVE_TICKBEAT_UPDATE_START ACTIVE_TICKBEAT_UPDATE_FINISH ACTIVE_ACCT_NOTEXIST ACTIVE_ACCT_PASSWORD_ERROR ACTIVE_ACCT_ACCOUNT_EXPIRED ACTIVE_ACCT_LOGIN_ERROR ACTIVE_ACCT_FIRSTLOGIN ACTIVE_ACCT_PASSWORD_EXPIRED ACTIVE_ACCT_LOGOUT 可交易股市清單更新完成欄位參數資訊更新開始欄位參數資訊更新完成跳動檔位類別表更新開始跳動檔位類別表更新完成帳號不存在密碼錯誤帳號過期登入錯誤 ( 帶原因 ) 第一次登入密碼過期登出回覆附錄二 : 委託單 Field 參數定義 Info( 字串 ) KeyNo TranType 含義電子單號交易股市別 : C: 普通, F: 定價, D: 零股, T: 期貨, O: 選擇權, E: 興櫃, 10 / 20

11 S: 國外 BranchNo Account Symbol BuySell Fordt Prcml OrderInfo ReportFlag otype ltype Status scoden DayTrade OrderSheet Agent Msg sname Cdi mexch sexch 券商帳號股票代碼買賣別 : B 買進, S 賣出委託條件限市價下單標記回報類型交易別登入類別委託狀態委託來源當沖碼交易所委回櫃序號 ( 委託書號 ) 下單網路公司訊息使用者姓名易動別, I: 新增, C: 改量, D: 刪單主要股市別次要股市別 11 / 20

12 OrderNo decp tprice aprice chgprc tqty cqty ocqty lqty eqty mqty aqty bqty uqty valid kdate ktime bdate btime ttime stoptp 委託單號分母 ( 國外期貨 ) 委託價市價 :S0, 漲停價 :M0, 跌停價 :D0, 平盤價 :00 成交均價指定改價 ( 期交所 ): Y: 改價, N: 改量委託數量, 新增單為委託數, 刪改單為刪改後數改變數量 ( 成功數量 ), 新增單為 0, 刪改單為刪改數單筆委託修改量委託可刪量總取消數量成交數量委託後量委託前量委託可刪量 (AP 用 ) 顯示刪改委託下單日期委託下單時間下單交易日日期下單交易日時間成交時間觸價種類 12 / 20

13 stopprc rcvrprc extratype1 stopcond ftimes mttype cmtp2 symbol2 buysell2 tqty2 statusstr 觸價價格追價價格 (OCO) 添加 109 商品分類欄位觸價條件重複次數複式組合型態商品二類別商品二代號商品二買賣別商品二委託數量委託狀態成交單 Field 參數定義 Info( 字串 ) KeyNo TranType 含義電子單號交易股市別 : C: 普通, F: 定價, D: 零股, T: 期貨, O: 選擇權, E: 興櫃, S: 國外 BranchNo Account Symbol BuySell Fordt 券商帳號股票代碼買賣別 : B 買進, S 賣出委託條件 13 / 20

14 Prcml tseno ReportFlag otype ltype scoden DayTrade OrderSheet Agent Msg sname mexch sexch OrderNo decp tprice aprice chgprc tqty cqty ocqty 限市價成交序號回報類型交易別登入類別委託來源當沖碼交易所委回櫃序號 ( 委託書號 ) 下單網路公司訊息使用者姓名主要股市別次要股市別委託單號分母 ( 國外期貨 ) 委託價市價 :S0, 漲停價 :M0, 跌停價 :D0, 平盤價 :00 成交均價指定改價 ( 期交所 ): Y: 改價, N: 改量委託數量, 新增單為委託數, 刪改單為刪改後數改變數量 ( 成功數量 ), 新增單為 0, 刪改單為刪改數單筆委託修改量 14 / 20

15 lqty eqty mqty aqty bqty uqty valid kdate ktime btime ttime stoptp stopprc rcvrprc extratype1 stopcond ftimes mttype statusstr mprice sqty 委託可刪量總取消數量成交數量委託後量委託前量委託可刪量 (AP 用 ) 顯示刪改委託下單日期委託下單時間下單交易日時間成交時間觸價種類觸價價格追價價格 (OCO) 添加 109 商品分類欄位觸價條件重複次數複式組合型態委託狀態成交價單筆成交數量 15 / 20

16 tmno 複式成交腳位交易股市 Field 參數定義 Info( 字串 ) mexch sexch TranType 含義主要股市別次要股市別交易股市別 : C: 普通, F: 定價, D: 零股, T: 期貨, O: 選擇權, E: 興櫃, S: 國外 ExchState TradeDate ExchAlarm ExchName ExtraType ExchTime ExchMessage 股市狀態碼有效日期價格檢查警示交易所名稱交易市場代號該商品開盤收盤時間資訊交易狀態訊息證券交易庫存 Field 參數定義 Info( 字串 ) Cnt AccountType BranchNo Account mexch 含義總筆數 ( 第一筆才有 ) 帳號類型分公司別交易帳號主要股市別 16 / 20

17 TranType 交易股市別 : C: 普通, F: 定價, D: 零股, T: 期貨, O: 選擇權, E: 興櫃, S: 國外 Symbol Currency BitsBalanceToday StockBalanceYesterday StockBalanceToday BuyStockBalanceToday SellStockBalanceToday StockTrustBuy StockTrustSell StockMatchBuy StockMatchSell FinaBalanceYesterday FinaBalanceToday FinaTrustBuy FinaTrustSell FinaMatchBuy FinaMatchSell SecuBalanceYesterday SecuBalanceToday 股票代碼貨幣零股現股昨餘現股今餘現股今餘買現股今餘賣現股買委現股賣委現股買成現股賣成融資昨餘融資今餘融資買委融資賣委融資買成融資賣成融券昨餘融券今餘 17 / 20

18 SecuTrustBuy SecuTrustSell SecuMatchBuy SecuMatchSell 融券買委融券賣委融券買成融券賣成期權交易庫存 Field 參數定義 Info( 字串 ) Cnt AccountType BranchNo Account mexch TranType 含義總筆數 ( 第一筆才有 ) 帳號類型分公司別交易帳號主要股市別交易股市別 : C: 普通, F: 定價, D: 零股, T: 期貨, O: 選擇權, E: 興櫃, S: 國外 Symbol Currency SettleUp OILongYesterday OIShortYesterday TrustLong TrustShort MatchLong 股票代碼貨幣了結昨日留倉 - 買昨日留倉 - 賣本日委託 - 買本日委託 - 賣目前成交 - 買 18 / 20

19 MatchShort OILongToday OIShortToday MatchLongPrice MatchShortPrice MatchLongValue MatchShortValue 目前成交 - 賣目前留倉 - 買目前留倉 - 賣平均成本 - 買平均成本 - 賣成交總金額 - 買成交總金額 - 賣帳號回報 Field 參數定義 Info( 字串 ) AccountType BranchNo Account Name Id Id_Cmt 含義帳號別券商代碼下單帳號使用者姓名統一編號帳號屬性編號其他 Field 參數定義 Info( 字串 ) ConnectType ConnectMsg ActiveType ActiveMsg 含義連線回報資料標識連線回報消息標識主動事件類型標識主動事件消息標識 19 / 20

20 20 / 20

一.API 連線登入 ( 不含主動回報 )FUNCTION 傳入值 MSGXML 登入 ( 含主動回報 )FUNCTION 傳入值 MSGXML 登出 FUNCTION...6 二. 委託傳送...

一.API 連線登入 ( 不含主動回報 )FUNCTION 傳入值 MSGXML 登入 ( 含主動回報 )FUNCTION 傳入值 MSGXML 登出 FUNCTION...6 二. 委託傳送... 富邦證券 OCX API 規格說明書 1 一.API 連線...4 1 登入 ( 不含主動回報 )FUNCTION...4 1.1 傳入值...4 1.2 MSGXML...4 2 登入 ( 含主動回報 )FUNCTION...6 2.1 傳入值...6 2.2 MSGXML...6 3 登出 FUNCTION...6 二. 委託傳送...8 1 下單 FUNCTION...8 1.1 傳入值...8