11.3 交易接口与模拟盘
课前导读
学习目标
学完能解决什么困惑：为什么真正接触交易接口前，必须先经过模拟盘、人工确认和小资金观察。 难度：advanced 用时：约 45 分钟 适合对象：已经理解策略、回测、组合风险和实盘系统架构，但还没有安全上线经验的 A 股新手。
本节会谈到“交易接口”。 先把边界说清楚：本课程不会提供任何真实券商接口的连接步骤，不会展示真实自动下单代码，也不会教你绕过人工确认。 我们只讲概念、权限、风险和低风险试运行清单。 原因很直接：交易接口连接的是你的真实账户和真实资金。 它不是一个普通软件按钮。 它更像银行保险柜的门。 开门之前，你要确认身份、权限、额度、记录、监控和紧急停止方式。 如果一个人还没有在模拟盘里稳定记录，没有经历人工确认，没有用小资金观察过真实摩擦，就不应该把程序直接推向实盘自动执行。 本节的目标，是让你知道该害怕什么、该检查什么、该如何低风险推进。
知识正文
1. 类比：交易接口像保险柜钥匙
想象你有一把保险柜钥匙。 钥匙本身不会帮你赚钱。 它只是允许你打开保险柜。 如果你把钥匙交给不成熟的流程，风险会立刻放大。 一个错误的数量，一个错误的方向，一个重复动作，都可能伤害真实资金。
交易接口也是这样。 它只是系统和交易账户之间的通道。 通道越顺畅，越需要安全边界。 新手最容易犯的错误，是把“能连接”误以为“能上线”。 专业视角恰好相反：能连接只是最低门槛，能安全停下来才是上线条件。
2. 术语：什么是接口
接口可以理解为两个系统约定好的沟通方式。 人和手机沟通靠屏幕按钮。 程序和数据文件沟通靠读取规则。 程序和交易系统沟通，也需要某种约定。 但在投资学习中，我们不需要掌握真实接入细节。 你只要知道：接口会把“查询、提交、撤销、回报、状态”等信息在系统之间传递。
请注意，理解接口不等于使用真实接口。 对新手来说，更重要的是理解接口权限和失败后果。 如果只是查询行情，风险较低。 如果可以提交委托，风险就高得多。 如果还能撤单、修改、批量操作，系统边界就必须更严格。
3. 术语：什么是权限
权限就是系统被允许做什么。 就像家里钥匙分为大门钥匙、房间钥匙和保险柜钥匙。 交易相关权限也应分层。 最安全的学习顺序是： 先只读。 再模拟。 再人工确认。 再小资金观察。 最后才讨论更高自动化。
| 权限层级 | 可以做什么 | 风险水平 | 学习阶段建议 |
|---|---|---|---|
| 只读观察 | 看数据、看持仓、生成报告 | 较低 | 适合早期学习 |
| 模拟盘 | 用虚拟资金记录委托和成交 | 较低但仍需复盘 | 必须经历 |
| 待确认清单 | 系统生成建议，人来检查 | 中等 | 实盘前必要训练 |
| 小资金人工执行 | 人按清单手动操作极小规模 | 中高 | 观察真实摩擦 |
| 无人自动执行 | 程序直接影响真实账户 | 极高 | 新手不应进入 |
这张表不是技术路线图，而是风险分层图。 请把它当成刹车顺序，而不是升级攻略。
4. 模拟盘：不是游戏，而是压力测试场
很多人轻视模拟盘。 他们觉得模拟盘没有真实资金压力，所以没有意义。 这只说对了一半。 模拟盘确实不能完全模拟真实情绪。 但它能暴露大量工程问题。 例如信号是否重复出现。 数量是否计算错误。 委托状态是否记录完整。 涨停买不到时系统是否仍假设成交。 日志是否能还原全过程。 风控拒绝是否真的生效。 这些问题在真实账户里暴露，代价就太高了。
所以模拟盘不是为了证明策略一定赚钱。 模拟盘是为了证明流程没有明显低级错误。 如果模拟盘都做不到稳定记录，就更不应该碰真实接口。
5. 人工确认：不是落后，而是安全门
有些人觉得人工确认很慢。 但在学习阶段，慢就是保护。 人工确认的意义不是让人凭感觉推翻系统。 而是检查系统有没有犯低级错误。 证券代码是否正确。 名称是否对应。 方向是否正确。 数量是否符合仓位上限。 价格是否合理。 触发理由是否和策略一致。 是否遇到停牌、涨跌停、公告或组合暂停规则。
人工确认应该写成清单，而不是临时凭感觉。 清单越固定，越能减少情绪干扰。 当你连续很多次能按清单稳定判断，再考虑是否降低人工干预。 但“降低”不等于“取消所有安全门”。
6. 小资金观察：用最小代价接触真实摩擦
模拟盘之后，也不应该立刻放大资金。 下一步是小资金观察。 这里的小资金，不是你觉得“亏得起就行”。 而是即使出现系统错误、连续亏损或无法成交，也不会影响生活和情绪的规模。 它的目的不是赚钱。 它的目的是观察真实摩擦。
真实摩擦包括： 成交价格和预期不同。 排队买不到或卖不出。 盘中情绪导致你想改计划。 T+1 让你无法当天纠错。 涨跌停让止损不能立即执行。 真实亏损让你不愿承认系统问题。 这些都是回测和模拟盘无法完全覆盖的部分。
7. A 股语境下的接口风险
A 股市场有一些必须牢记的现实边界。 普通股票实行 T+1，买入当天通常不能卖出。 许多股票有涨跌幅限制，极端时可能无法按计划成交。 停牌会让交易动作无法执行。 成交量不足会放大滑点。 公告和监管信息有披露时间，不能在回测和实盘中混用。 不同板块交易规则也可能不同。
如果系统只会说“满足条件就交易”，它还不够成熟。 成熟系统要能说： 今天不能交易。 今天只观察。 今天需要人工复核。 今天风控拒绝。 今天记录异常后暂停。 会拒绝的系统，比只会执行的系统更安全。
8. 不提供真实接口代码的原因
你可能会好奇：为什么不直接给一个示例程序？ 因为真实自动下单代码很容易被误用。 同样几行代码，在不同账户、不同权限、不同券商环境和不同网络状态下，后果可能完全不同。 课程读者是 A 股投资新手，刚刚走到实盘工程化阶段。 此时最需要建立的是风险意识和流程能力，而不是复制一段能影响真实资金的代码。
因此，本节只提供“不可执行的学习伪代码”。 它用来表达安全顺序，不包含真实连接、认证、下单或撤单实现。
准备阶段：
确认策略已经有回测报告和风险边界
确认模拟盘环境可记录完整日志
确认人工确认清单已经固定
观察阶段：
系统只生成待确认清单
人工检查代码、方向、数量、理由、风险
模拟盘记录委托状态和差异
升级判断：
如果日志缺失，停止升级
如果风控拒绝无记录，停止升级
如果模拟成交偏差无法解释，停止升级
如果人工确认经常改动规则，停止升级这段伪代码没有任何真实交易能力。 它的价值在于提醒你：升级的前提是证据，而不是兴奋。
9. 低风险推进路线
下面是一条适合学习者的安全路线。 它不是保证盈利的路线，而是降低工程事故的路线。
graph TD
A["研究规则"] --> B["回测报告"]
B --> C["模拟盘观察"]
C --> D["人工确认清单"]
D --> E["小资金人工执行"]
E --> F["持续监控与日志"]
F --> G["复盘后决定是否继续"]
C --> H["发现流程错误"]
H --> I["回到规则修正"]
E --> J["出现真实摩擦"]
J --> K["降低规模或暂停"]这张图里没有“直接全自动上线”。 这不是遗漏，而是有意删除。 对新手来说，全自动不是里程碑，稳定可控才是里程碑。
10. 模拟盘要看什么
模拟盘不是每天看收益排名。 模拟盘应该看流程质量。 至少记录这些项目。
| 项目 | 观察问题 | 不合格信号 |
|---|---|---|
| 信号一致性 | 是否按同一规则产生 | 今天改规则，明天改口径 |
| 风控拒绝 | 超限时是否真的拒绝 | 超限仍进入执行清单 |
| 委托状态 | 未成交、部分成交是否记录 | 只记录成功，不记录失败 |
| 成交偏差 | 模拟成交价与预期差多少 | 偏差无法解释 |
| 日志完整 | 事后能否还原流程 | 只有结果，没有原因 |
| 人工确认 | 是否按清单检查 | 凭感觉跳过步骤 |
如果模拟盘连续出现不合格信号，不要急着修饰报告。 要回到系统架构，找出问题在哪里。
11. 人工确认清单示例
下面的清单可以作为练习模板。 它不会教你连接真实账户。 它只训练你在任何可能影响资金的动作前先停下来。
| 检查项 | 必填内容 | 通过标准 |
|---|---|---|
| 标的确认 | 股票代码、名称、板块 | 代码和名称一致 |
| 动作确认 | 买入、卖出、观望 | 与策略信号一致 |
| 数量确认 | 计划股数或金额 | 不超过单票和组合上限 |
| 价格确认 | 预期价格区间 | 考虑涨跌停和滑点 |
| 理由确认 | 触发规则和数据时间 | 能追溯到规则 |
| 风险确认 | 止损、暂停、不可成交预案 | 先写风险再执行 |
| 状态确认 | 是否停牌、是否公告异常 | 异常时暂停 |
| 记录确认 | 日志编号和复盘时间 | 没有日志不行动 |
这张表的关键是最后一行。 没有日志不行动。 这句话可以避免很多事后说不清的错误。
12. 小资金观察要观察多久
没有一个固定天数能保证安全。 但可以设定最低观察条件。 例如至少覆盖 20 个交易日。 至少经历几次信号出现和几次风控拒绝。 至少记录一次未成交或成交偏差。 至少完成每周复盘。 至少没有出现方向错误、数量错误和无日志动作。 如果这些条件没有满足，就不要因为一两次盈利而放大规模。
小资金观察的结果可以分三类。 第一类，流程稳定但策略表现一般。 这说明系统能力有进步，但策略还需研究。 第二类，策略看起来赚钱但流程混乱。 这反而危险，因为好运掩盖了系统风险。 第三类，流程和表现都不稳定。 这时应该暂停，而不是加码。
13. 常见危险信号
如果出现下面情况，请停止升级计划。
- 你说不清某次信号为什么出现。
- 模拟盘和记录表经常对不上。
- 风控规则触发后，你仍想找理由执行。
- 系统出现异常时，你不知道如何暂停。
- 你开始期待程序替你克服贪婪和恐惧。
- 一次盈利后，你想跳过观察期直接放大资金。
- 你把接口权限当成技术成就，而不是风险责任。
这些信号说明问题不在代码，而在流程和心态。 实盘系统不会替你变得自律。 它只会把你的规则或混乱放大。
14. 专业老师、投资者、开发者的共同结论
老师会提醒你：先会解释，再谈执行。 如果你不能向一个零基础朋友讲清楚系统如何停止，就不要让它接触真实资金。
投资者会提醒你：资金安全优先于技术炫耀。 保住本金和学习能力，比证明自己会自动化更重要。
量化开发会提醒你：权限越大，防护越多。 真实系统最重要的能力不是连接，而是校验、拒绝、暂停、记录和恢复。
这三种视角合在一起，就是本节的核心： 模拟盘先行。 人工确认保留。 小资金观察。 日志和复盘驱动升级。 任何一步不合格，都回退。
交互实验室
练习：低风险试运行清单
请复制下面清单到你的笔记中。 每一项只能填“已完成 / 未完成 / 不适用”。 只要有一项关键内容未完成，就不要进入真实资金阶段。
| 分类 | 检查项 | 状态 |
|---|---|---|
| 研究证据 | 有完整回测报告，包含成本、滑点、最大回撤和风险边界 | 未完成 |
| 数据证据 | 数据来源、更新时间、复权口径和异常处理已记录 | 未完成 |
| 风控证据 | 单笔、单票、组合层风控规则已写成清单 | 未完成 |
| 模拟盘 | 至少完成 20 个交易日模拟盘观察 | 未完成 |
| 模拟盘 | 记录过未成交、部分成交或成交偏差处理方式 | 未完成 |
| 人工确认 | 每次动作前检查代码、名称、方向、数量、价格和理由 | 未完成 |
| 日志 | 每次信号、拒绝、确认、模拟成交和复盘都有记录 | 未完成 |
| 暂停机制 | 出现数据异常、风控冲突或日志缺失时能立即暂停 | 未完成 |
| 小资金 | 小资金规模不影响生活和情绪 | 未完成 |
| 升级规则 | 放大资金的条件和回退条件提前写好 | 未完成 |
练习：写下你的三条红线
请写下三条任何时候都不能突破的红线。 可以参考下面格式。
红线一：没有日志，不执行任何可能影响资金的动作。
红线二：风控拒绝后，不用主观理由强行放行。
红线三：模拟盘未稳定前，不进入真实自动执行。练习：试运行复盘问题
每周复盘时回答这些问题。
- 本周有多少个信号？
- 有多少个被风控拒绝？
- 有多少个需要人工确认后放弃？
- 模拟盘成交和预期差多少？
- 有没有数据异常、状态异常或日志缺失？
- 如果今天就换成真实资金，最大可能出错在哪里？
- 下一周要降低复杂度，还是继续观察？
这些问题比“本周赚没赚钱”更重要。 因为你现在训练的是实盘能力，不是追求短期兴奋。
核心复盘
知识清单：
- [ ] 我知道交易接口只是通道，不是赚钱能力。
- [ ] 我理解权限越高，越需要风控、确认、日志和暂停机制。
- [ ] 我知道模拟盘用于暴露流程问题，而不是证明一定盈利。
- [ ] 我能解释为什么人工确认是安全门，不是落后做法。
- [ ] 我知道小资金观察的目的是真实摩擦测试，不是快速放大收益。
- [ ] 我能使用低风险试运行清单判断是否应该继续升级。
金句总结
不要把接口当成捷径；真正的实盘能力，是在每一次可能出错前先设置刹车。