上海證券交易所技術(shù)文檔上海證券交易所期權(quán)模擬交易系統(tǒng)市場(chǎng)參與者接口規(guī)格說(shuō)明書(shū)（技術(shù)開(kāi)發(fā)稿）（1.01版） ,《上海證券交易所期權(quán)模擬交易系統(tǒng)市場(chǎng)參與者接口規(guī)格說(shuō)明書(shū)》1.0

上海證券交易所技術(shù)文檔

上海證券交易所

期權(quán)模擬交易系統(tǒng)

市場(chǎng)參與者接口規(guī)格說(shuō)明書(shū)

（技術(shù)開(kāi)發(fā)稿）

（1.01版）

《上海證券交易所期權(quán)模擬交易系統(tǒng)市場(chǎng)參與者接口規(guī)格說(shuō)明書(shū)》1.01版發(fā)布說(shuō)明

2013-08-16 根據(jù)個(gè)股期權(quán)業(yè)務(wù)方案更新稿，調(diào)整并修訂市場(chǎng)參與者接口規(guī)格（技術(shù)開(kāi)發(fā)部修訂） 2013-07-15 根據(jù)個(gè)股期權(quán)業(yè)務(wù)方案對(duì)市場(chǎng)參與部分做更新（技術(shù)開(kāi)發(fā)部修訂）

2012-06-06 對(duì)市價(jià)轉(zhuǎn)限價(jià)訂單在沒(méi)有任何對(duì)手盤(pán)可供成交之際的申報(bào)應(yīng)答作出補(bǔ)充說(shuō)明

本文檔為市場(chǎng)參與者通過(guò)STEP 消息接入上交所期權(quán)模擬交易系統(tǒng)的接口規(guī)格。

本文檔定義了上交所期權(quán)模擬交易市場(chǎng)參與者STEP 接口。

本文檔由上海證券交易所起草，并負(fù)責(zé)進(jìn)行解釋。

服務(wù)電話：021-68644780

通信地址：上海市浦東南路528號(hào)上海證券交易所

目錄

1 數(shù)據(jù)格式約定 . ..................................................................................................... 4 2 期權(quán)模擬交易系統(tǒng)接口規(guī)范 ................................................................................ 5

2.1 .......... 申報(bào)類STEP 消息流程圖 . ........................................................................ 5

2.2 .......... 文件接口處理原則 . ................................................................................. 6

2.2.1 ............ 格式約定 .............................................................................................. 6

2.2.2 ............ 結(jié)構(gòu)描述 .............................................................................................. 6 3 STEP 消息規(guī)范 ..................................................................................................... 8

3.1 .......... 行情數(shù)據(jù) ................................................................................................ 8

3.2 .......... 申報(bào)指令 .............................................................................................. 10

3.3 .......... 非交易指令-證券凍結(jié)與解凍指令......................................................... 12

3.4 .......... 非交易指令-行權(quán)指令 .......................................................................... 13

3.5 .......... 撤單指令 .............................................................................................. 14

3.6 .......... 申報(bào)指令響應(yīng)/撤單指令成功響應(yīng)消息 ................................................. 16

3.7 .......... 撤單指令失敗響應(yīng)消息 . ........................................................................ 17

3.8 .......... 執(zhí)行報(bào)告 .............................................................................................. 18 4 文件接口規(guī)范 . ................................................................................................... 21

4.1 .......... 期權(quán)行情文件接口mktdt03.txt . ........................................................... 21

4.2 .......... 期權(quán)基礎(chǔ)信息 ref03MMDD.txt ............................................................ 24

4.3 .......... 成交過(guò)戶數(shù)據(jù)接口 trns03XXXXX.txt .................................................. 28 5 全真模擬交易接口規(guī)范...................................................................................... 32

技術(shù)文檔 1 數(shù)據(jù)格式約定

數(shù)據(jù)格式約定參見(jiàn)《上海證券交易所市場(chǎng)參與者 EzSTEP 通用數(shù)據(jù)庫(kù)接口規(guī)格說(shuō)明書(shū)》文檔。 STEP 消息約定參見(jiàn)《上海證券交易所市場(chǎng)參與者 EzSTEP 通用數(shù)據(jù)庫(kù)接口規(guī)格說(shuō)明書(shū)》文檔。

通用數(shù)據(jù)庫(kù)接口參見(jiàn)《上海證券交易所市場(chǎng)參與者 EzSTEP 通用數(shù)據(jù)庫(kù)接口規(guī)格說(shuō)明書(shū)》文檔。其中，數(shù)據(jù)庫(kù)接口中：

請(qǐng)求業(yè)務(wù)類型編號(hào)（reqid ），本業(yè)務(wù)取值：

●

●

●

數(shù)據(jù)廣播類型（bcasttype ），本業(yè)務(wù)取值：

7C 期權(quán)交易執(zhí)行報(bào)告

7H 期權(quán)交易行情數(shù)據(jù)

消息類型（MsgType ），本業(yè)務(wù)取值：

8 =申報(bào)響應(yīng)或執(zhí)行報(bào)告（Execution Report）

9 =申報(bào)撤消失?。∣rderCancelReject ）

D =申報(bào)（NewOrder Single）

F =申報(bào)撤單（OrderCancel Request）

W=行情數(shù)據(jù)（Market Data）

證券標(biāo)識(shí)(SecurityID)，本業(yè)務(wù)取值799888

OTO = 申報(bào)指令-期權(quán)訂單（Option Trading Order Entry） OTU = 非交易指令-證券凍結(jié)與解凍指令（Option Trading Underlying Transfer） OTE = 非交易指令-行權(quán)指令/撤銷行權(quán)指令（Option Trading Execution Instruction）

期權(quán)交易平臺(tái) 市場(chǎng)參與者接口規(guī)格說(shuō)明書(shū) 第4頁(yè) 共32頁(yè)

技術(shù)文檔 2

2.1 期權(quán)模擬交易系統(tǒng)接口規(guī)范 申報(bào)類STEP 消息流程圖

在發(fā)起方登錄時(shí)，客戶端將收到全量的市場(chǎng)申報(bào)信息（即公共數(shù)據(jù)廣播），之后只發(fā)新增的公共數(shù)據(jù)。

根據(jù)期權(quán)交易的操作流程，市場(chǎng)參與者通過(guò)STEP 接口進(jìn)行申報(bào)，交易平臺(tái)通過(guò)集合競(jìng)價(jià)和連續(xù)競(jìng)價(jià)的模式進(jìn)行撮合配對(duì)。發(fā)起方可以進(jìn)行申報(bào)，以及相應(yīng)的撤單等操作。下圖描述了期權(quán)交易的STEP 消息通信流程。

期權(quán)交易平臺(tái) 市場(chǎng)參與者接口規(guī)格說(shuō)明書(shū) 第5頁(yè) 共32頁(yè)

技術(shù)文檔

2.2 文件接口處理原則

期權(quán)交易系統(tǒng)生成給市場(chǎng)參與者的文件接口包括了兩種不同的文件格式：DBF 格式和基于ASCII 的TXT 文本。

對(duì)于TXT 文本格式，需要遵循以下的處理原則。

2.2.1 格式約定

文本txt 文件，格式約定如下：

（一）豎線('|')為字段間分隔符，字段數(shù)據(jù)內(nèi)容不應(yīng)含有分隔符；

（二）豎線('|')不應(yīng)用在每條記錄的開(kāi)頭和結(jié)尾；

（三）各字段均為一個(gè)遵循格式定義的字符串，字段間有嚴(yán)格前后順序；

（四）字段定長(zhǎng)，字段格式定義約定了長(zhǎng)度和精度；字符型字段以CX 格式表示，其中X 代表字符串長(zhǎng)度，不足部分左對(duì)齊，右補(bǔ)空格；整數(shù)數(shù)字型字段以NX 格式表示，其中X 代表數(shù)字型字符串長(zhǎng)度，不足部分右對(duì)齊，左補(bǔ)空格；浮點(diǎn)數(shù)字型字段以NX (Y)格式表示，其中X 代表數(shù)字型字符串總長(zhǎng)度，Y 代表小數(shù)位數(shù)，X 包括一位小數(shù)點(diǎn)，整數(shù)部分最多不超過(guò)X-Y-1位，小數(shù)部分最多不超過(guò)Y 位，不足部分右對(duì)齊，左補(bǔ)空格；

（五）每行以二進(jìn)制0x0A 結(jié)束，最后一行也以0x0A 結(jié)束。

（六）文檔命名采取文檔含義（英文縮寫(xiě)）和類型數(shù)字標(biāo)簽相結(jié)合的方式，格式為

“ABCDEFxy ”。第一部分“ABCDEF ”為文檔含義的英文縮寫(xiě)，“xy ”為兩位的阿拉伯?dāng)?shù)字，表示平臺(tái)來(lái)源。例如“TRNSDT03”，TRNSDT 代表事務(wù)類數(shù)據(jù)，03代表衍生品交易平臺(tái)。

（七）文檔中記錄會(huì)采用記錄標(biāo)識(shí)類型，格式為“GHyzz ”?！癎H ”取文檔含義中的兩個(gè)首字母，“y ”從文檔名稱中繼承，“zz ”是同類文檔中的細(xì)分。例如“TRNSDT03”表示非交易業(yè)務(wù)數(shù)據(jù)，記錄中“TD301”表示成交數(shù)據(jù)、“TD0302”表示現(xiàn)行權(quán)數(shù)據(jù)。

2.2.2 結(jié)構(gòu)描述

TXT 格式的文件，將采用以下的組織結(jié)構(gòu)。

（一）文件包含文件頭、文件體、文件尾三個(gè)部分；

（二）注意文件具有可擴(kuò)展性，文件記錄尾部可能隨時(shí)增加擴(kuò)展字段，接收處理方應(yīng)能向下兼容處理，即增加擴(kuò)展字段后，對(duì)新增字段無(wú)需識(shí)別處理的用戶，不需要升級(jí)系統(tǒng)；

（三）文件體中，對(duì)于不同的記錄數(shù)據(jù)類型，分別定義記錄格式，接收處理方應(yīng)能根據(jù)行情數(shù)據(jù)類型識(shí)別處理；

期權(quán)交易平臺(tái) 市場(chǎng)參與者接口規(guī)格說(shuō)明書(shū) 第6頁(yè) 共32頁(yè)