上海期货交易所数据接口规范
申报数量
Num 6,0
第7页共9页
上海期货交易所数据接口规范
7 clientid 8 userid 9 orderid
10 offset
11 specu
12 ordstatus
13 tradeid 14 tradepx 15 tradeqty 16 exedate 17 exetime 18 comment
3. 报盘程序接收到交易所系统的新建委托单确认,如果交易所系统接受该委托 单,则设置 status 为‘s’。如果交易系统拒绝该委托单,则设置 status 为“r”。 或
报盘程序接收到交易系统的撤销委托单确认,如果交易所系统撤销成功,则设
置 status 为‘s’。如果交易系统撤销失败,则设置 status 为“r”。 4. 新建委托单确认和撤销委托单确认同时也在回报库中有对应的处理记录。 z 处理状态结构图
中有效委托单的成交回报之外,还包括证券公司以其它方式的所有报单和撤单请求确认,以
及这些有效委托单的成交回报。如,证券公司通过交易所场内席位的报单和撤单请求确认,
以及场内席位有效委托单的成交回报,都包含在回报库中。
回报库定义:
序号 字段名
字段描述
类型 长度
备注
0 stmsn
记录序号
Char
8 从 100 开始,逐一连续递增(1)
行情库(mktdat.dbf)描述由上海期货交易所发布的,目前合约成交情况的实时信息。 委托库(orders.dbf)描述券商系统提交的新建委托单(下单或报单)和撤销委托单(撤 单)操作请求,以及交易所系统(或报盘程序)处理结果。 回报库(exerpt.dbf)描述交易所系统处理证券公司提交的所有新建委托单和撤销委托 单之后,返回给券商系统的详细信息,以及证券公司所有委托单成交回报信息。 合约信息库(prdinf.dbf)描述上海期货交易所当前正在进行交易的品种合约信息。
1
8,2 6,0 8 15 8
1
1
1 6 8 8 8 8 8 8 20
填写修改(1)
备注
SC-nc
(2)
SC-nc
‘n’-新建委托单
‘c’-撤销委托单
SC-n
SC-n
‘b’-买 ‘s’-卖
SC-n
SC-n
SC-n
FE-nc
SC/FE-nc (3)
‘0’-开仓
SC-n
‘1’-平历史仓
‘2’-平今日新开仓
‘s’ 交易所系统成功接受新建委托单请求 交易所系统撤销委托单成功
‘r’ 操作请求被交易所系统拒绝。
状态代码‘t’、‘e’、‘s’、‘r’只能由报盘程序使用。券商系统不能使用这些代码。 当 status 为‘e’和‘r’时,comment 字段(见解释 5)描述错误原因或拒绝原因。 z 状态转换流程
z 券商系统只能对委托库记录添加和修改,而报盘程序只能对其修改。 z SC 表示该字段由券商系统填写或修改,FE 表示该字段由交易所系统填写或修改 z n 表示该字段在新建委托单操作时需要填写或修改,c 表示该字段在撤销委托单操
作时需要填写或修改。 (2)sn(记录序号)
z 从 0 开始,连续递增且唯一。 z 对于新建委托单操作:既代表记录序号,又代表本地委托单编号 z 对于撤销委托单操作:仅仅为记录序号 (3)orderid(委托单系统序号) z 对新建委托单,该字段由券商系统填为空。当交易系统接受新建委托单时,分配一
第4页共9页
上海期货交易所数据接口规范
2.2. 委托库(orders.dbf)
委托库包括两种操作记录:新建委托单,撤销委托单。
委托库定义:
序号 字段名
字段描述
0 sn
记录序号
1 type
操作类型
2 contract 品种合约名称
3 side
卖买方向
4 orderpx 申报价格
5 orderqty 申报数量
17 upddate 最后修改日期
18 updtime 最后修改时间
19 comment 处理返回信息
类型 Char
char
Char
Char
Num Num Char Char Char
Char
Char
Char Char Char Char Char Char Char Char Char
长度 8
1
6
10,0 10,0 8,2 6,0 13,0 8,2 8,2 8,2 8,2 8,2 8,2
1 8 8
备注
(1) (2) (2) (3) (1) (1)
(4) (4)
(5) 格式:ccyymmdd 格式:hhmmssuu
行情库定义解释: (1)双向成交量(额)
是指买卖双向成交量(额)的和。 (2)双向持仓
回报库添加记录序号、交易员字段和委托单状
态的解释。
2005-8-22
增加库说明,修改个别字段和解释
2005-8-24
日期
第2页共9页
上海期货交易所数据接口规范
1. 概述
上海期货交易所的期货交易数据交换接口是基于消息流的,具有故障监测和故障恢复能 力。证券公司系统的数据接口是基于数据库(DBF 文件)的。因此,证券公司系统和上海 期货交易所不能够直接通讯,需要一个转换接口的机制,以解释双方的接口模式。上海期货 交易所的报盘程序(offer)负责转换双方的数据通讯接口。
目标读者
上海期货交易所技术人员、证券公司技术人员和证券期货软件开发商
参考
上海期货交易所交易系统接口说明
版本
版本 0.1 0.2 0.3 0.4
0.5 0.6
描述
行情库、委托库、回报库
2005-8-13
修改委托表部分字段
2005-8-15
委托库增加“处理状态”
2005-8-16
添加合约信息库。 调整委托表部分字段,并详细说明“处理状态” 2005-8-17
6 clientid 客户编号
7 userid
交易员编号
8 orderid 委托单系统号
9 offset
开仓平仓
10 specu
投机保值
11 status
处理状态
12 memberid 会员编号
13 wrdate 写入表日期
14 wrtime 写入表时间
15 cfmdate 主机确认日期
16 cfmtime 主机确认时间
类型 Char Num Num Num Num Num Num Num Num Num Num Num Num Num Num Num Num Num Num Num Num Num Num Char Char Char
长度 6 8,2 8,2 8,2 8,2 8,2 6,0 8,2 6,0 8,2 8,2 8,0
SC-n
‘0’-保值 ‘1’-投机
SC/FE-nc (4)
SC-nc
SC-nc
格式:ccyymmdd
SC-nc
格式:hhmmssuu
FE-nc
格式:ccyymmdd
FE-nc
格式:hhmmssuu
SC/FE-nc 格式:ccyymmdd
SC/FE-nc 格式:hhmmssuu
FE-nc
(5)
委托库定义解释: (1)记录的填写和修改
本规范是定义证券公司系统和上海期货交易所报盘程序之间的数据交换接口,基于数据 库(DBF 文件)模式。
证券公司(柜台)系统以下简称券商系统。 上海期货交易所交易系统以下简称交易所系统。 上海期货交易所报盘程序以下简称报盘程序。
2. 交易数据接口规范
本节描述券商系统和报盘程序之间交易数据接口数据库。接口数据库包括:行情库 (mktdat.dbf)、委托库(orders.dbf)、回报库(exerpt.dbf)和合约信息库(prdinf.dbf)。
是指多空双方的持仓和。 (3)avgpx(实时均价)
是指从日初开始总成交的均价。 (4)hishighpx 和 hislowpx(历史最高(低)价)
是指从该合约挂牌以来的最高(低)成交价。 (5)tradable(合约交易状态)
是指合约当前是否处于可以交易状态。可交易状态为:‘y’;不可交易状态为:‘n’。
z 对于委托库中新建委托单操作的确认,该字段内容为委托库中对应操作的记录序号 (即委托单的本地序号)。
z 对于委托库中撤销委托单操作的确认,该字段内容为该委托单在委托库中对应新建 委托单操作的记录序号(即委托单的本地序号),而不为对应撤销委托单操作的记
‘o’-有效委托单 1 ‘t’-委托单撤销
‘f’-委托单有成交 (4) 8 只对成交回报有效 8,2 只对成交回报有效(5) 6,0 只对成交回报有效(5) 8 格式:ccyymmdd 8 格式:hhmmssuu 20 (6)
回报库定义解释:
(1)stmsn(回报记录的序号),对应于交易所的私有流序号。 (2)localsn(委托单本地序号)
第3页共9页
上海期货交易所数据接口规范
2.1. 行情库(mktdat.dbf)
行情库定义: 序号 字段名
0 contract 1 psettlpx 2 pclosepx 3 openpx 4 lastpx 5 bidpx 6 bidqty 7 askpx 8 askqty 9 highpx 10 lowpx 11 qty 12 initpos 13 position 14 avgpx 15 lastqty 16 turnover 17 closepx 18 settlpx 19 hishighpx 20 hislowpx 21 upperpx 22 lowerpx 23 tradable 24 date 25 time
当 status 为‘e’时,该字段为报盘程序的错误原因解释。 当 status 为‘r’或‘s’时,该字段为交易所系统返回的信息。此时其含义和回报库中的 comment 字段意义相同。