用户飞马平台接入指南.docx

中国金融期货信息技术有限公司技术文档用户飞马接入指南文档属性文件属性内容文件名称用户飞马接入指南文件编号文件版本号V0.8文件状态作者李华华文档编写日期2013-4文档发布日期2013-4文档变更历史清单文件版本号修正日期修正人备注V0.52013.07.03李华华新建V0.82013.09.01李华华增加章节2.3生产环境修改变更说明序号变更内容简述1增加生产实盘环境描述目录第1章概述11.1文档说明11.2注意事项1第2章飞马环境说明22.1互联网测试环境22.1.1互联网测试环境目的22.1.2互联网测试环境说明22.1.3互联网环境配置信息22.1.4用户接入前准备32.1.5互联网测试环境申请42.2仿真测试环境52.2.1仿真测试环境目的52.2.2仿真测试环境说明52.2.3仿真环境配置信息62.2.4用户接入前准备62.2.5仿真测试环境申请72.3生产环境102.3.1用户接入前准备102.3.2生产实盘申请10第3章技术支持14版权所有中国金融期货信息技术有限公司第3页第1章 概述1.1 文档说明飞马产品由中国金融期货信息技术有限公司（以下简称：中金技术）自主研发的快速交易平台，为方便会员及客户接入飞马进行测试或正式使用，特制定用户飞马接入指南（以下简称：指南）。本指南包括几类不同的飞马环境的说明、如何办理飞马系统的接入、接入要求以及相关办理人员及申请材料等内容。1.2 注意事项1. 本指南提供的飞马互联网环境和仿真环境可能会发生变更，中金技术会尽量通过多种途径提前通知参与测试的各会员单位，请各会员以最新通知为准。中金技术建立了飞马平台技术交流群，群号：154929875，可申请加入该群以接收飞马平台最新公告信息及日常交流。2. 本指南所提供的几类飞马环境，会员单位应按照互联网环境、仿真环境、生产环境的顺次进行申请。相应的会员自身客户亦是如此，首先客户编写的客户程序应通过互联网环境的测试并提交完整的测试报告，以验证客户的程序在连通性和功能性上正确的；其次会员与客户同时在仿真环境经过一定时期正常运行，并需提交仿真环境适应性测试报告；最后申请生产实盘运行，进行飞马部署及周末生产环境测试。3. 本指南所提供的三类飞马环境所支持的飞马API版本有可能不同，请注意区分。4. 飞马API支持64位Red Hat LINUX 6.3版本，建议客户软件环境使用该LINUX版本，其他版本的操作系统请客户在测试环境进行充分的测试。第2章 飞马环境说明2.1 互联网测试环境2.1.1 互联网测试环境目的提供给客户进行飞马的连通性和功能性测试，客户通过调用飞马API进行登陆、报单、撤单、查询等功能测试。注：此环境连接的后台交易撮合系统是测试系统，与生产环境下的撮合系统具有较大差异，所以此环境下测出来的飞马性能是没有意义的。2.1.2 互联网测试环境说明1. 测试时间：7:3023:20，特殊情况除外；2. 访问方式：互联网接入访问3. 可交易合约：包括4个股指期货合约，2个国债期货合约和74个期权合约，这些合约代码固定不变，不会摘牌。4. 适用对象：本测试环境对所有人开放，但须由中金所会员单位或相关机构单位进行申请，不接受个人申请。5. 本测试环境下不包括结算功能。6. 本测试环境下不包括风控管理功能。7. 本测试环境的交易时段和中金所生产系统的交易时段不同。基本上整个白天都在运行且只有连续交易时段。8. 飞马系统每日进行一次启停操作，数据会重新恢复为初始数据，所以客户当天订单、成交等业务操作数据会丢失，此环境不保留业务数据。9. 本测试环境下的交易撮合系统交易日上固定为某一个交易日，除非有特殊需要才切换到下一个交易日。2.1.3 互联网环境配置信息主系统：接入前置名称IP地址端口号飞马交易前置496666飞马行情前置496888撮合系统交易前置497666撮合系统行情前置497888备系统：（正常情况下不启用，不需要连接）接入前置名称IP地址端口号飞马交易前置506666飞马行情前置506888撮合系统交易前置507666撮合系统行情前置5078882.1.4 用户接入前准备 会员准备l 获取账户信息和API开发包并转发给投资者使用。会员通过邮件申请接入互联网测试环境进行测试，获得飞马API开发包和测试账户。互联网测试环境账户信息由中金所技术公司统一管理和分配，会员通过邮件申请加入飞马互联网测试环境后，会收到分配的测试账户信息。包括交易用户代码（UserId）、经纪公司编码（BorkeId）、客户号（IvestorID）等登陆、报单所需信息。l 客户选择选取适合使用飞马进行交易的客户，并转发飞马API供其开发使用。 投资者准备l 投资者进行客户端程序开发会员收到飞马API开发包后，可转发给对飞马感兴趣的客户进行下单终端的开发（可参考API开发包里的Demo示例程序）。飞马目标客户是进行程序化交易的专业投资者，需要投资者自行根据合适的策略进行下单终端的开发，中金所技术公司不提供下单客户端。2.1.5 互联网测试环境申请 办理流程 联系人信息联系人姓名联系电话Email备注李华主联系人赵备联系人 申请表申请单位请填写下表，并发送给相关联系人进行申请。申请通过后，您将收到飞马的API开发包以及飞马测试账户信息，随后即可调用飞马API接入飞马互联网测试环境进行连通性和功能测试。本单位申请使用飞马互联网环境进行测试，请协助办理。会员单位名称XX公司联系人姓名联系电话联系人Email2.2 仿真测试环境2.2.1 仿真测试环境目的本测试环境主要是进行实盘交易前的适应性测试环境，除了包括客户API的测试外，还包括会员端的管理功能。1. 提供给客户进行飞马的连通性和功能性测试，客户通过调用飞马API进行登陆、报单、撤单、查询等功能测试。2. 在会员端安装客户端，提供给会员进行日常管理和风控管理功能，会员可进行飞马客户开户、资金持仓、手续费率、保证金率等数据的设置。注：此环境连接的后台交易撮合系统是大仿真撮合系统，与生产环境下的撮合系统同样存在差异，所以此环境下测出来的飞马性能也是没有意义的。2.2.2 仿真测试环境说明1. 访问时间：为中金所仿真系统下的正常交易时间，与生产撮合系统交易时段、交易时间一致。2. 访问方式：为互联网接入访问。3. 适用对象：本测试环境主要对中金所会员单位开放，且会员单位申请需要通过审核。4. 测试账户：须为相关会员单位在仿真系统下的账户信息，交易账号和行情账号一致。5. 本测试环境下不包括结算功能；6. 飞马系统每日7:30进行启动，交易撮合系统收市后于15:30关闭。7. 每日初始数据由会员单位在T-1日结算完成后进行准备，包括客户信息、资金持仓、费率等数据，T日飞马启动时装载到飞马系统，客户T日可进行登录、报单、撤单、查询等业务操作。8. 会员可通过管理端管理客户信息以及风控管理功能。9. 此环境仅保留当天的业务数据。10. 本测试环境下的交易日与仿真系统的交易日相同。2.2.3 仿真环境配置信息飞马仿真系统：接入前置名称IP地址端口号飞马交易前置56待定飞马行情前置56待定注：每家会员每套飞马系统分配的端口号不同，具体端口号信息另行邮件通知。2.2.4 用户接入前准备 会员准备相对于飞马的互联网测试环境，仿真环境后台接入中金所大仿真交易系统，需要会员单位进行以下准备：l 准备1台可接入互联网的机器：飞马为会员提供管理客户端，会员通过客户端对用户信息、费率、权限、风险控制等进行管理。l 会员需管理大仿真环境下的测试账户l 会员每日结算完成后，通过会员管理端进行用户资金和持仓的维护l 会员需指定1名技术人员负责仿真环境的测试与支持；l 会员在使用前指派至少1名人员来所进行免费培训。 投资者准备前提：投资者通过了飞马互联网测试环境下的完整测试。投资者需要注意仿真环境与互联网环境之间的差异：l 修改客户端程序参数：包括接入地址和端口；用户号（UserId）、经纪公司代码（BrokerId）和客户号（InvestorId）等账户信息；l 可交易品种：与生产实盘保持一致；l 可测试时间：9:15-15:30，最后交易日为9：15-15:00，与实盘一致。详细请参考第2.2章节仿真测试环境说明。2.2.5 仿真测试环境申请 办理流程 联系人信息联系人姓名联系电话Email备注赵主联系人刘备联系人 申请表申请单位请填写下表，并将申请表的盖章扫描件发送至赵波（）,请明确填写邮件主题：XX期货_飞马仿真环境测试申请。我方将进入申请处理流程，申核通过后，我方会安排后续相关接入事宜。单位名称单位代码请注明仿真会员代码：_请注明正式会员代码：_请注明保证金监控中心代码：_席位号请注明接入飞马的仿真席位号：_；席位密码：_；_；（可多个，请自行增减）单位地址技术联系人联系电话联系人手机传真号码联系邮箱邮政编码业务联系人联系电话联系人手机传真号码联系邮箱邮政编码备注信息：申请日期: 单位公章：技术公司审批意见： 审核人： 日期：2.3 生产环境2.3.1 用户接入前准备 会员准备l 硬件准备： 网络支持：从会员处的管理客户端机器可访问部署在托管机房的飞马BIP服务器。 客户端机器：用于部署飞马的管理客户端。 租赁托管机房机柜：用于放置投资者的下单终端机器。l 人员准备：会员应至少配置1名业务联系人和1名技术支持联系人。l 单独的席位：会员申请新的席位或者为飞马单独配置至少1个可用席位。l 其他：安排飞马相关人员参加中金技术组织的培训活动。 投资者准备l 硬件准备： 客户托管机器：投资者应配备适当的下单终端机器，应符合中金技术托管机房对于托管机器的要求。 网络支持：投资者可远程控制操作部署在托管机房的下单终端机器。l 完成仿真环境适应性测试报告，详细模板见附件。l 参与周末生产测试演练并通过验证。2.3.2 生产实盘申请 申请条件申请接入飞马的会员需满足飞马接入的技术要求，主要包括：l 投资者通过飞马仿真环境适应性测试，模板见附件；l 投资者通过周末实盘测试演练；l 会员至少在仿真环境正常运维10个交易日。 办理流程 联系人信息联系人姓名联系电话Email备注赵主联系人李华备联系人刘备联系人 申请表申请单位请填写下表，并将申请表的盖章扫描件发送至赵波（）,请明确填写邮件主题：XX期货_飞马实盘申请。我方将进入申请处理流程，申核通过后，我司会安排后续相关接入事宜。单位名称单位代码请注明实盘会员代码：_请注明保证金监控中心代码：_席位号请注明接入飞马的席位号：_；席位密码：_；单位地址技术联系人联系电话联系人手机传真号码联系邮箱邮政编码业务联系人联系电话联系人手机传真号码联系邮箱邮政编码备注信息：申请日期: 单位公章：技术公司审批意见： 审核人： 日期： 注意事项1. 飞马的容量参数设置为1024M，预计最大可支持50万报单（不包括错单），如果客户需要支持更多报单数，请与中金技术沟通调整改参数值。第3章 技术支持会员和客户在使用过程中遇到技术问题，可通过以下联系方式与我们沟通：联系人姓名联系电话Email备注龙清ong