一、例程基础信息

1. 开发环境：易语言（支持32位/64位编译，Windows全平台运行）

2. 核心依赖：FutureTraderApi.ec（FTAPI交易接口专用易语言模块）

3. 接口版本：FTAPI V2.19.8088

4. 业务规范：严格遵循期货CTP交易业务流程

5. 调用模式：异步回调 + 主动查询双模式

6. 适用场景：模拟环境（SimNow）/生产环境一键切换

二、例程核心功能模块

本例程将FTAPI交易接口全能力封装为七大功能模块，覆盖从登录到结算、从报单到查询的完整交易闭环，所有功能均通过易语言组件+模块命令直接实现，可直接编译运行。

（一）接口初始化与连接管理模块

• 支持FTAPI全局初始化，自定义流文件路径、日志存储路径、回调程序地址；

• 实现交易前置服务器连接、断开、状态实时监控；

• 自动监听连接成功、连接断开、心跳报警、服务器状态推送等回调消息；

• 支持查询FTAPI接口版本、CTP原生API版本、当前交易日；

• 提供客户端身份认证接口，完成交易前强制认证流程。

（二）用户登录与结算管理模块

• 实现投资者账户登录/登出，支持配置：经纪商代码、投资者账号、密码、AppID、AuthCode；

• 手动获取结算单信息，展示结算内容并完成结算单确认（交易前置必备操作）；

• 支持修改交易密码、资金密码，回调返回操作结果；

• 登录状态实时同步，未登录状态自动屏蔽交易操作。

（三）账户资金与持仓管理模块

• 资金查询：实时获取可用资金、持仓盈亏、冻结保证金、手续费、权益等核心数据；

• 持仓查询：支持查询全市场持仓、指定合约持仓、持仓明细数据；

• 投资者信息查询：获取交易编码、投资者类型、权限信息；

• 自绘列表框组件：所有数据通过模块自绘列表框组件直接展示，直观可读，该控件颜色控制，标识控制配置简单，数据展示高效。

（四）交易报单与撤单模块（核心功能）

• 支持买开、买平、卖开、卖平全方向报单；

• 支持限价单、条件单等常规报单类型，可自定义价格、数量、有效期类型；

• 支持预埋单、预埋撤单录入与删除，满足非交易时间委托需求；

• 提供撤单功能，支持根据报单编号快速撤销未成交委托；

• 内置报单引用（OrderRef）自动管理，避免报单冲突；

• 实时回调报单状态：已报、未成、部成、全成、撤单、废单。

（五）成交与报单查询模块

• 报单查询：查询当日所有报单记录，支持按合约、状态筛选；

• 成交查询：查询当日全部成交明细，包含成交价格、成交量、成交时间；

• 预埋单查询：查询所有预埋单信息与状态；

• 数据自动解析并填充到自绘列表框控件，支持查看、导出、回溯。

（六）合约与交易参数模块

• 查询交易所列表、品种列表、合约列表，支持本地缓存；

• 查询合约保证金率、手续费率、报价单位、最小变动价位；

• 回调接收合约交易状态（开盘、收盘、集合竞价、停牌）；

• 支持查询合约深度行情数据，辅助交易决策。

（七）银期转账与辅助功能模块

• 支持银期转账（银行→期货/期货→银行）；

• 查询转账流水、签约银行、银期签约关系；

• 查询银行账户余额；

• 内置日志输出组件，实时显示接口回调信息、错误信息、操作记录；

• 统一错误处理：错误码+错误信息自动解析，弹窗+日志双重提示。

三、例程运行使用步骤

1. 准备依赖    将FutureTraderApi.ec模块导入易语言开发环境，确保模块加载正常。

2. 配置参数    在例程中填写：交易前置地址、投资者账号、密码、AppID、AuthCode、授权码。

3. 编译运行    直接编译易语言源码，运行程序，通过界面按钮测试连接、登录、报单、查询等功能。

4. 查看日志与数据    界面日志区实时输出操作结果，资金、持仓、报单、成交自动展示在对应表格。

5. 二次开发    可直接基于本例程增删功能，例如：自动交易策略、条件单触发、数据统计、UI定制等。

四、版本与技术支持

• FTAPI接口版本：V2.19.8088

• 易语言模块：[FutureTraderApi.ec]

• 开发厂商：永轩软件

• 技术支持：QQ 77766508

• 官方网站：www.yx10000.com