上海期货交易所交易系统接口

上海期货交易所交易系统接口（客户端）说明一、概述除了交易行情是通过UDPPC交易前置机的信息交换以PC端的TCP连接，通过各连接链路接收每个PCPC连接端口号分别是7150，7151，7152，7153。通讯的最小单元称为包，每个包大小限制在834096字节之间。通信包结构：包头（55字节）+命令字和处理状态（28字节）+正文信息/回送信息（0/4013字节）1.1 数据包头结构PC端发送的命令、交易系统返回的处理结果都包含一个开始的数据包头，大小固定为55个字节。里面包括交易系统用户名以及后续数据的长短。struct{charhead;//开始标志，固定为0x01charsadd[16];//PC0x20，交易系统返回信息时填PC登录用户名charsuse[6];//发送端用户名的前6个字节，可不用charradd[16];//PC端发送时填本地用户名charruse[6];//可不用charstart;//信息开始符charvary[2];//命令类型，二进制charstat;//信息状态„„/‟1‟:第一次发送,其他：非第一次charline;//信息行号 ‘0’结,‘1’有后续行charleng[5];//信息正文长度+28charcomm[8];//命令字char};echo[20];//处理状态head0x01。 sadASCII空格‟0Terminated)。suse：客户端发送时添ASCII空格‟„。可不用。radd0(NullTerminated)。ruse6位。可不用。start0x02。 vary易系统处理之后，返回的vary[0]0x01，vary[1]不变。statASCII值„„/‟1‟代表第一个数据包；其他数值代表后续包。对于PC机或其他客户端，请求的一条命令不4013„„/‟1‟可能超过一个包的最大长度，必须分成不同的连续包进行传送。line：信息状态处理回送结果的最后一个数据包，主要在客户端ASCII字符‟1‟代表是处理结果的非结束数据包，后面还有（line字段为0的结束包ASCII字符0的最后一个数据包。leng/+28字节。 命令字。命令由左对齐的ASCII码字符组成，不足8位后面补足ASCII空格。服务器返回结果时使OK 代表处理成功„代表处理失败，在echo字段给出失败原因。对于交易系统状态改变，如开盘、暂停、收盘等或告警命令，则不同的命令字，不同于OK/ERROR。28个字节的ASCII„二、交易系统与客户端接口以下为接口的各条命令客户端向交易系统发送请求命令系统处理后返回处理结果及相的数据结构。每条命令对应的命令类型在标题栏的括号内以16进制方式表示。客户端程序必须认识到只有在命令字中返”OK “时，命令表述的应答结构中的内容才有效，否则，要么不返回应答结构，要么结构中的内容不确定。用户登录命令（0x0401）客户端用户必须向交易系统登录后才能够进行其他后续处理。命令字：login。命令结构：struct{unsignedcharuserid[15];//交易员，字符型unsignedcharpasswd[40];//口令，字符型};若该交易员已经登录且其登录的IP地址与现在的IP0一致。必须想办法解决。应答命令(0x0501)，应答结构（交易系统）：struct{unsignedcharuserid[15];//交易员unsignedcharpasswd[40];//口令unsignedcharusernm[8];//交易员姓名unsignedcharlocalno0[8];//交易员用最大报单本地编号unsignedchartime[8];//交易系统时间，格式为hhmmssuuunsignedcharsysstat[8];//交易系统状态，1：系统初始化//21：系统开市//22：系统开盘//25：系统收盘，生成收盘价//26：系统收市，生成结算价//255：系统暂停//512；系统结算unsignedcharmembid[8];//所属会员unsignedcharsection[2];//当前交易节代码unsignedcharsstatus;//交易节状态，请参阅交易节状态变换图};应答结构（前置机系统）：struct{unsignedunsignedunsignedunsignedunsignedunsignedunsignedunsignedunsignedunsigned};

userid[15];passwd[40];usernm[8];date[8];time[8];sysstat[8];membid[8];section[2];sstatus;localno0[8];

//交易员//口令//交易员姓名//交易员用最大报单本地编号//交易系统时间，格式为hhmmssuu//交易系统状态，1：系统初始化//21：系统开市//22：系统开盘//25：系统收盘，生成收盘价//26：系统收市，生成结算价//255：系统暂停//512；系统结算//所属会员//当前交易节代码//交易节状态，请参阅交易节状态变换图//交易员用最大报单本地编号命令字：logout，命令结构struct{unsignedcharuserid[15];//交易员，字符型unsignedcharpasswd[40];//口令，字符型};首先检查该用户是否登录，且其IP若登录后修改过口令，此时应用修改后的口令。命令字：modpwd，命令结构struct{unsignedcharuserid[15];//交易员，字符型unsignedcharoldpwd[40];//旧口令，字符型unsignedcharpasswd[40];//新口令，字符型};应答命令(0x0320)，应答结构与命令结构一致。命令字、命令结构无。(0x0513“killlg无法继续登录和操作。命令字、命令结构无。应答命令(0x02310)，应答结构：struct{unsignedchar

content[70]; //70字节长};2. 6系统开市命令命令字、命令结构无。应答命令start(0x0502)，应答结构无。交易系统状态控制如下：初始化开市开盘/暂停收盘三、行情广播接口交易系统主动广播变化行情，而且每隔20UDP7200struct{unsignedshortstatus;//20unsignedshorttotal;//发送行情记录总数，网络序unsignedshortno;//记录总数的序号，网络序unsignedshortid;//未用unsignedcharname[7];//交易品种unsignedcharpsettle[7];//前结算unsignedcharpclose[7];//前收盘unsignedcharopen[7];//开盘价unsignedcharbid[7];//最高买价unsignedcharbvol[7];//该买价申报手数unsignedcharask[7];//最低卖价unsignedcharsvol[7];//该买价申报手数unsignedcharlast[7];//当前价unsignedcharhigh[7];//当天最高成交价unsignedcharlow[7];//当天最低成交价unsignedcharsum[7];//总成交手数（双向计算）unsignedcharunsignedcharunsignedcharunsignedcharunsignedcharunsignedcharunsignedcharunsignedcharunsignedcharunsignedcharunsignedcharunsignedcharunsignedcharunsignedcharunsignedchar};

open_interest[10];//当前持仓手数（双向计算）open_interest0[10];当天初始化时持仓手数（双向计算close[7]; //收盘价settle[7]; //结算价average[7]; //实时均价his_high[7]; //历史最高成交his_low[7]; //历史最低