下载示例使用环境变量，不包含真实令牌或交易密码。运行前请按 安装与环境 手动设置 EXSDK_TOKEN；这是示例约定的变量名，不是 SDK 内置变量。脚本调用 os.environ 读取后，再将令牌传入 ExApi。完成配置后，每个文件均可独立运行。
行情与分析
| 文件 | 内容 | 运行方式 |
|---|---|---|
| quickstart.py | 自动发现主力合约并观察行情 | python quickstart.py |
| quotes.py | 期货 / 期权行情、盘口与时间戳 | python quotes.py --kind FUTURE 或 python quotes.py --kind OPTION |
| klines.py | K 线快照及 MA20 | python klines.py |
| history.py | 按交易日导出 CSV | python history.py --symbol 合约代码 --start 20260901 --end 20260909 --output history.csv |
默认自动选取的第一份合约仅用于接口演示，不代表交易推荐。历史示例的合约和日期必须按实际数据范围指定。
交易与撤单
| 文件 | 内容 | 运行方式 |
|---|---|---|
| account.py | CTP 同步、资金、持仓和订单快照，只读 | python account.py |
| trading.py | 限价委托与结果跟踪 | 默认不下单；阅读脚本后显式传入 --execute 及合约、价格 |
| cancel.py | 按本地订单号撤单并跟踪 | 默认不撤单；显式指定 --execute --order-id 本地订单号 |
CTP 示例需要本地设置 CTP_BROKER_ID、CTP_USER_ID、CTP_PASSWORD、CTP_FRONT_URL、CTP_APP_ID、CTP_AUTH_CODE。使用 Ctrl+C 可退出观察程序，但退出不自动撤销已提交的订单。
常见改编方式
- 用真实查询结果或明确指定的有效合约替换样例合约。
- 在
wait_update()发布快照后再计算业务指标，避免使用旧快照作出交易决策。 - 多个合约在循环之前创建句柄，通过一层更新循环处理。
- 将
UNKNOWN与网络超时的处理交给订单跟踪与人工核对，不做无条件重发。