DDDD 东财网页交易 API

要解决什么问题

把东财（Eastmoney）网页交易接口封装成可维护的 Python 项目时，常见痛点是：登录态、validatekey、cookies 散落在脚本里，策略逻辑和真实下单耦在一起，README 或日志里一不小心就会泄露账号、密码或会话材料。公开仓库或 SkillHub 上传前，也很难系统性地检查是否还有硬编码密钥。

本技能面向「可复现、可公开发布」的封装工程，而不是鼓励默认实盘下单。

技能如何引导你落地

默认工作流强调先审阅现有项目，再保持 dry-run 优先：构造函数、CLI、示例和测试里 dry_run=True 应是常态；只有显式传入类似 --live-trade 才应调用真实的 SubmitTradeV2。

推荐的包结构把职责拆开：

• client.py：基于 DrissionPage 打开 https://jywg.18.cn/，完成登录与验证码处理，从持仓查询请求中捕获 validatekey 与 cookies，提供 query_positions()、submit_order(order) 等核心方法
• models.py：东财下单 payload 与 Order 等类型化模型
• settings.py / CLI：从 .env 或环境变量读取账号密码，CLI 演示持仓查询与 dry-run 下单
• strategy.py（可选）：策略只生成订单 payload 或 Order 对象，由调用方决定是否提交

安全规则会反复提醒你：敏感路径进 .gitignore、日志用 mask_secret() 等做脱敏、README 含风险免责声明，发布前按清单人工复核 secret scan 结果。

适用边界

技能描述的是网页端交易封装模式（DrissionPage + 会话内 validatekey），不包含 cancel order、成交流水等完整经纪商 API 路线图以外的保证。策略示例应写成 payload 生成或 dry-run 演示，勿把截图里的金额、账号当作未来收益承诺。可转债、ETF 等策略需先规范化持仓行并按代码前缀分类证券类型，再生成订单。