1、上海证券交易所技术文档上海证券交易所IS113 上海证券交易所股票期权市场参与者接口规格说明书 1.0871 版本上海证券交易所二一六年十月IS113 上海证券交易所股票期权市场参与者接口规格说明书 1.1087 版本发布说明2016-8-26 对市场参与者接口规格做了如下的修订（技术开发总部修订），主要是部分接口新增预留字段： 3.1 行情数据和 4.1 期权行情文件接口各新增一个预留时间字段，暂无业务含义。预留字段暂填 00:00:00.000。 4.2 期权基础信息新增一个预留日期字段，4.4 期权持仓余额对账文件和 4.5 期权收盘价格文件各新增一个预留数量字段，暂无业务含义。三个预留
2、字段暂填空格。2015-10-27 对市场参与者接口规格做了如下的修订（技术开发部修订） 根据指数熔断，更新 4.1 期权行情接口文件产品实时阶段及标志。 根据指数熔断，更新 3.1 行情数据产品实时阶段及标志。本次修订于 2016 年 1 月 1 日起正式生效。2015-1-13 对市场参与者接口规格做了如下的修订（技术开发部修订） 根据业务的反馈意见，更新 4.6 期权市场参与者数据报送文件中的描述部分。 文件接口处理原则中，增加标志文件格式描述。2014-12-25 对市场参与者接口规格做了如下的修订（技术开发部修订） 4.6 期权市场参与者数据报送文件中，去除会员机构代码表。 金额描述
3、由精确到 0.1 厘调整为精确到 0.0001 元 调整接口中相关字段名，与股票期权试点交易规则一致2014-12-12 对市场参与者接口规格做了如下的修订（技术开发部修订） 文档名称调整为股票期权市场参与者接口规格说明书。2014-10-30 对市场参与者接口规格做了如下的修订（技术开发部修订） 4.6 期权行情文件接口中，明确了相关字段的时间有效性。 OwnerType102=会员发起,修改为 102=期权经营机构（包括其风险管理部门）发起2014-10-28 对市场参与者接口规格做了如下的修订（技术开发部修订） 4.1 期权行情文件接口中，对于字段“产品实时阶段及标志”，明确该字段第二位
4、为预留，暂填空格。 2014-09-26 对市场参与者接口规格做了如下的修订（技术开发部修订） 期权市场参与者数据报送文件（cybsxxxxxYYYYMMDD001.txt）中，修改RFStreamID 字段说明为“A0302 表示期权账户资料信息，此处为唯一值”。 期权市场参与者数据报送文件（cybsxxxxxYYYYMMDD001.txt）中。补充BrokerNum 字段说明，“采用全称，如 *证券股份有限公司 ”。 期权市场参与者数据报送文件（cybsxxxxxYYYYMMDD001.txt）中，补充mainMargin 字段说明，“各券商按照自己（券商）的方式进行计算即可”。 期权市场
5、参与者数据报送文件（cybsxxxxxYYYYMMDD001.txt）中，补充会员机构代码 期权行情新增收盘集合竞价状态2014-08-26 对市场参与者接口规格做了如下的修订（技术开发部修订） 期权基础信息文件中修改 SecurityStatusFlag 字段，删除第 5 位关于 D表示当日摘牌的合约的描述。2014-08-21 对市场参与者接口规格做了如下的修订（技术开发部修订） 期权市场参与者数据报送文件中修改报送时间，从原有的“15:30-20:00”，调整为“15:30（T 日）-7:00（T+1 日）” 成交过户数据接口中修改人民币币种描述，由 RMB 调整为 CNY2014-08
6、-07 对市场参与者接口规格做了如下的修订（技术开发部修订） 期权市场参与者数据报送文件（cybsxxxxxYYYYMMDD001.txt）中修改衍生品可用保证金金额字段说明、可买入额度字段说明，及明确自营账户无需报备。2014-07-09 对市场参与者接口规格做了如下的修订（技术开发部修订） 期权会员数据报送文件变更为期权市场参与者数据报送文件（cybsxxxxxYYYYMMDD001.txt） 期权行情数据及行情文件接口中，TradingPhaseCode 新增限开仓标识2014-07-01 对市场参与者接口规格做了如下的修订（技术开发部修订） 在期权基础信息文件中，修改到期日提醒为 5
7、日提醒。2014-06-25 对市场参与者接口规格做了如下的修订（技术开发部修订） 增加 4.6 期权会员数据报送文件，描述会员报送期权数据文件的格式 增加 4.5 期权收盘价格文件，描述期权系统闭市后的收盘价和参考结算价。2014-05-15 对市场参与者接口规格做了如下的修订（技术开发部修订） 修改期权行情文件接口中校验和字段的校验逻辑2014-04-14 对市场参与者接口规格做了如下的修订（技术开发部修订） 申报指令、证券锁定与解锁指令、行权、会员申请转处置证券账户指令、撤单指令、执行报告中增加合约账户子编码及说明 修改期权基础信息中期权合约状态信息标签的第一位含义，改为1表示限制卖出开
8、仓（不包括备兑开仓）和买入开仓2014-03-04 对市场参与者接口规格做了如下的修订（技术开发部修订） 修改行情数据中行情条目价格字段，由 N11(3)改为 N11(4) 修改申报指令中申报价格字段，由 N11(3)改为 N11(4) 修改申报指令响应/撤单指令成功响应消息中市价转限价订单的价格，由 N11(3)改为 N11(4) 修改执行报告中成交价格，由 N11(3)改为 N11(4) 修改行情文件接口中昨日结算价、今日开盘价、动态参考价格、最高价、最低价、最新价、申买价一、申买价二、申买价三、申买价四、申买价五、申卖价一、申卖价二、申卖价三、申卖价四、申卖价五、今日结算价，由 N11(
9、3)改为 N11(4) 修改期权基础信息中期权行权价、合约前收盘价、合约前结算价、标的证券前收盘、涨幅上限价格、跌幅下限价格，由 N11(3)改为 N11(4) 修改成交过户数据接口中成交价格，由 N11(3)改为 N11(4) 新增保证金查询指令与保证金查询响应消息 成交过户数据接口中，新增币种、交易经手费字段 期权基础信息接口中，新增最小报价单位字段 T0306 冲销数据（成交过户数据接口）中，删除营业部代码、会员内部订单编号、订单编号、申报时间、成交价格、成交金额、开平标志字段2014-02-13 对市场参与者接口规格做了如下的修订（技术开发部修订） 修改成交过户数据接口中成交编号字段，
10、由 N16 改为 C16 修改期权基础信息文件中保证金比例一、保证金比例二，由 N3 改为 N6(2) 期权成交过户数据接口中执行类型字段，增加（E=-冲销）取值 增加期权持仓余额对账文件 修改 8541 域字段名，由 TransacTime 改为 TransacTimeOnly2013-12-06 对市场参与者接口规格做了如下的修订（技术开发部修订） 修改数据格式约定中，请求业务类型编号描述 删除标的撤单指令，合并到撤单指令中 删除标的证券清单文件 行情接口中，增加收盘价的描述2013-12-05 对市场参与者接口规格做了如下的修订（技术开发部修订） 期权基础信息接口文件，新增行权交割日字段
11、 期权行情接口，更新虚拟匹配数量与虚拟未匹配数量的字段描述2013-12-04 期权组内评审，修改如下 修改第 3.9 章节标签 453 的说明，增加转处置指令的描述 修改第 3.8 章节标签 48 的说明，增加营业部代码的描述2013-12-03 期权组内评审，修改如下 营业部代码统一命名为 branchId 记录长度更新为实际长度 非交易指令添加营业部代码2013-11-26 对市场参与者接口规格做了如下的修订（技术开发部修订） 调整备兑标志，1 表示备兑，空格表示非备兑。 新增非交易指令-会员申请转处置证券账户指令。 新增标的证券清单文件 成交过户中新增营业部代码字段 行情文件接口和行情
12、数据中，更新为 5 档行情 版本改为 1.05 版2013-11-13 对市场参与者接口规格做了如下的修订（技术开发部修订） 期权合约的产品代码，中文名改为合约编码。 行情接口中增加新字段“未平仓合约数”。 期权行情文件接口，“产品实时阶段及标志”字段第 1 位增加“P 表示临时停牌”；第 2 位修改为：0表示未连续停牌，1表示连续停牌。 行情接口中，期权交易状态字段第 1 位，去掉 A表示日中集合竞价。 备兑标志由 C3 改为 C1。 非交易申报指令响应，去掉市价转限价说明部分。 非交易申报指令响应，增加冻结/解冻现货的数量字段(预留字段)。 期权行情文件接口， 行情数据类型 MD301 改
13、为 M0301. 成交过户数据接口，交易事务类型 TD305 改为 T0305. 期权基础信息， 参考数据类型 RF301 改为 R0301； 期权基础信息， ContractID 中文名称“期权合约代码”改为“合约交易代码”。 成交过户数据接口， 删除“此文件每天都发送，哪怕记录数为 0”。 期权基础信息， “ref03”改为“reff03” 。 期权行情文件接口， 删除“期权合约更新次数”。 文件接口规范中,文件头字段 ,文件体记录数字段由 N5 改为 N12，数据长度字段由N10 改为 N12。 期权基础信息文件接口，去掉第一行特殊记录与最后一行特殊记录。 成交过户数据文件接口，去掉第一
14、行特殊记录与最后一行特殊记录。期权基础信息文件接口中，昨日收盘价 字段，去掉如遇除权除息则为调整后的结算价（合约上市首日填写参考价）说明部分。 期权基础信息文件接口中，昨日结算价 字段，新增如遇除权除息则为调整后的结算价（合约上市首日填写参考价）说明部分。 期权基础信息文件接口中，涨跌幅限制类型 字段，去掉 R 表示交易规则 3.4.15和 3.4.16 规定的无涨跌幅限制类型 期权基础信息文件接口中，期权合约状态信息标签 字段第 2 位，调整为0表示未连续停牌或未暂停，1 表示连续停牌或暂停。2013-09-30 根据所内技术开发部评审意见，进行如下的修订 (技术开发部修订) 更新文档到 1
15、.03 版本 删除“非交易指令-实物交割意向” 更新“证券冻结与解冻指令”为“证券锁定与解锁指令” 修改期权基础信息中的字段，删除“交易会员持仓限制”和“保证金比例”字段；补充新字段“保证金计算比例参数一”，“保证金计算比例参数二” 对于期权基础信息中的“期权合约状态信息标签”字段，第一位开仓控制字段，更新了描述“卖开禁止，买开不禁止”。 删除单边持仓逻辑下的头寸冲销数量，更新了申报指令响应、执行报告和成交过户数据接口。 删除申报指令中对于“备兑优先”功能的选项。2013-09-15 根据所内技术开发部评审意见，进行如下的修订 (技术开发部修订) 删除 799888 取值及含义说明 修改行文描
16、述，“TD0302”改为“TD302”；“现行权”改为“行权” 修改非交易申报指令相应中，关于标签 151 的描述，改为“非交易申报的数量” 修改 SenderCompID 的取值，改为 “XSHG03” 其他样式优化,删除封面中的多余字符 “(”2013-09-13 根据所内技术规划部反馈意见，进行 如下的修订（技术开发部修订） 期权合约的产品代码，英文名改为 SecurityID，类型改为 C8。原有标的证券名SecurityID，改为 UnderlyingSecurityID，标签由 48 改为 308 产品价格为由 N10 改为 N11(3)，带 3 位小数，精确到厘 单笔合约、成交金
17、额由 N16 改为 N16(2)，带 2 位小数，精确到分 Transactime 域标签由 60 改为 85412013-09-05 根据所内及其他接口规格讨论意见，进行 如下的修订（技术开发部修订） 新增独立的产品代码标识，N8 统一字段格式，价格为 N10，不带小数点，单位：厘 保证金、成交金额为 N16，不带小数点，单位：分 统一行情格式中关于“动态参考价格”的描述 期权行情文件中补充“今日结算价” 期权行情文件中补充了对于集合竞价状态下，产品虚拟成交价、虚拟匹配和买/卖方未匹配量的说明 新增非交易申报的响应结构2013-08-29 对市场参与者接口规格做了如下的修订（技术开发部修订）
18、 STEP 消息规范 -行情数据中，开盘（上次）集合竞价价格修订为动态参考价格 去除 T 日（ T+1 日）相关的定义 去除期权合约代码的解释性文字 结算会员持仓限额修订为交易会员持仓限额 执行报告中去除备兑优先相关的描述 格式统一2013-08-26 对市场参与者接口规格做了如下的修订（技术开发部修订） 新增实物交割意向申报，OTP STEP 消息处理原则章节，补充了格式约定 行情数据、行情文件接口中更新了状态字段，取值位的标识说明 申报指令，补充了交易时段与订单类型的说明、增加了申报来源的取值类型、增加了“最小成交数量”字段、移除了结算会员代码 行权指令、实物交割意向、执行报告、成交过户数
19、据、四个接口中移除结算会员代码，更新申报来源取值 格式调整：字体和引用说明，拼写和语法修正2013-08-16 根据个股期权业务方案更新稿，调整并修订市场参与者接口规格（技术开发部修订）2013-07-15 根据个股期权业务方案对市场参与部分做更新 （技术开发部修订）2012-06-06 对市价转限价订单在没有任何对手盘可供成交之际的申报应答作出补充说明本文档为市场参与者与本所通过 STEP 消息和文件交互等方式进行期权交易的接口规格。本文档由上海证券交易所起草，并负责进行解释。服务电话：4009003600通信地址：上海市浦东南路 528 号上海证券交易所目录1 数据格式约定 .102 期权
20、交易系统接口规范 .112.1 .STEP 消息处理原则 .112.1.1 .消息流程图 .112.1.2 .格式约定 .122.2 .文件接口处理原则 .122.2.1 .格式约定 .122.2.2 .结构描述 .122.2.3 .标志文件 .133 STEP 消息规范 .153.1 .行情数据 .153.2 .申报指令 .183.3 .非交易指令-证券锁定与解锁指令 .203.4 .非交易指令-行权指令 .223.5 .非交易指令-会员申请转处置证券账户指令 .233.6 .撤单指令 .253.7 .申报指令响应/撤单指令成功响应消息 .273.8 .非交易申报指令响应/非交易撤单指令成功
21、响应消息 .293.9 .撤单指令失败响应消息 .313.10 .执行报告 .323.11 .保证金查询指令 .353.12 .保证金查询响应报告 .364 文件接口规范 .384.1 .期权行情文件接口 mktdt03.txt .384.2 .期权基础信息 reff03MMDD.txt.434.3 .成交过户数据接口 trns03XXXXX.txt .464.4 .期权持仓余额对账文件（hold03xxxxx.txt ） .504.5 .期权收盘价格文件（clpr03MMDD.txt） .514.6 .期权市场参与者数据报送文件（cybsXXXXXYYYYMMDD001.txt） .52技术
22、文档期权交易平台 市场参与者接口规格说明书 第 10 页 共 56 页1 数据格式约定数据格式约定参见上海证券交易所市场参与者 EzSTEP 通用数据库接口规格说明书文档。其中，数据库接口中：请求业务类型编号（reqid），本业务取值： OTO = 申报指令-期权订单（ Option Trading Order Entry） OTU = 非交易指令-证券锁定与解锁（Option Trading UnderlyingFreeze） OTE = 非交易指令 -行权指令/撤销行权（Option Trading Execution ） OTT = 非交易指令 -会员申请转处置证券账户（Option T
23、rading Transfer for Execution） OMR=保证金查询指令 (Option Margin Requirement）数据广播类型（bcasttype）， 本业务取值：7C 期权交易执行报告7H 期权交易行情数据消息类型（MsgType ），本业务取值：8 =申报响应或执行报告（Execution Report）9 =申报撤消失败（OrderCancelReject）D =申报（NewOrder Single）F =申报撤单（OrderCancel Request）W=行情数据（MarketData ）CH = 保证金查询指令（ Margin Requirement Inquiry）CJ = 保证金查询响应消息（MarginRequirementReport）
