PDF《郑州商品交易所》

完善部分 描述,更便于 用户理解 1.1.1.9 2014-10-10 1)登录协议版本号目前只支持

2 和11, 不再支 持1. 2)删除日志备份文件 ftdapi.log.bak.日志文件 中的时间由原来的秒精确到微秒,日志文件中 加入版本号信息.日志内容改为英文. 3)API 回调信息改为全为英文. 4)新增得到API 版本号接口ftd_api_getVersion. 5)新增发起与交易所连接时的域名解析服务 函数 API_ConnectEx. 6)增加 API 初始化函数 ftd_api_init 必须最先调 用的限制. 7)增加业务字段赋值时的类型判断,重新定义 赋值函数返回值. 8)修改日期时间的类型定义,名称改为API_DateTime,微秒类型改为 int 型. 9)修改 API_Now 函数,把微秒由原来的

0 改 为实际值. 10)用string 格式取 double 值,根据存的精度 输出. 11)修改 API_GFString 和API_CFString 函数取 时间型数据域时微秒值为

6 位输出. 12)修改 API_Send 函数不能发送登录、登出数 据包. 13)完善了连接,登录,未知数据,线程启动 为了适用新版 本改动 郑州商品交易所 ZCEAPI 使用手册

2 API 版本 修改时间 修改内容 说明 和退出等的日志输出. 1.1.0.1 2007-12-19 1)登录协议版本号,不再是默认 1,必须填写 合适的值. 2)增加登录协议版本号

2 和11. 登录协议版本号=2 广播流使用 TCP 登录协议版本号=11 广播流使用 UDP 为了适用新版 本改动 郑州商品交易所 ZCEAPI 使用手册

3 1. 概述 1.1 目的及说明 本文档是郑州商品交易所远程交易 API(应用程序接口)的使用说明,本文档的目标读 者为使用郑州商品交易所发布的 API 与交易所交易系统实现通信的交易软件开发者.文档 对采用郑商所 API 的开发者具有指导意义,所有使用 API 的开发者都应该认真阅读该文档. 文档描述内容如果与实际情况不符,请及时和郑州商品交易所联系并确认. 文档的最终解释权归郑州商品交易所. 1.2 相关文档 《郑州商品交易所 ZCEAPI 参考手册》(下简称《ZCEAPI 参考手册》),该文档随同 本文档一同由郑州商品交易所发布. ZCEAPI 示例程序展示了 ZCEAPI 多线程模式下的使用, 具体情况请参考示例程序中的 相应说明,示例程序随本文档一同由郑州商品交易所发布. 1.3 ZCEAPI 简介 ZCEAPI 是郑州商品交易所的远程交易编程接口, 是客户应用程序与郑州商品交易所交 易系统连接通信的接口. 它为程序员提供了一套应用程序接口和一套简单的交易数据报文协 议. ZCEAPI 采用面向对象的思想对 FTD 协议进行了封装.用户在使用 ZCEAPI 向交易所发 送数据时只需要参照《ZCEAPI 参考手册》为分配好的 ZCEAPI 数据包填写相应的值,再调 用相应的 ZCEAPI 接口函数发送 ZCEAPI 数据包. 心跳机制由 ZCEAPI 自行维护. 数据加密、 解密, 压缩、 解压等工作由 ZCEAPI 内部完成, 只需用户选择相应的参数. ZCEAPI 使用回调机制,当链路有错误发生、打开链路、链路断开、收到登录应答包、 收到退出应答包、接收到普通数据包等事件发生时,ZCEAPI 自动回调用户设置的回调函数 进行处理. 总之, 使用 ZCEAPI 可以很方便的与郑州商品交易所交易系统实现通信, 完成事务操作. 1.4 ZCEAPI 所处位置 ZCEAPI 是在应用程序端,为交易软件开发人员使用,并作为应用程序的一部分而 郑州商品交易所 ZCEAPI 使用手册

4 在交易系统的客户端存在(如下图所示): 1.5 ZCEAPI 通信简介 ZCEAPI 采用 TCP 可靠连接与交易系统进行通讯,通讯方式采用对话通讯模式、私有 通讯模式和广播通讯模式.用户程序通过 ZCEAPI 建立可靠的 TCP 链路连接郑州商品交易 所的交易系统,完成交易业务和获取行情信息. 对话模式(对应的数据流为对话流),实现了所有的事务操作和查询操作功能,可以完 成 交易系统 与 会员系统 之间数据交换的全部功能. 私有模式(对应的数据流为私有流),是对话模式的补充功能,是可靠的数据连接.主 要功能包括: 1) 交易系统定单薄中每一条记录的状态或数量发生变化, 交易系统通过私有流发送报 单状态确认报文或跨期套利确认、套期保值确认、期权执行确认、报价响应确认报文. 2) 交易系统成交记录发生变化时,交易系统通过私有流发送单边成交回报报文. 广播模式(对应的数据流是广播流),是对话模式的补充功能,交易系统将系统状态、 合约信息、 交易所公告信息和市场行情信息等公共信息在其发生变化的时刻通过广播流发送 给会员系统,减少会员系统查询交易系统的次数,提高信息反馈速度. 当用户登录广播流采用