1、上海金融期貨技術(shù)文檔TraderAPI文檔標(biāo)識文檔修訂歷史此版本文檔的正式核準(zhǔn)所有上海金融期貨2013-06-191簽字日期版本日期描述修訂者V0.620130304刪除報(bào)單操作中用戶自定義字段； 增加登錄請求中 IP，MAC 占位字段字段佘鵬飛V0.720130503增加手續(xù)費(fèi)率和保證金率接口佘鵬飛V0.820130530優(yōu)化接口佘鵬飛V0.920130618實(shí)測版本佘鵬飛V1.00.012013/11/26新增出入金回報(bào)接口陳超V1.012014/12/30支持 FOK，支持市價(jià)單劉萌、曹俊嶺項(xiàng)目名稱FEMAS文檔名稱Trader API版本號1.01狀況上海金融期貨技術(shù)文檔TraderA

2、PI目錄1. 介紹12. 體系結(jié)構(gòu)22.1 通訊模式22.2 數(shù)據(jù)流33. 接口模式4流和流編程接口43.13.2私有流編程接口44.運(yùn)行模式64.1工作線程64.2本地文件65.業(yè)務(wù)和接口對照76.開發(fā)接口106.1通用規(guī)則106.2CUstpFtdcTraderSpi 接口106.2.1OnFrontConnected 方法106.2.2OnFrontDisconnected 方法10OnHeartBeatWarning 方法.4OnRspUserLogin 方法11OnRspUserLogout 方法12OnRspUserPasswordUpdate 方法13OnRs

3、pError 方法14OnRspOrderInsert 方法14OnRspOrderAction 方法16OnRspQryOrder 方法...106.2.11OnRspQryTrade 方法196.2.12OnRspQryInvestorAccount 方法216.2.13OnRspQryTradingCode 方法236.2.14OnRspQryExchange 方法24所有上海金融期貨2013-06-192上海金融期貨技術(shù)文檔TraderAPI6.2.15OnRspQryInstrument 方法246.2.16OnRspQryUs

4、erInvestor 方法26OnRspQryInvestorPosition 方法27OnRspQryComplianceParam 方法29OnRspQryInvestorFee 方法30OnRspQryInvestorMargin 方法3..206.2.21OnRrade 方法326.2.22OnRtnOrder 方法336.2.23OnRtnInstrumentStatus 方法35OnRtnInvestorAccountDeposit 方法3.25OnErrRtnOrderInsert 方法386.2.26OnErrRtn

5、OrderAction 方法396.3CUSTPFtdcTraderApi 接口406.3.1CreateFtdcTraderApi 方法416.3.2Release 方法416.3.3Init 方法416.3.4Join 方法416.3.5GetTradingDay 方法41RegisterSpi 方法4.7RegisterFront 方法426.3.8RegisterNameServer 方法42SubscribePrivateTopic 方法43SubscribePublicTopic 方法43SubscribeForQuote 方法43ReqUserLogin 方法4

6、4ReqUserLogout 方法45ReqUserPasswordUpdate 方法4...146.3.15ReqOrderInsert 方法46ReqOrderAction 方法4.17Re ryOrder 方法50所有上海金融期貨2013-06-193上海金融期貨技術(shù)文檔TraderAPI6.3.18ReryTrade 方法516.3.19ReryInvestorAccount 方法52ryTradingCode 方法52ryExchange 方法53ryInstrument 方法53ryUserInves

7、tor 方法54ryInvestorPosition 方法556.3.20Re6.3.21Re6.3.22Re6.3.23Re6.3.24Re6.3.25ReryComplianceParam 方法556.3.26ReryInvestorFee 方法56ryInvestorMargin 方法576.3.27Re開發(fā)實(shí)例587.所有上海金融期貨2013-06-194上海金融期貨技術(shù)文檔TraderAPI1.介紹飛馬平臺 API 是一個(gè)基于 C+的類庫, 通過使用和擴(kuò)展類庫提供的接口來實(shí)現(xiàn)相關(guān)功能，包括報(bào)單錄入、報(bào)單撤銷、報(bào)單、成交單、投資者、投資者持倉、合約、日獲取等。該類庫包含以下 7 個(gè)文件

8、：支持 MSVC6.0，MSVC.NET2003 編譯器。需要打開多線程編譯選項(xiàng)/MT。所有上海金融期貨2013-06-191文件名版本文件大小文件描述FtdcTraderApi.h接口頭文件FtdcUserApiDataType.h定義了 API 所需的一系列數(shù)據(jù)類型的頭文件FtdcUserApiStruct.h定義了一系列業(yè)務(wù)相關(guān)的數(shù)據(jù)結(jié)構(gòu)的頭文件USTPtraderapi.dll動(dòng)態(tài)庫二進(jìn)制文件USTPtraderapi.lib導(dǎo)入庫文件USTPmduserapi.dll動(dòng)態(tài)庫二進(jìn)制文件USTPmduserapi.lib導(dǎo)入庫文件上海金融期貨技術(shù)文檔TraderAPI2.體系結(jié)構(gòu)員 AP

9、I 使用建立在 TCP 協(xié)議之上 FTD 協(xié)議與飛馬平臺進(jìn)行通訊，飛馬平臺負(fù)責(zé)投資者的業(yè)務(wù)處理。2.1 通訊模式FTD 協(xié)議中的所有通訊都基于某個(gè)通訊模式。通訊模式實(shí)際上就是通訊雙方協(xié)同工作的方式。FTD 涉及的通訊模式共有三種：lll通訊模式私有通訊模式廣播通訊模式通訊模式是指由用戶端主動(dòng)發(fā)起的通訊請求。該請求被所端接收和處理，并給予響應(yīng)。例如報(bào)單、私有通訊模式是指廣播通訊模式是指等。這種通訊模式與普通的客戶/服務(wù)器模式相同。所端主所端主某個(gè)特定的用戶發(fā)出的信息。例如成交回報(bào)等。市場中的所有用戶都發(fā)出相同的信息。例如公告、市場公共信息等。通訊模式和網(wǎng)絡(luò)的連接不一定存在簡單的一對一的關(guān)系。也就

10、是說，一個(gè)網(wǎng)絡(luò)連接中可能傳送多種不同通訊模式的報(bào)文，一種通訊模式的報(bào)文也可以在多個(gè)不同的連接中傳送。無論哪種通訊模式，其通訊過程都如圖 1 所示：所有上海金融期貨2013-06-192上海金融期貨技術(shù)文檔TraderAPI客戶程序風(fēng)控前置系統(tǒng)連接請求連接確認(rèn)認(rèn)證請求認(rèn)證響應(yīng)發(fā)出請求（如果在模式下）請求響應(yīng)（如果在模式下）發(fā)出私有信息（如果在私有模式下）斷開請求斷開確認(rèn)圖 1-各種通訊模式的工作過程本接口暫時(shí)沒有使用廣播通訊方式。2.2 數(shù)據(jù)流飛馬平臺支持通訊模式、私有通訊模式：通訊模式下支持?jǐn)?shù)據(jù)流和數(shù)據(jù)流：數(shù)據(jù)流是一個(gè)雙向數(shù)據(jù)流，飛馬平臺請求，系統(tǒng)反饋應(yīng)答。系統(tǒng)不維護(hù)失。流的狀態(tài)。系統(tǒng)故障時(shí)，

11、數(shù)據(jù)流會重置，通訊途中的數(shù)據(jù)可能會丟數(shù)據(jù)流是一個(gè)雙向數(shù)據(jù)流，飛馬平臺請求，系統(tǒng)反饋應(yīng)答。系統(tǒng)不維護(hù)失。流的狀態(tài)。系統(tǒng)故障時(shí)，數(shù)據(jù)流會重置，通訊途中的數(shù)據(jù)可能會丟私有通訊模式下支持私有數(shù)據(jù)流：私有流是一個(gè)單向數(shù)據(jù)流，由系統(tǒng)發(fā)向飛馬平臺，用于傳送員私有和回報(bào)信息。私有流是一個(gè)可靠的數(shù)據(jù)流，系統(tǒng)維護(hù)每個(gè)飛馬平臺的私有流，在一個(gè)日內(nèi)，飛馬平臺斷線后恢復(fù)連接時(shí)，可以請求系統(tǒng)指定序號之后的私有流數(shù)據(jù)。私有數(shù)據(jù)流向飛馬平臺提供報(bào)單狀態(tài)報(bào)告、成交回報(bào)等信息。所有上海金融期貨2013-06-193上海金融期貨技術(shù)文檔TraderAPI3.接口模式員 API 提供了二個(gè)接口，分別為 CUSTPFtdcTrader

12、Api 和CUSTPFtdcTraderSpi。這兩個(gè)接口對 FTD 協(xié)議進(jìn)行了封裝，方便客戶端應(yīng)用程序的開發(fā)?？蛻舳?應(yīng)用 程序 可以 通過 CUSTPFtdcTraderApi 發(fā)出 操作 請求 ， 通 繼承CUSTPFtdcTraderSpi 并重載回調(diào)函數(shù)來處理服務(wù)的響應(yīng)。3.1流和流編程接口通過流進(jìn)行通訊的編程接口通常如下：請求：int CUSTPFtdcTraderApi:Req(CUSTPFtdcField *pReq,int nRequestID)響應(yīng)：void CUSTPFtdcTraderSpi:OnRsp(CUSTPFtdcField *pRsp,CUSTPFtdcRsp

13、InfoField *pRspInfo, int nRequestID,bool bIsLast)其中請求接口第一個(gè)參數(shù)為請求的內(nèi)容，不能為空。第二個(gè)參數(shù)為請求號。請求號由客戶端應(yīng)用程序負(fù)責(zé)維護(hù)，正常情況下每個(gè)請求的請求號不要重復(fù)。在接收飛馬平臺的響應(yīng)時(shí)，可以得到當(dāng)時(shí)發(fā)出請求時(shí)填寫的請求號， 從而可以將響應(yīng)與請求對應(yīng)起來。當(dāng)收到服務(wù)應(yīng)答時(shí)，CUSTPFtdcTraderSpi 的回調(diào)函數(shù)會被調(diào)用。如果響應(yīng)數(shù)據(jù)不止一個(gè)，則回調(diào)函數(shù)會被多次調(diào)用?；卣{(diào)函數(shù)的第一個(gè)參數(shù)為響應(yīng)的具體數(shù)據(jù)，如果出錯(cuò)或沒有結(jié)果有可能為 NULL。第二個(gè)參數(shù)為處理結(jié)果，表明本次請求的處理結(jié)果是還是失敗。在發(fā)生多次回調(diào)時(shí)，除了

14、第一次回調(diào)，其它的回調(diào)該參數(shù)都可能為 NULL。第三個(gè)參數(shù)為請求號，即原來發(fā)出請求時(shí)填寫的請求號。第四個(gè)參數(shù)為響應(yīng)結(jié)束標(biāo)志，表明是否是本次響應(yīng)的最后一次回調(diào)。3.2 私有流編程接口私有流中的數(shù)據(jù)中用戶的私有信息，包括報(bào)單回報(bào)、成交回報(bào)等。通過私有流接收回報(bào)的編程接口通常如下：void CUSTPFtdcTraderSpi:OnRtn(CUSTPFtdcField *p) 或所有上海金融期貨2013-06-194上海金融期貨技術(shù)文檔TraderAPIvoid CUSTPFtdcTraderSpi:OnErrRtn(CUSTPFtdcField *p,CUSTPFtdcRspInfoField *

15、pRspInfo)當(dāng)收到飛馬平臺通過私有流發(fā)布的回報(bào)數(shù)據(jù)時(shí)，CUSTPFtdcTraderSpi 的回調(diào)函數(shù)會被調(diào)用?；卣{(diào)函數(shù)的參數(shù)為回報(bào)的具體內(nèi)容。所有上海金融期貨2013-06-195上海金融期貨技術(shù)文檔TraderAPI4.運(yùn)行模式4.1 工作線程員客戶端應(yīng)用程序至少由兩個(gè)線程組成，一個(gè)是應(yīng)用程序主線程，一個(gè)是員 API 工作線程。應(yīng)用程序與系統(tǒng)的通訊是由 API 工作線程驅(qū)動(dòng)的。CUSTPFtdcTraderApi 提供的接口是線程安全的，可以有多個(gè)應(yīng)用程序線程同時(shí)發(fā)出請求。CUSTPFtdcTraderSpi 提供的接口回調(diào)是由 API 工作線程驅(qū)動(dòng)，通過實(shí)現(xiàn) SPI 中的接口方法，

16、可以從飛馬平臺收取所需數(shù)據(jù)。如果重載的某個(gè)回調(diào)函數(shù)阻塞，則等于阻塞了 API 工作線程，API 與系統(tǒng)的通訊會停止。因此，在 CUSTPFtdcTraderSpi 派生類的回調(diào)函數(shù)中，通常應(yīng)迅速返回，可以利用將數(shù)據(jù)放入緩沖區(qū)或通過 Windows 的消息機(jī)制來實(shí)現(xiàn)。4.2 本地文件員 API 在運(yùn)行過程中，會將一 些數(shù)據(jù)寫入本地文件中。調(diào)用CreateFtdcTraderApi 函數(shù)，可以傳遞一個(gè)參數(shù)，指明存貯本地文件的路徑。該路徑必須在運(yùn)行前已創(chuàng)建好。本地文件的擴(kuò)展名都是”.con”。所有上海金融期貨2013-06-196上海金融期貨技術(shù)文檔TraderAPI5.業(yè)務(wù)和接口對照所有上海金融期

17、貨2013-06-197業(yè)務(wù)類型業(yè)務(wù)請求接口響應(yīng)接口數(shù)據(jù)流登錄登錄CUSTPFtdcTraderApi: ReqUserLoginCUSTPFtdcTraderSpi:OnRspUserLogin流登出CUSTPFtdcTraderApi:ReqUserLogoutCUSTPFtdcTraderSpi:OnRspUserLogout流修改用戶口令CUSTPFtdcTraderApi:ReqUserPasswordUpdateCUSTPFtdcTraderSpi:OnRspUserPasswordUpdate流報(bào)單報(bào)單錄入CUSTPFtdcTraderApi:ReqOrderInsertCUST

18、PFtdcTraderSpi:OnRspOrderInsert流報(bào)單操作CUSTPFtdcTraderApi:ReqOrderActionCUSTPFtdcTraderSpi:OnRspOrderAction流報(bào)價(jià)報(bào)價(jià)錄入CUSTPFtdcTraderApi:Re uoteInsertCUSTPFtdcTraderSpi:OnRspQuoteInsert流報(bào)價(jià)操作CUSTPFtdcTraderApi:Re uoteActionCUSTPFtdcTraderSpi:OnRspQuoteAction流詢價(jià)詢價(jià)請求CUSTPFtdcTraderApi:ReqForQuoteCUSTPFtdcTrad

19、erSpi: OnRspForQuote流私有回報(bào)成交回報(bào)N/ACUSTPFtdcTraderSpi:OnRrade私有流報(bào)單回報(bào)N/ACUSTPFtdcTraderSpi:OnRtnOrder私有流出入金回報(bào)N/ACUSTPFtdcTraderSpi:OnRtnInvestorAccountDepos it私有流上海金融期貨技術(shù)文檔TraderAPI所有上海金融期貨2013-06-198報(bào)單錄入錯(cuò)誤回報(bào)N/ACUSTPFtdcTraderSpi:OnErrRtnOrderInsert私有流報(bào)單操作錯(cuò)誤回報(bào)N/ACUSTPFtdcTraderSpi:OnErrRtnOrderAction私有流

20、報(bào)價(jià)回報(bào)N/ACUSTPFtdcTraderSpi:OnRtnQuote私有流報(bào)價(jià)錄入錯(cuò)誤回報(bào)N/ACUSTPFtdcTraderSpi:OnErrRtnQuoteInsert私有流詢價(jià)回報(bào)詢價(jià)回報(bào)N/ACUSTPFtdcTraderSpi:OnRtnForQuote詢價(jià)流報(bào)單CUSTPFtdcTraderApi:Re ryOrderCUSTPFtdcTraderSpi:OnRspQryOrder流成交CUSTPFtdcTraderApi:Re ryTradeCUSTPFtdcTraderSpi:OnRspQryTrade流合約CUSTPFtdcTraderApi:Re ryInstrumen

21、tCUSTPFtdcTraderSpi:OnRspQryInstrument流可用投資者CUSTPFtdcTraderApi:Re ryUserInvestorCUSTPFtdcTraderSpi:OnRspQryUserInvestor流資金賬戶CUSTPFtdcTraderApi:Re ryInvestorAccountCUSTPFtdcTraderSpi:OnRspQryInvestorAccount流編碼CUSTPFtdcTraderApi:Re ryTradingCodeCUSTPFtdcTraderSpi:OnRspQryTradingCode流所CUSTPFtdcTraderAp

22、i:Re ryExchangeCUSTPFtdcTraderSpi:OnRspQryExchange流投資者持倉CUSTPFtdcTraderApi:Re ryInvestorPositio nCUSTPFtdcTraderSpi:OnRspQryInvestorPosition流合規(guī)參數(shù)CUSTPFtdcTraderApi: Re ryComplianceParamCUSTPFtdcTraderSpi: OnRspQryComplianceParam流上海金融期貨技術(shù)文檔TraderAPI接口和私有流接口會有相互關(guān)聯(lián)，如用戶報(bào)單錄入 ReqOrderInsert，馬上會收到報(bào)單響應(yīng) OnRs

23、pOrderInsert，說明系統(tǒng)已經(jīng)收到報(bào)單。報(bào)單進(jìn)入系統(tǒng)后，如果報(bào)單的狀態(tài)發(fā)生變化，就會收到報(bào)單回報(bào) OnRtnOrder。如果報(bào)單被撮合(部分)成交，就會收到成交回報(bào) OnRrade。其中，一個(gè)用戶的報(bào)單回報(bào)和成交回報(bào)也會被所屬投資者下其他的用戶接收到。所有上海金融期貨2013-06-199手續(xù)費(fèi)率CUSTPFtdcTraderApi: Re ryInvestorFeeCUSTPFtdcTraderSpi: OnRspQryInvestorFee流保證金率CUSTPFtdcTraderApi: Re ryInvestorMarginCUSTPFtdcTraderSpi: OnRspQry

24、InvestorMargin流上海金融期貨技術(shù)文檔TraderAPI6.開發(fā)接口6.1 通用規(guī)則客戶端和飛馬平臺的通訊過程分為 2 個(gè)階段：初始化階段和功能調(diào)用階段。在初始化階段，程序必須完成如下步驟（具體代碼請參考開發(fā)實(shí)例）：1,2,3,4,5,6,產(chǎn)生一個(gè)CUstpFtdcTraderApi 實(shí)例產(chǎn)生一個(gè)處理的實(shí)例一個(gè)處理的實(shí)例訂閱私有流訂閱公共流設(shè)置飛馬平臺服務(wù)的地址在功能調(diào)用階段，程序可以任意調(diào)用接口中的請求方法，如 ReqOrderInsert 同時(shí)按照需要響應(yīng)回調(diào)接口中的應(yīng)答方法。其他注意事項(xiàng)：1，API 請求的輸入?yún)?shù)不能為 NULL。2，API 請求的返回參數(shù)，0 表示正確，其

25、他表示錯(cuò)誤，詳細(xì)錯(cuò)誤編碼請查表。等。6.2 CUstpFtdcTraderSpi 接口CUstpFtdcTraderSpi 實(shí)現(xiàn)了口，編寫處理方法來處理感通知接口。用戶必需派生 CUstpFtdcTraderSpi 接的。6.2.1 OnFrontConnected 方法當(dāng)客戶端與飛馬平臺建立起通信連接時(shí)（還未登錄前），該方法被調(diào)用。函數(shù)：void OnFrontConnected()；本方法在完成初始化后調(diào)用，可以在其中完成用戶登錄任務(wù)。6.2.2 OnFrontDisconnected 方法當(dāng)客戶端與飛馬平臺通信連接斷開時(shí)，該方法被調(diào)用。當(dāng)發(fā)生這個(gè)情況后，API 會自所有上海金融期貨201

26、3-06-1910上海金融期貨技術(shù)文檔TraderAPI動(dòng)重新連接，客戶端可不做處理。自動(dòng)重連地址，可能是原來統(tǒng)支持的其它可用的通信地址，它由程序自動(dòng)選擇。的地址，也可能是系函數(shù)：void OnFrontDisconnected (int nReason)；參數(shù)：nReason：連接斷開0x10010x10020x20010x20020x2003網(wǎng)絡(luò)讀失敗 網(wǎng)絡(luò)寫失敗 接收心跳超時(shí)心跳失敗收到錯(cuò)誤報(bào)文6.2.3 OnHeartBeatWarning 方法心跳超時(shí)警告。當(dāng)長時(shí)間未收到報(bào)文時(shí)，該方法被調(diào)用。函數(shù)：void OnHeartBeatWarning(in參數(shù)：imeLapse)；nTim

27、eLapse：距離上次接收報(bào)文的時(shí)間6.2.4 OnRspUserLogin 方法當(dāng)客戶端發(fā)出登錄請求之后，飛馬平臺返回響應(yīng)時(shí)，該方被調(diào)用，通知客戶端登錄是否函數(shù)。：void OnRspUserLogin(CUstpFtdcRspUserLoginField *pRspUserLogin, CUstpFtdcRspInfoField *pRspInfo,int nRequestID, bool bIsLast)；參數(shù)：pRspUserLogin：返回用戶登錄信息的地址。用戶登錄信息結(jié)構(gòu)：struct CUstpFtdcRspUserLoginField/日TUstpFtdcDateType/經(jīng)

28、紀(jì)公司編號TradingDay;所有上海金融期貨2013-06-1911上海金融期貨技術(shù)文檔TraderAPITUstpFtdcBrokerIDTypeBrokerID;/用戶代碼TUstpFtdcUserIDType UserID;/登錄時(shí)間TUstpFtdcTimeType/最大本地報(bào)單號LoginTime;TUstpFtdcOrderLocalIDTypeMaxOrderLocalID;/系統(tǒng)名稱TUstpFtdcTradingSystemNameType TradingSystemName;pRspInfo：返回用戶響應(yīng)信息的地址。特別注意在有連續(xù)的的響應(yīng)數(shù)據(jù)時(shí)，中間有可能返回，以下同

29、。NULL，但第一次，以下同。錯(cuò)誤代碼為 0 時(shí)，表示操作響應(yīng)信息結(jié)構(gòu)：struct CUstpFtdcRspInfoField/錯(cuò)誤代碼TUstpFtdcErrorIDType/錯(cuò)誤信息TUstpFtdcErrorMsgType;ErrorID;ErrorMsg;nRequestID：返回用戶登錄請求的 ID，該 ID 由用戶在登錄時(shí)指定。bIsLast：指示該次返回是否為nRequestID 的最后一次返回。6.2.5 OnRspUserLogout 方法當(dāng)客戶端發(fā)出請求之后，飛馬平臺返回響應(yīng)時(shí)，該方被調(diào)用，通知客戶端是否函數(shù)。：void OnRspUserLogout(CUstpFtdc

30、RspUserLogoutField *pRspUserLogout, CUstpFtdcRspInfoField *pRspInfo,int nRequestID, bool bIsLast)；參數(shù)：pRspUserLogout：返回用戶用戶登出信息結(jié)構(gòu)：信息的地址。struct CUstpFtdcRspUserLogoutField/經(jīng)紀(jì)公司編號TUstpFtdcBrokerIDTypeBrokerID;/用戶代碼TUstpFtdcUserIDType UserID;所有上海金融期貨2013-06-1912上海金融期貨技術(shù)文檔TraderAPIpRspInfo：返回用戶響應(yīng)信息的地址。響應(yīng)

31、信息結(jié)構(gòu)：struct CUstpFtdcRspInfoField/錯(cuò)誤代碼TUstpFtdcErrorIDType ErrorID;/錯(cuò)誤信息TUstpFtdcErrorMsgType ErrorMsg;nRequestID：返回用戶登出請求的 ID，該 ID 由用戶在登出時(shí)指定。bIsLast：指示該次返回是否為nRequestID 的最后一次返回。6.2.6 OnRspUserPasswordUpdate 方法用戶修改應(yīng)答。當(dāng)客戶端發(fā)出用戶修改指令后，飛馬平臺返回響應(yīng)時(shí)，該方被調(diào)用。函數(shù)：void OnRspUserPasswordUpdate( CUstpFtdcUserPasswor

32、dUpdateField *pUserPasswordUpdate, CUstpFtdcRspInfoField *pRspInfo,int nRequestID, bool bIsLast)；參數(shù)：pUserPasswordUpdate：指向用戶用戶修改結(jié)構(gòu)：修改結(jié)構(gòu)的地址，包含了用戶修改請求的輸入數(shù)據(jù)。struct CUstpFtdcUserPasswordUpdateField/經(jīng)紀(jì)公司編號TUstpFtdcBrokerIDTypeBrokerID;/用戶代碼TUstpFtdcUserIDType UserID;/舊TUstpFtdcPasswordType/新TUstpFtdcPass

33、wordTypeOldPassword;NewPassword;pRspInfo：返回用戶響應(yīng)信息的地址。響應(yīng)信息結(jié)構(gòu)：struct CUstpFtdcRspInfoField/錯(cuò)誤代碼TUstpFtdcErrorIDType ErrorID;所有上海金融期貨2013-06-1913上海金融期貨技術(shù)文檔TraderAPI/錯(cuò)誤信息TUstpFtdcErrorMsgType ErrorMsg;nRequestID：返回用戶修改請求的 ID，該 ID 由用戶在修改時(shí)指定。bIsLast：指示該次返回是否為nRequestID 的最后一次返回。6.2.7 OnRspError 方法用戶請求的出錯(cuò)通知

34、。函數(shù)：void OnRspError(CUstpFtdcRspInfoField * pRspInfo, int nRequestID,bool bIsLast)參數(shù)：pRspInfo：返回用戶響應(yīng)信息的地址。響應(yīng)信息結(jié)構(gòu)：struct CUstpFtdcRspInfoField/錯(cuò)誤代碼TUstpFtdcErrorIDType ErrorID;/錯(cuò)誤信息TUstpFtdcErrorMsgType ErrorMsg;nRequestID：返回用戶操作請求的 ID，該 ID 由用戶在操作請求時(shí)指定。bIsLast：指示該次返回是否為nRequestID 的最后一次返回。6.2.8 OnRspO

35、rderInsert 方法報(bào)單錄入應(yīng)答。當(dāng)客戶端發(fā)出過報(bào)單錄入指令后，飛馬平臺返回響應(yīng)時(shí)，該方被調(diào)用。函數(shù)：void OnRspOrderInsert(CUstpFtdcInputOrderField *pInputOrder, CUstpFtdcRspInfoField *pRspInfo,int nRequestID, bool bIsLast)；參數(shù)：pInputOrder：指向報(bào)單錄入結(jié)構(gòu)的地址，包含了提交報(bào)單錄入時(shí)的輸入數(shù)據(jù)，和返回的報(bào)所有上海金融期貨2013-06-1914上海金融期貨技術(shù)文檔TraderAPI單編號。輸入報(bào)單結(jié)構(gòu)：struct CUstpFtdcInputOrde

36、rField/經(jīng)紀(jì)公司編號TUstpFtdcBrokerIDTypeBrokerID;/所代碼TUstpFtdcExchangeIDType/系統(tǒng)報(bào)單編號TUstpFtdcOrderSysIDType/投資者編號TUstpFtdcInvestorIDType/用戶代碼ExchangeID;OrderSysID;InvestorID;TUstpFtdcUserIDType UserID;/合約代碼TUstpFtdcInstrumentIDType/用戶本地報(bào)單號InstrumentID;TUstpFtdcUserOrderLocalIDType/報(bào)單類型UserOrderLocalID;TUst

37、pFtdcOrderPriceTypeType OrderPriceType;/方向TUstpFtdcDirectionType/開平標(biāo)志TUstpFtdcOffsetFlagType/投機(jī)套保標(biāo)志TUstpFtdcHedgeFlagType/價(jià)格Direction;OffsetFlag;HedgeFlag;TUstpFtdcPriceType LimitPrice;/數(shù)量 TUstpFtdcVolumeType Volume;/有效期類型TUstpFtdcTimeConditionType TimeCondition;/GTD 日期TUstpFtdcDateType/成交量類型GTDDate

38、;TUstpFtdcVolumeConditionTypeVolumeCondition;/最小成交量TUstpFtdcVolumeType MinVolume;/止損價(jià)TUstpFtdcPriceType StopPrice;/強(qiáng)平TUstpFtdcForceCloseReasonType/自動(dòng)掛起標(biāo)志ForceCloseReason;TUstpFtdcBoolTypeIsAutoSuspend;所有上海金融期貨2013-06-1915上海金融期貨技術(shù)文檔TraderAPI/業(yè)務(wù)單元TUstpFtdcBusinessUnitType/用戶自定義域 64 字節(jié)BusinessUnit;TUst

39、pFtdcCustomType UserCustom;pRspInfo：返回用戶響應(yīng)信息的地址。響應(yīng)信息結(jié)構(gòu)：struct CUstpFtdcRspInfoField/錯(cuò)誤代碼TUstpFtdcErrorIDType ErrorID;/錯(cuò)誤信息TUstpFtdcErrorMsgType ErrorMsg;nRequestID：返回報(bào)單錄入操作請求的 ID，該 ID 由用戶在報(bào)單錄入時(shí)指定。bIsLast：指示該次返回是否為nRequestID 的最后一次返回。6.2.9 OnRspOrderAction 方法報(bào)單操作應(yīng)答。報(bào)單操作包括報(bào)單的撤銷、報(bào)單的掛起（暫不支持）、報(bào)單的激活（暫不支持）、

40、報(bào)單的修改（暫不支持）。當(dāng)客戶端發(fā)出過報(bào)單操作指令后，飛馬平臺返回響應(yīng)時(shí)，該方函數(shù)被調(diào)用。：void OnRspOrderAction(CUstpFtdcOrderActionField * pOrderAction, CUstpFtdcRspInfoField * pRspInfo,int nRequestID, bool bIsLast)；參數(shù)：pOrderAction：指向報(bào)單操作結(jié)構(gòu)的地址，包含了提交報(bào)單操作的輸入數(shù)據(jù)，和編號。報(bào)單操作結(jié)構(gòu)：struct CUstpFtdcOrderActionField返回的報(bào)單/所代碼TUstpFtdcExchangeIDTypeExchangeI

41、D;/所系統(tǒng)報(bào)單編號TUstpFtdcOrderSysIDType/經(jīng)紀(jì)公司編號TUstpFtdcBrokerIDType/投資者編號OrderSysID;BrokerID;所有上海金融期貨2013-06-1916上海金融期貨技術(shù)文檔TraderAPITUstpFtdcInvestorIDType InvestorID;/用戶操作本地編號TUstpFtdcOrderLocalIDType/本地報(bào)單編號UserOrderActionLocalID;TUstpFtdcUserOrderLocalIDType/報(bào)單操作標(biāo)志UserOrderLocalID;TUstpFtdcActionFlagTyp

42、e ActionFlag;/價(jià)格 保留域TUstpFtdcPriceType LimitPrice;/數(shù)量變化-保留域TUstpFtdcVolumeType VolumeChange;pRspInfo：返回用戶響應(yīng)信息的地址。響應(yīng)信息結(jié)構(gòu)：struct CUstpFtdcRspInfoField/錯(cuò)誤代碼TUstpFtdcErrorIDType ErrorID;/錯(cuò)誤信息TUstpFtdcErrorMsgType ErrorMsg;nRequestID：返回用戶報(bào)單操作請求的 ID，該 ID 由用戶在報(bào)單操作時(shí)指定。bIsLast：指示該次返回是否為nRequestID 的最后一次返回。6.2

43、.10OnRspQryOrder 方法報(bào)單調(diào)用。函數(shù)請求。當(dāng)客戶端發(fā)出報(bào)單指令后，飛馬平臺返回響應(yīng)時(shí)，該方被：void OnRspQryOrder(CUstpFtdcOrderField *pOrder, CUstpFtdcRspInfoField *pRspInfo, int nRequestID,bool bIsLast)；參數(shù)：pOrder：指向報(bào)單報(bào)單信息結(jié)構(gòu)：的返回結(jié)構(gòu)信息的地址。struct CUstpFtdcOrderField/經(jīng)紀(jì)公司編號TUstpFtdcBrokerIDTypeBrokerID;/所代碼TUstpFtdcExchangeIDTypeExchangeID;所有

44、上海金融期貨2013-06-1917上海金融期貨技術(shù)文檔TraderAPI/系統(tǒng)報(bào)單編號TUstpFtdcOrderSysIDType OrderSysID;/投資者編號TUstpFtdcInvestorIDType InvestorID;/用戶代碼TUstpFtdcUserIDType UserID;/合約代碼TUstpFtdcInstrumentIDType/用戶本地報(bào)單號InstrumentID;TUstpFtdcUserOrderLocalIDType/報(bào)單類型UserOrderLocalID;TUstpFtdcOrderPriceTypeType OrderPriceType;/方向

45、TUstpFtdcDirectionType/開平標(biāo)志TUstpFtdcOffsetFlagType/投機(jī)套保標(biāo)志TUstpFtdcHedgeFlagType/價(jià)格Direction;OffsetFlag;HedgeFlag;TUstpFtdcPriceType LimitPrice;/數(shù)量 TUstpFtdcVolumeType Volume;/有效期類型TUstpFtdcTimeConditionType TimeCondition;/GTD 日期 保留字段TUstpFtdcDateType/成交量類型GTDDate;TUstpFtdcVolumeConditionTypeVolumeCo

46、ndition;/最小成交量TUstpFtdcVolumeType MinVolume;/止損價(jià) 保留字段TUstpFtdcPriceType StopPrice;/強(qiáng)平保留字段TUstpFtdcForceCloseReasonType/自動(dòng)掛起標(biāo)志 保留字段ForceCloseReason;TUstpFtdcBoolTypeIsAutoSuspend;/業(yè)務(wù)單元 保留字段TUstpFtdcBusinessUnitType/用戶自定義域BusinessUnit;TUstpFtdcCustomType UserCustom;/日TUstpFtdcTradingDayType TradingDay

47、;/會員編號TUstpFtdcParticipantIDType ParticipantID;所有上海金融期貨2013-06-1918上海金融期貨技術(shù)文檔TraderAPI/客戶號TUstpFtdcClientIDType/下單席位號ClientID;TUstpFtdcSeatIDType SeatID;/時(shí)間TUstpFtdcTimeType/本地報(bào)單編號InsertTime;TUstpFtdcOrderLocalIDType/報(bào)單來源TUstpFtdcOrderSourceType/報(bào)單狀態(tài)TUstpFtdcOrderStatusType/撤銷時(shí)間OrderLocalID;OrderSou

48、rce;OrderStatus;TUstpFtdcTimeType/撤單用戶編號CancelTime;TUstpFtdcUserIDType CancelUserID;/今成交數(shù)量 TUstpFtdcVolumeType VolumeTraded;/剩余數(shù)量TUstpFtdcVolumeType VolumeRemain;pRspInfo：返回用戶響應(yīng)信息的地址。響應(yīng)信息結(jié)構(gòu)：struct CUstpFtdcRspInfoField/錯(cuò)誤代碼TUstpFtdcErrorIDType ErrorID;/錯(cuò)誤信息TUstpFtdcErrorMsgType ErrorMsg;nRequestID：返

49、回用戶報(bào)單請求的 ID，該 ID 由用戶在報(bào)單bIsLast：指示該次返回是否為nRequestID 的最后一次返回。時(shí)指定。6.2.11OnRspQryTrade 方法成交單會被調(diào)用。函數(shù)應(yīng)答。當(dāng)客戶端發(fā)出成交單指令后，飛馬平臺返回響應(yīng)時(shí)，該方法：void OnRspQryTrade( CUstpFtdcTradeField * CUstpFtdcRspInfoField int nRequestID,bool bIsLast)；pTrade,*pRspInfo,所有上海金融期貨2013-06-1919上海金融期貨技術(shù)文檔TraderAPI參數(shù)：pTrade：指向成交信息結(jié)構(gòu)的地址。成交信息

50、結(jié)構(gòu)：structCUstpFtdcTradeField/經(jīng)紀(jì)公司編號TUstpFtdcBrokerIDTypeBrokerID;/所代碼TUstpFtdcExchangeIDTypeExchangeID;/日TUstpFtdcTradingDayType/會員編號TradingDay;TUstpFtdcParticipantIDType ParticipantID;/下單席位號TUstpFtdcSeatIDType SeatID;/投資者編號TUstpFtdcInvestorIDType InvestorID;/客戶號TUstpFtdcClientIDType/用戶編號ClientID;TUstpFtdcUserIDType UserID;/成交編號TUstpFtdcTradeIDType/本地報(bào)單編號TradeID;TUstpFtdcOrderLocalIDType/合約代碼TUstpFtdcInstrumentIDTypeUserOrderLocalID;InstrumentID;/方向