币安 USDⓈ-M 模拟盘申请、私密接入与验收

2026-10-20。仅虚拟资金；本项目没有实盘模式。现有回放账户不会切换或导入币安。

申请 Demo API

1. 打开 币安 Demo，用自己的币安账号登录。 2. 从 **Demo 页面**的账户菜单进入 API 管理，创建系统生成的 HMAC API Key，名称如 hermes-demo。可尝试 Demo API 管理入口， 它会要求登录后返回 Demo；务必确认域名 demo.binance.com，不要使用实盘 API 管理。 3. 自行完成官方页面要求的验证/协议步骤，私密保存 API Key 与 Secret Key。所需权限为 读取账户与 USDⓈ-M Demo 合约交易；权限名称以该页面为准。不要在聊天中发密钥。 4. 如支持 IP 限制，仅允许服务器实际出口 IP。本部署地址为 43.160.223.170；若服务器 经过其他出口/NAT，应使用实际出口地址。预检失败时先检查权限、IP 和系统时间。

币安官方说明 Demo 可通过 API 使用，且有地区资格限制： Demo 官方指引。 公开 FAQ 中某些 API 管理链接可能跳到普通账户页，因此应从已确认的 Demo 页面进入。 本系统只使用官方文档的 Demo 主机：REST https://demo-fapi.binance.com， 用户流 wss://demo-fstream.binance.com。 官方端点说明。

本系统要求的初始账户状态

在 USDⓈ-M Demo 领取或重置虚拟 USDT，初次接入必须空仓、无普通/条件挂单。账户为 单向持仓、USDT 单资产保证金；所选 BTCUSDT / ETHUSDT 设置逐仓、1 倍杠杆。系统不会 替用户改模式、杠杆、撤销外部挂单或重置资金。若不满足，按预检结果在官方页面处理。 不要接管已有人工仓位或重用其他系统的 Demo 账户。

私密配置入口

打开 私密接入页，用原控制令牌连接。 填入独立账户标识、Demo Key/Secret、交易对及风险上限，勾选仅模拟盘确认后保存。 密钥只写入服务器 0600 私密文件，API 不回显；令牌和输入只在页面内存，提交后清空密钥框。 留空只在相同账户标识下保留旧密钥。保存和预检不提交订单。

默认预算为单笔 100、总敞口 300、每日亏损 50、单笔止损风险 10 USDT、杠杆 1 倍。 这是测试预算。30 bps 是发送前价格变化容差/预算缓冲，不保证真实成交滑点。 订单还须满足当前最小名义金额、数量步长和最小数量；若 BTC 最小合规金额超过预算， 可以在已有白名单内考虑满足预算的 ETH，不要自动抬高风控上限。

点击“只读账户预检”，确认资金、模式、空仓、挂单、杠杆与交易规格。通过后点击 “启用 Demo 服务（保持暂停）”；后端会再次预检。启用后启动参数锁定，防止管理订单 期间切换账户。轮换密钥/改参数需先对账，再由运维受控迁移，不能直接覆盖或删除数据库。

独立服务入口：Demo 控制台、 Demo Hermes 对话。未配置时服务只显示待配置， 没有交易核心或交易所连接。启用后的新账户默认暂停开仓，须核对后手动恢复。 模型配置首次从回放私密配置复制；后续各自保存，修改模型需在对应环境的对话页操作。

接入后的真实模拟盘验收

1. 等待 Demo Worker READY，检查环境为 binance_demo、venue 为 binance_usdm_demo， 仓位、余额与官方 Demo 一致；确认没有异常。先用 Demo 对话查询账户，验证工具指向正确环境。 2. 保持暂停时提交开仓意图，应以 PAUSED 拒绝且没有交易所订单。恢复后提交超预算意图， 同样应被风控拒绝。每个请求编号只用一次；相同请求重试不应新增订单。 3. 根据预检交易规格选择满足当前最小金额/步长且低于预算的最小虚拟数量，并指定有效止损， 提交一笔开仓意图。核对普通订单 ID、成交 ID、费用和保护条件单 ID，而非只看“已受理”。 4. 检查保护为 MARK_PRICE / STOP_MARKET / closePosition，存在于官方 Demo 条件单列表。 平仓后确认成交和仓位，再核对保护单取消、风险占用释放、无对账差异。 5. “运行 Hermes 一次”是独立决策入口，最多一个意图，仍受暂停/风险/OMS 约束，也可 HOLD。 文字对话只有查询权限，不能当成交易命令。不要强迫模型为了验收而开仓。 6. 在可控虚拟账户验证未成交限价单/撤单、用户流续期与 REST 对账；保留订单、成交、 保护和审计证据。最后在空仓且状态收敛时重启服务，确认无重复订单、记录保留。

超时/重复响应按 UNKNOWN 保留预留，先查 client ID/订单/成交，不盲目重发。 保护失败会暂停开仓、撤入场余量，并尝试一次只减仓平仓；未知结果需要操作员核对。 /fapi/v1/order/test 不产生模拟成交，不能算闭环验收。

服务器运维

Demo 私密文件位于独立卷 agent-trading_demo-settings 中的 binance-demo.json； Demo 数据卷为 agent-trading_demo-core-data，PostgreSQL 为独立 trading_demo 数据库。 replay 仍使用原 trading 数据库与 core-data，不相互导入账本。 Demo 只监听宿主机 127.0.0.1:8769，经原 HTTPS 网关的 /demo/ 转发；数据库无公网端口。 控制台不挂载 Docker socket，网页不能执行主机命令。

cd /opt/agent-trading
docker compose --env-file shared/core.env -f ops/1panel-compose.yaml ps
docker compose --env-file shared/core.env -f ops/1panel-compose.yaml logs --tail 30 demo
curl -fsS https://trade.zeinzhou.cn/demo/health

备份包含两个数据库、各自数据卷和 demo-settings；全部仅留服务器私密目录，不上传密钥。 本机约 2GB 内存，初期串行运行两环境的 Hermes，持续运行和恢复演练需另行验收。 目前未提供 Demo 私有凭据，真实交易所订单、成交及用户流验收仍待完成；协议样例不能替代。