# 认识易行量化

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

## 能力与边界

| 能力 | 期货 | 期权 |
| --- | --- | --- |
| 合约查询与详情 | 支持 | 支持 |
| 实时行情与盘口 | 支持 | 支持 |
| 固定窗口 K 线 | 支持 | 暂不支持 |
| 按交易日下载历史 K 线 | 支持 | 暂不支持 |
| 普通投机限价委托与撤单 | 支持 | 支持 |
| 行权、弃权、特殊交易操作 | 不提供 | 不提供 |

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

## 系统如何连接

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

## 推荐学习路线

- [安装与环境](./installation.md) → [快速开始](./quickstart.md)：成功运行第一个行情程序。
- [更新模型与生命周期](./concepts.md)：理解数据何时更新、快照如何使用。
- [合约查询](./symbols.md) → [行情](./quotes.md) → [K 线](./klines.md) → [历史下载](./history.md)。
- 需要交易时学习 [CTP 账户与交易数据](./trading.md)、[下单与撤单](./orders.md)、[错误处理](./errors.md)。
- 编写代码时配合 [完整接口参考](./api-reference.md)、[数据字典](./data-reference.md) 与 [示例下载](./examples.md)。

## 给 AI 助手的约定

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

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