认识易行量化

易行量化（Python 包名 exsdk）是天至科技提供的 Python 期货、期权行情与直连 CTP 交易 SDK。本文档对应 1.1.2，面向人工开发者及 AI 编程助手。先学习快速开始与运行模型，再按任务查阅接口参考、数据字典及完整示例。

能力与边界

SDK 不提供云端策略托管、收益保证、回测引擎或托管的交易账户。官网的专业版代表 SDK 认证权益，不代表不同的行情等级。

系统如何连接

1. 本地 Python 程序使用 Token 向账户服务验证专业版或体验权益。
2. SDK 从行情服务查询合约、行情和历史 K 线，并维持行情订阅。
3. 配置 CTP 后，本地 SDK 直接连接期货公司柜台。交易账号、密码、委托不经过官网或行情服务。
4. 策略、指标计算和交易决策留在本地。SDK 不另行持久化订单、成交与持仓；CTP 原生库可能在系统临时目录留下运行所需的流文件。

推荐学习路线

• 安装与环境 → 快速开始：成功运行第一个行情程序。
• 更新模型与生命周期：理解数据何时更新、快照如何使用。
• 合约查询 → 行情 → K 线 → 历史下载。
• 需要交易时学习 CTP 账户与交易数据、下单与撤单、错误处理。
• 编写代码时配合 完整接口参考、数据字典 与 示例下载。

给 AI 助手的约定

优先使用当前文档里的方法签名，不使用旧版本“下单返回订单号列表”的写法。下单、撤单返回 list[TradingResult]；SUBMITTED 仅表示提交，不等于接受或成交；UNKNOWN 不得自动重发。

使用 /llms.txt 获取文档索引，使用 /llms-full.txt 获取全部教程与接口参考；单页 Markdown 位于 /docs/<slug>.md。网页和 Markdown 使用同一份内容。