exsdk 常见问题：安装、行情与 CTP 接入

这里汇总安装、账户、行情和交易接入中的常见问题，并提供相关教程的入口。

安装时提示找不到匹配的版本？#

请确认使用 Python 3.12 及以上的 64 位解释器，并检查系统和架构：Windows x86_64、Linux x86_64 或 macOS Apple Silicon arm64。SDK 通过平台 wheel 分发，不支持的平台不能通过源码安装绕过限制。完整步骤见安装与环境。

使用微信扫码登录官网，在个人中心查看 SDK Token。新账户享一次 15 天专业版体验；到期后可在个人中心续费。有效期内续费会保留剩余时间。不要将 Token 放进公开仓库或共享 Notebook。

不会，按所购时长一次性付款，到期后手动续费。方案与购买说明见价格方案。

订阅句柄需要配合 wait_update() 推进更新。在更新循环中检查变化，再读取快照；同时检查合约、交易时段和网络连接。有限等待超时不等于连接已断开。详见更新模型与生命周期和实时行情。

订阅刚建立时，数据可能尚未到达；部分字段也可能暂时无有效值。计算前应按字段类型检查有效性，不要把缺失值直接作为可交易价格。详见初始值与缺失值。

目前 K 线及历史 K 线下载面向期货；期权支持合约查询和实时行情等能力。完整范围见能力与边界。

资金账号 user_id 需要在官网个人中心绑定。交易密码、前置地址、AppID 和 AuthCode 配置在本地 SDK 中，交易密码和委托不经过官网。详见CTP 账户与交易数据。

默认窗口固定为 200 行，历史不足时会在前面补零时间戳和 NaN；行数不等于有效 K 线数量。先筛选 timestamp > 0，再检查指标所需价格，见窗口长度与有效数据。

K 线变化检测只比较末行，新一根收盘价可能与前一根相同。识别末行时间推进时检查 "timestamp"；每根完成 K 线处理一次的例子见 K 线教程。

默认检测不包含 updated_at，金额未变时可以返回 False。要观察查询完成时间，使用 funds.is_changing("updated_at")，见资金刷新。

不会。is_main=True 返回查询时带主力标记的具体合约，已有订阅继续观察原合约。换月需由应用明确处理，见合约查询。

不能。实时行情提供最新快照，中间更新可能合并。完整 Tick 历史下载也不属于当前公开 API，见实时行情。

SUBMITTED 仅表示提交，不代表柜台接受或成交。通过更新循环跟踪订单最终状态。UNKNOWN 表示结果不确定，不要自动重发，以免重复委托。详见下单、撤单与结果跟踪及错误处理与恢复。

不会。等待期限只结束本次等待，关闭只释放资源；柜台已有委托仍需核对和处理。结果不明时不要盲目重发，见订单跟踪。

不一定。历史补录数据可能缺少成交额而以 0 保存，SDK 不会自动标为 NaN。计算成交额相关指标前需核实数据来源，见历史下载。