1TraderAPI接口分类-上海期货交易所.DOC

NGES交易系统 交易API和行情API接口规范 Version：1.22 发布日期： 2012年9月10日 修订记录、核准记录和审核记录 修订记录 版本编号 修订日期 主要修订摘要 1.22-R002 2012/9/10 技术公司： TraderAPI增加了汇率查询功能：ReqQryExchangeRate、 OnRspQryExchangeRate； 合约结构增加了币种字段：CurrencyID； TraderAPI开放了信息查询功能： ReqQryInformation、 OnRspQryInformation。 1.22-R001 2011/6/16 技术公司：TraderAPI增加ReqQryExecOrder、OnRspQryExecOrder方法；MduserAPI增加OnRtnFlowMessageCancel方法；给部分结构增加了ActionDay字段；给部分结构增加了BusinessLocalID字段；给执行宣告增加了OffsetFlag字段。 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交易系统接口介绍 1 1. 介绍 2 1.1. 背景 2 1.2. TraderAPI简介 3 1.3. MduserAPI简介 3 1.4. TraderAPI/MduserAPI发行的平台 4 1.5. 修改历史 4 1.5.1. 版本1.20 4 1.5.2. 版本1.22 5 2. FTD体系结构 7 2.1. 通讯模式 8 2.2. 数据流 9 3. 接口模式 12 3.1. TraderAPI接口 12 3.1.1. 对话流和查询流编程接口 12 3.1.2. 私有流编程接口 13 3.1.3. 公共流编程接口 13 3.2. MduserAPI接口 13 3.2.1. 对话流编程接口 14 3.2.2. 行情流编程接口 15 4. 运行模式 16 4.1. 工作流程 16 4.1.1. 初始化阶段 16 4.1.2. 功能调用阶段 16 4.2. 工作线程 17 4.3. 会员系统使用TraderAPI与交易系统的交互 18 4.4. 与交易所前置系统的连接 20 4.5. 本地文件 21 4.6. 请求/应答日志文件 21 4.7. 可靠数据流的订阅方式 21 4.7.1. API维护重传报文的序号 22 4.7.2. 会员系统维护重传报文的序号 23 4.8. 心跳机制（Heartbeat） 24 4.9. 前置机列表 25 4.10. 灾备接口 27 第二部分、TraderAPI参考手册 29 1. TraderAPI接口分类 30 1.1. 管理接口 30 1.2. 业务接口 30 1.3. 当前版本不开放的业务 33 2. TraderAPI参考手册 34 2.1. CShfeFtdcTraderSpi接口 34 2.1.1. OnFrontConnected 方法 34 2.1.2. OnFrontDisconnected 方法 34 2.1.3. OnHeartBeatWarning方法 35 2.1.4. OnPackageStart方法 35 2.1.5. OnPackageEnd方法 35 2.1.6. OnRspUserLogin方法 36 2.1.7. OnRspUserLogout 方法 37 2.1.8. OnRspUserPasswordUpdate 方法 38 2.1.9. OnRspSubscribeTopic方法 39 2.1.1