中国金融期货交易所筹备组
技术组
中国金融期货交易所 交易/行情 API 发布说明书
文件状态: [√] 草稿 [ ] 正式发布 [ ] 正在修改
文件标识: 当前版本: 作 者: 完成日期: V0.1 周军 2006-7-7
中国金融期货交易所筹备组
技术组
版本记录:
修改记 录编号 1 修改 状态 修改页码及条款 修改人 张国元 审核人 批准人 修改 日期 7.8
中国金融期货交易所筹备组
技术组
目录
1 2 概述...........................................................................................................................................1 文档和代码说明.......................................................................................................................1 2.1 NGES业务模型简介 ....................................................................................................1 2.2 TraderAPI接口..............................................................................................................2 2.3 MdUserAPI接口 ...........................................................................................................2 2.4 USERAPI压缩包 ..........................................................................................................2 系统运行平台...........................................................................................................................3 会员接入方式...........................................................................................................................3 测试接口...................................................................................................................................3 5.1 测试端口参数:.........................................................................错误!未定义书签. 5.2 测试基本数据分配:.................................................................错误!未定义书签. 5.3 测试系统开放时段:.................................................................错误!未定义书签. API问题的联系人 ....................................................................................................................3 中金所联系人.........................................................................................错误!未定义书签.
3 4 5
6 7
中金所目前提供的参与者技术服务网站为 www.sfit.com.cn/cffex
1
中国金融期货交易所筹备组
技术组
1 概述
本文档通过对发布的 NGES 客户端 API 中包含的文档,代码内容的综述, 简要介绍了 NGES 的业务模型及其基本概念,交易接口提供的功能,行情接口 提供的功能和 API 压缩包的内容; 此外本文档还说明了程序的版本及运行平台,会员接入交易系统的方式,测 试用交易系统的网络地址,接入端口,通信协议,以及测试用的基本数据等.
2 文档和代码说明
API 文档和代码由以下几部分组成:
文档 NGES_业务模型简介.doc NGES_TraderApi 接口.doc NGES_MarketDataUserAPI 接 口.doc NGES_UserAPI_LibWin32_V1.0.rar 描述 NGES 交易系统主要业务功能及业务模型简介 NGES 交易 API 接口文档 NGES 行情 API 接口文档 Windows 平台下 API 程序库
2.1 NGES 业务模型简介
文档名称:NGES_业务模型简介 版本:V0.91(草稿) 适应对象:交易系统客户端开发人员,维护人员等 该文档的目标是方便客户端开发人员更容易更准确地理解 UserAPI 提供的 内容,提高开发效率.主要描述了 NGES 的业务模型的基本概念,包括产品的 的构成图及一些重要概念(交易所,结算组,产品组,产品及合约),交易涉及 到的委托(委托类型,委托条件及委托操作),报单撮合原则,优先成交规则, 市价单行情,组合报单等内容,以及行情服务所提供的内容.另外还附录了 UserAPI 工作时序图.更多细节描述参见该文档.
中金所目前提供的参与者技术服务网站为 www.sfit.com.cn/cffex
1
中国金融期货交易所筹备组
技术组
2.2 TraderAPI 接口
文档名称:NGES 交易员应用程序接口 版本:V0.90(草稿) 适应对象:交易系统客户端开发人员,维护人员等 该文档描述了 TraderAPI 提供的用户完成交易所需的全部功能, 包括交易系 统连接与断开,用户登录与退出,用户密码修改,报单与报价的录入,报单与报 价的撤销,报单与报价的挂起,报单与报价的激活,报单与报价的修改,报单与 报价的查询,成交单查询,会员客户查询,会员持仓查询,客户持仓查询,合约 查询,合约交易状态查询,保值额度查询,普通行情查询,交易所公告查询,合 约价位查询,成交回报,报单回报,执行宣告回报,报价回报,合约交易状态通 知,增加与删除合约通知,增加与删除合约单腿通知,合约别名定义通知,公告 通知,普通行情通知,错误应答,报单错误回报,报价错误回报以及执行宣告错 误回报等.更多细节描述参见该文档.
2.3 MdUserAPI 接口
文档名称:NGES 行情客户端应用程序接口 版本:V0.91(草稿) 适应对象:交易系统客户端开发人员,维护人员等 该文档描述了 MdUserAPI 提供的用户获取深度行情数据所需的全部功能, 包括交易系统连接与断开,用户登录与退出,行情主题订阅,深度行情通知,错 误应答等.更多细节描述参见该文档.
2.4 USERAPI 压缩包
文档名称:NGES 客户端接口包 版本:V0.91 适应对象:交易系统客户端开发人员,维护人员等 压缩包中包括以下文件:
中金所目前提供的参与者技术服务网站为 www.sfit.com.cn/cffex
2
中国金融期货交易所筹备组
技术组
FtdcMduserApi.h:深度行情接口 FtdcTraderApi.h:交易接口 FtdcUserApiDataType.h:定义了 UserAPI 所需的一系列数据类型 FtdcUserApiStruct.h:定义了一系列业务相关的数据结构 mduserapi.dll mduserapi.lib traderapi.dll traderapi.lib
3 系统运行平台
本次发布只包括 Windows32 位版,适应 Windows XP,Windows2000 及以 上版本操作系统. 解压 USERAPI 压缩包后即可安装使用此版本, 要求计算机上安装了 Winrar 等解压软件. 预期将于 2006 年 8 月发布 Linux 版.
4 会员接入方式
参见《中国金融交易所参与者接入指南》
5 测试接口
为方便会员端开发,中国金融期货交易所委托上海期货信息技术公司在互联 网上开放交易所端测试端口,供会员端调试. 中金所目前提供的参与者技术服务网站为 www.sfit.com.cn/cffex
6 API 问题的联系人
联系人:周军 电话:(+8621)68401135 手机:(+86)13636529990 msn:zhoujun117@hotmail.com e-mail:zhou.j@sfit.com.cn
中金所目前提供的参与者技术服务网站为 www.sfit.com.cn/cffex 3