项目简介
东方财富自动交易接口 Python 库,MIT 许可证。
文档语言:简体中文。 API 名称、Python 代码及命令保留原始英文标识。 Read the Docs 是规范文档站点,GitHub Pages 仅为镜像。
免责声明与风险提示
本项目是社区维护的 非官方 东方财富交易接口实现,并非东方财富或相关券商 发布、授权或背书的官方产品。项目主要面向软件技术学习、研究与交流, 不构成投资建议、收益承诺、证券经纪、投资咨询或任何形式的金融服务。 此用途说明不改变项目 LICENSE 中 MIT 许可证授予的使用权利。
投资和自动化交易风险:证券价格波动可能造成本金损失。请求超时、 网络中断、接口或认证机制变化、验证码误识别、响应解析错误、委托重复提交、 撤单失败、订单状态未知以及第三方服务故障,都可能造成意外交易或资金损失。 自动化测试及少量真实登录成功不代表已验证真实下单、撤单或成交。
非官方接口与合规:非公开或非官方接口可能未经通知即改变、限制或停止服务。 使用者须自行核实相关券商服务协议、账户授权、数据处理要求及适用法律法规; 不得绕过访问控制或用于违法违规活动。
生产环境与责任:本项目未获得生产实盘交易可靠性保证,不建议直接用于 生产环境。若使用者仍选择在生产或实盘环境部署,应自行充分测试、 设置权限和资金限制、监控及人工应急停止措施,并自行承担由使用、 误用、策略决策或第三方服务变化引起的投资风险、运营责任和相应损失。 在适用法律允许的最大范围内,项目作者和维护者不对因此产生的直接、 间接或连带损失承担责任;依法不得排除或限制的责任不受本声明影响。
凭证及隐私安全:使用者负责妥善保管密码、验证码、Cookie、Token 和账户数据。不得在 Issue、日志、CI 或公开讨论中披露敏感信息; 安全问题应按 SECURITY.md 私下报告。
不提供担保:软件按 LICENSE 所载 MIT 许可证以“现状”(AS IS) 提供,不保证正确性、持续可用性、特定用途适用性、交易执行结果或收益。 使用前应自行评估全部风险,且本声明不取代适用法律及券商协议。
安装与支持范围
0.3.0 Stable 沿用已发布的 0.3.0b2 的功能基线, 不增加交易或 OCR 功能,支持 CPython 3.11、3.12、3.13 (Requires-Python >=3.11,<3.14)。 维护者曾在 Ubuntu x86_64、macOS Intel x86_64 六组 Python 环境中, 从 PyPI 安装 Beta 0.3.0b2 并分别完成 10 次真实账户登录, 共 60/60 次成功。该结果不是 0.3.0 Stable 的独立实盘验证, 更不证明所有 Linux/macOS 平台或真实交易获得生产保障; Apple Silicon、Windows、PyPy 尚未验证。
默认 OCR 为冻结微型 CNN(Pillow + Python 标准库),不会默认安装 ddddOCR、NumPy、ONNX Runtime 或 OpenCV。仅在 Python 3.11 可选安装 emtl[ddddocr] 并设置 EMTL_OCR_ENGINE=ddddocr; 显式选择失败不会静默回退。OCR v1 从 0.3.0b2 开始提供; 旧版 0.3.0b1 使用原 OCR。证据见 docs/refactor/reports/OCR-v1-acceptance.md 和 docs/refactor/reports/v0.3.0b2-beta-field-acceptance.md。
已发布的 Beta:0.3.0b1``(2026-11-10)、 ``0.3.0b2``(2026-11-14)。维护者于 2026-11-14 批准 不等待建议观察期而准备 Stable 候选。源码标记为 Stable 不等于 PyPI 已上架 ``0.3.0;应以 PyPI 上的实际发行记录为准。
在 0.3.0 正式上传 PyPI 后,可安装固定版本:
python -m pip install emtl==0.3.0
不指定版本时,pip 从 PyPI 选择符合环境约束的可用稳定版本:
python -m pip install emtl
仍可显式安装此前的 OCR Beta 进行比较:
python -m pip install --pre emtl==0.3.0b2
如需获取开发中的源码,可从仓库安装,但源码不等于已验证的正式发布版本:
python -m pip install https://github.com/riiy/emtl/archive/master.zip
Stable 是正式发行渠道,不意味着真实下单、撤单、成交或长期运行安全性已得到验证。 本项目仍是非官方接口,生产与投资风险免责声明继续适用。
Python 接口
emtl 提供两套兼容边界不同的接口:
旧模块级函数:如 emtl.login() 和 emtl.create_order()。 这些函数复用进程级 Session 和认证令牌,保留历史行为,不保证多账户隔离。
``emtl.TradingClient``:同步、显式绑定账户的客户端,独立管理 Session、Cookie 和 token。使用完毕须在 finally 中调用 close(); 当前不支持 with 或异步接口。
对于 TradingClient,交易 POST 开始尝试后若结果无法确定, 将抛出 emtl.errors.TradeOutcomeUnknown。 不得据此自动重发订单。 旧模块级函数不具备这项新异常契约。离线测试也不能证明真实券商已受理或成交。
命令行 emt 与 python -m emtl 当前只负责解析参数, 不会 实际登录、查询或提交交易。
文档
以上页面由 Read the Docs 提供,GitHub Pages 只是镜像。 站点由原英文项目切换为中文时,需要同步调整 Read the Docs 项目的语言设置; 本仓库不会自动修改该远端设置。
开发与测试
开发及 CI 覆盖 CPython 3.11、3.12、3.13。自动测试只使用合成账户和禁网环境, 不连接真实券商,也不验证真实下单、撤单或成交结果。 SDK 不自动重试、重发或补偿订单。
在隔离测试环境中运行(完整离线验证需额外配置系统级禁网):
python -m pip install -r ci/requirements.txt tox
tox -e docs 生成 HTML;在线外链检查 tox -e linkcheck 独立执行,不属于离线测试。
问题反馈
请勿在公开讨论中提交密码、验证码、Cookie、令牌、账户标识或交易记录。 安全与交易风险报告请遵循 SECURITY.md 的私密联系说明。
变更记录(Changelog)
0.3.0 (Stable)
基于已发布的 0.3.0b2 功能基线晋级 Stable; 保留交易 API、CLI、账户隔离、Unknown 不自动重发和默认轻量 OCR 行为, 无新增功能或运行时依赖升级。
发行元数据与版本配置统一为 0.3.0; CPython 3.11–3.13、Requires-Python >=3.11,<3.14 不变。
Beta 在 Ubuntu x86_64 和 macOS Intel x86_64 的真实登录实测为 60/60;这是维护者报告的 Beta 测试,不是 Stable 包的独立实测、 长期稳定性证明或真实交易安全验证。
2026-11-14 维护者明确决定不等待原建议的约十个工作日观察期; 此例外不会降低独立 Review、精确 SHA CI、产物审计和 PyPI 审批要求。 正式发行是否完成,以 GitHub Release 和 PyPI 的可核实记录为准。
未验证真实下单、撤单、成交、极端网络故障后的委托状态及长期运行; Apple Silicon、Windows、PyPy 仍未验证。保留非官方接口、投资、 凭证与生产部署免责声明。
0.3.0b2 (2026-11-14 已发布的 PyPI OCR Beta)
将已合并的 PR #32 的冻结微型 CNN + Pillow 设为默认 OCR; 旧 ddddocr==1.4.11 调整为仅 Python 3.11 可用的可选 extra, 引擎选择错误不静默回退。
保留四位数字验证码字符串及前导零;Python 支持范围扩至 Linux CPython 3.11、3.12、3.13,不变更旧版交易接口签名。
冻结模型的一次性独立准确率验收为 96/100,前导零 10/10; 目标 CPU P95 低于 1000 ms。参见 docs/refactor/reports/OCR-v1-acceptance.md。
20 MB 安装体积门槛仅适用于目标机器源码编译 Pillow 的部署; 普通用户安装官方 Wheel 允许超过该值。
2026-11-14 已创建 Tag、GitHub Pre-release 并通过 PyPI Trusted Publishing 上传;发行产物、CI 与真实登录验收参见 Beta 验收报告。
0.3.0b1 (2026-11-10 已发布的 PyPI Beta)
2026-11-10 已完成受控 Beta 发布;当时仅覆盖 P0–P3 及 Linux CPython 3.11,不包含后续 OCR v1 改动。
首轮仅验证 Linux / CPython 3.11 (Requires-Python >=3.11,<3.12); Windows、macOS、PyPy 和 Python 3.12+ 不在验证/支持范围内。
包含 P0–P3 的安全加固、兼容保留、TradingClient 多账户隔离以及 TradeOutcomeUnknown / BrokerHTTPError 异常契约。
固定依赖仍为 rsa==4.9、requests==2.33.1、 ddddocr==1.4.11、cryptography==50.0.2; Requests/cryptography 已进行定向安全修复和无网络兼容性验证。
CLI emt 及 python -m emtl 仍只解析参数,不执行交易。 不保证真实券商协议或实际成交;遇到交易结果不确定时不得自动重发订单。
仅提供中文 RST + Sphinx + HTML 文档;PyPI Beta 采用显式预发布安装。 旧版 0.2.6 不具备本轮 P0–P3 保护,不能当作默认安全回退版本。
0.3.0a1 (未发布的内部 Alpha;目标正式版 0.3.0)
保留旧版包级函数、CLI 签名、参数、退出码及成功响应结构; P0 已取消 CLI 凭证回显。
移除 SDK 中的敏感日志和 root logger 重配置, 使用合成替身及系统级禁网隔离自动测试和 CI。
P2 新增独立账户 TradingClient,独立管理 HTTP/认证状态, 同一账户在单进程内串行,不同账户允许并发。
P3 为显式客户端增加 emtl.errors.TradeOutcomeUnknown 与 BrokerHTTPError。Unknown 不代表成交或拒绝,不得自动重发; 旧模块级接口异常行为保持不变。
已批准的支持目标缩小为 Linux / CPython 3.11 (Requires-Python >=3.11,<3.12); 保留 ddddocr==1.4.11 及已批准的运行时依赖固定版本。
增加发布产物安装验证与受人工审批保护的发布流程。 自动化测试未验证真实券商协议或实际交易。
计划 PyPI Beta 0.3.0b1,必须另行批准上传; 正式版 0.3.0 需 Beta 后单独决策。 尚未承诺发布日期或生产可用性。
0.1.0 (2024-04-14)
首次发布至 PyPI。
0.1.1 (2024-04-16)
移除 Python 3.8、3.9 和 PyPy 的旧支持声明。
0.1.2 (2024-04-18)
新增登录、资产和持仓查询。
0.1.3 (2024-04-19)
更新文档主题。
0.1.5 (2024-04-24)
更新登录参考说明。
0.1.7 (2024-04-27)
新增下单接口(当时名称为 insert_order)。
0.1.8 (2024-04-30)
删除 macOS Actions。
0.2.0 (2024-05-21)
补齐当时的全部方法。
0.2.1 (2024-05-29)
增加向 PyPI 的自动部署功能(历史记录)。
0.2.2 (2024-07-11)
将 insert_order 替换为 create_order。
P0 安全基线(历史记录,已纳入 0.3.0b1)
删除敏感日志输出,不再重新配置宿主应用的 root logger。
用隔离的离线测试替代真实交易测试,移除 CI 账户凭证注入。
经明确批准,CLI 不再回显凭证,参数与退出码不变。
将离线测试迁移到仓库根目录的 tests/; 淘汰不安全的 pytest --pyargs emtl 测试入口。
Metadata
Release files for emtl 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| emtl-0.3.0.tar.gz | 348.9 kB | With provenance | Details for emtl-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| emtl-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for emtl-0.3.0-py3-none-any.whl |
Total release size: 690.5 kB
Release files / emtl-0.3.0.tar.gz
| Download URL | emtl-0.3.0.tar.gz |
|---|---|
| Size | 348.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e83b5e8de9ca1f2fe4bc231cd60d2ee7c84aaace25566e9a3135181569551e7e
|
|
BLAKE2b-256 checksum How to use checksums |
bbe8556355ba7e98a8fb8f0b7f9bcc2490b92394d335f65d4b9b879aec07255e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.
Transparency logRelease files / emtl-0.3.0-py3-none-any.whl
| Download URL | emtl-0.3.0-py3-none-any.whl |
|---|---|
| Size | 341.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2d59080eb9524c12bfa9fc6159985724dab34235c93e3c2e15b25c94a09a39c8
|
|
BLAKE2b-256 checksum How to use checksums |
374759a4446fb66217fd468301d7acd27070884741a2d8646ffdc868aec0f178
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.
Transparency logSecurity for emtl 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for emtl-0.3.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.