[计算机软件及应用]NGES交易系统交易API和行情API接口规范.doc

NGES交易系统交易API和行情API接口规范 Version：1.20 发布日期： 2009年6月20日 修订记录、核准记录和审核记录 修订记录 版本编号 修订日期 主要修订摘要 1.20-R002 2009/5/4 技术中心和技术公司：根据会员接入规范和流程测试结果修改文档。 1.20-R001 2008/12/4 技术公司：增加灾备接口；增加主题查询接口说明。 1.12-R003 2008/01/28 技术公司：增加RESTART、RESUME和QUICK三种数据流恢复模式。 1.12-R002 2007/12/17 技术部：合并TraderAPI和MduserAPI文档，调整部分章节内容。 1.12-R001 2007/12/11 技术公司：增加了错误代码处理；增加了私有流序列号设置功能；增加了前置机NameServer内容，但暂时不开放。 1.08-R001 2007/8/31 上海期货交易所技术部：根据NGES V1.08交易系统修改部分接口；提高压缩效率；增加交易员私有流。 1.00 2006/8/11 上海期货信息技术有限公司制定初稿。 核准记录 核准人员 属于部门（单位） 核准日期 严少辉 技术中心 2009/6/20 审核记录 审核人员 属于部门（单位） 审核日期 邹文军 技术中心 2009/5/20 文件制作和维护：上海期货交易所技术部；上海期货信息技术有限公司。 目 录 第一部分、NGES交易系统接口介绍 4 1. 介绍 4 1.1. 背景 4 1.2. TraderAPI简介 4 1.3. MduserAPI简介 4 1.4. TraderAPI/MduserAPI发行的平台 4 1.5. 修改历史 4 1.5.1. 版本1.20 4 2. FTD体系结构 4 2.1. 通讯模式 4 2.2. 数据流 4 3. 接口模式 4 3.1. TraderAPI接口 4 3.1.1. 对话流和查询流编程接口 4 3.1.2. 私有流编程接口 4 3.1.3. 公共流编程接口 4 3.2. MduserAPI接口 4 3.2.1. 对话流编程接口 4 3.2.2. 行情流编程接口 4 4. 运行模式 4 4.1. 工作流程 4 4.1.1. 初始化阶段 4 4.1.2. 功能调用阶段 4 4.2. 工作线程 4 4.3. 会员系统使用TraderAPI与交易系统的交互 4 4.4. 与交易所前置系统的连接 4 4.5. 本地文件 4 4.6. 请求/应答日志文件 4 4.7. 可靠数据流的订阅方式 4 4.7.1. API维护重传报文的序号 4 4.7.2. 会员系统维护重传报文的序号 4 4.8. 心跳机制（Heartbeat） 4 4.9. 前置机列表 4 4.10. 灾备接口 4 第二部分、TraderAPI参考手册 4 1. TraderAPI接口分类 4 1.1. 管理接口 4 1.2. 业务接口 4 1.3. 当前版本不开放的业务 4 2. TraderAPI参考手册 4 2.1. CShfeFtdcTraderSpi接口 4 2.1.1. OnFrontConnected 方法 4 2.1.2. OnFrontDisconnected 方法 4 2.1.3. OnHeartBeatWarning方法 4 2.1.4. OnPackageStart方法 4 2.1.5. OnPackageEnd方法 4 2.1.6. OnRspUserLogin方法 4 2.1.7. OnRspUserLogout 方法 4 2.1.8. OnRspUserPasswordUpdate 方法 4 2.1.9. OnRspSubscribeTopic方法 4 2.1.10. OnRspQryTopic方法 4 2.1.11. OnRspError 方法 4 2.1.12. OnRspOrderInsert 方法 4 2.1.13. OnRspOrderAction 方法 4 2.1.14. OnRspQuoteInsert 方法 4 2.1.15. OnRspQuoteAction 方法 4 2.1.16. OnRspExecOrderInsert 方法 4 2.1.17. OnRspExecOrderAction 方法 4 2.1.18. OnRspQryPartAccount 方法 4 2.1.19. OnRspQryOrder 方法 4 2.1.20. OnRspQryQuote 方法 4 2.1.21. OnRspQryTrade 方法 4 2.1.22. OnRspQryClient 方法 4 2.1.23. OnRspQryPartPosition 方