使用文档 / 开始使用

完成连接，看清每一步。

先体验纸上工作台，再连接 MT5 信号源观察记录。当前版本不会提交真实交易订单，也不持有交易资金。

打开工作台

打开引擎，可以查看 BTC、ETH 或黄金的公开行情，并运行纸上选路。纸上结果属于模拟，与 MT5 源事件和场所账户余额分开展示。

保存 MT5 连接前，连接 EVM 外部账户钱包并签署网站登录消息。该签名用于建立登录会话，不授予交易或提现权限。当前版本尚不支持智能合约钱包登录。

匹配敞口与资金

资金匹配工具估算复制 MT5 仓位需要的抵押资金。填写源手数、broker 合约大小与目标资金预算。参考合约按黄金每手 100 盎司、BTC 或 ETH 每手 1 枚计算，请按实际 broker 规格修改。

名义敞口 = 手数 × 每手单位 × 价格
初始保证金 ≈ 目标名义敞口 ÷ 所选杠杆
实际敞口倍数 = 总名义敞口 ÷ 账户权益

源账号的 500 或 1,000 倍设置是保证金上限，不是复制倍率，也不是实际敞口。保留相同名义仓位可能需要更多目标资金，分配较少资金则需要降低复制量。同一名义仓位仅改变场所杠杆，不会改变价格波动对应的盈亏金额。

工具按需读取 Hyperliquid 的 BTC、ETH 和 xyz:GOLD 市场规则。价格和保证金档位可能变化，手续费、不利价格变动与已有仓位还需要额外保证金。计算结果只作估算，不会转账、授权场所或触发执行。

打开资金匹配工具 → · 了解外汇与黄金场所候选

安装 MT5 桥接器

下载 Bridge 1.0.0 · EX5、源码与安装指南 ↓

在引擎的「连接」页面填写 MT5 账号和准确的 broker server 名称。创建连接后复制设备 token。
在 MT5 选择 File → Open Data Folder，将 HyperMatchBridge.ex5 放入 MQL5/Experts，再刷新 Navigator 中的 Expert Advisors。
打开 Tools → Options → Expert Advisors，将 https://hypermatch.org 加入允许 WebRequest 的网址。把 EA 挂到源账号的任意一个图表。
把 token 粘贴到 InpDeviceToken。InpBridgeUrl 必须与签发 token 的网站部署一致。看到 PAIRED / PAUSED 后，点击 START RELAY。
保持 MT5 运行且已连接。在网页事件记录中核对下一笔源成交。EA 不会提交或修改 MT5 交易。

如需让该信号源进入模拟选路，在连接中选择「启用模拟选路」。只有启用后符合条件的新事件才会参与，单独采集事件不会启动模拟。选择「停止模拟选路」可关闭该权限。

一份桥接器即可观察该账号的所有品种，不需要钱包私钥、broker 密码或 DLL 权限。挂载或重启不会补发历史交易。

MQL5 源码 · SHA-256 发布清单 · 完整安装指南

理解事件状态

Accepted / observed。 服务端已保存源事件，不代表目标场所已成交。
blocked_mapping. 净持仓反转需要先验证减仓与开仓计划，才能进入执行。
observed_stale. 收到的源事件已过期，保留供核对，不会据此下单。
模拟选路状态。 排队、处理、完成或阻止的模拟任务有独立状态与回执，不改变源事件已接收的含义，也不代表真实成交。
本地 REVIEW。 桥接器因过期事件、无效内容或存储问题暂停。重新启动前先核对源仓位与目标仓位。

发送重试会复用同一事件身份。撤销设备 token 会阻止后续授权写入。暂停 EA 会停止采集和发送，暂停期间的交易在恢复后不会补发。

资金与提现

「充值与提现」工作区区分交易所转入与钱包转账。专属充值地址及真实提现仅在托管和结算服务开通并验证后提供。模拟余额不可兑付。已有的自主管理场所账户，仍可通过官方场所操作。

Hyperliquid 的官方 Arbitrum 路径需要先在自己的钱包持有 Arbitrum One（链 ID 42161）的原生 USDC，以及用于交易 gas 的少量 ETH。使用该钱包连接官方场所并通过 Deposit 流程入金，签名前核对页面显示的网络、代币、费用与目标地址。只把 USDC 转到钱包，不会自动充值 HyperCore 交易余额。

纸上选路与资金计算不需要入金。带测试资金的测试网执行尚未完成验证，实盘交易仍保持关闭。后续场所启用时，应按实际目标仓位计算资金并保留保证金缓冲；源账号较高的杠杆设置不会降低目标场所自身要求。

账户权益与可提现资金是不同金额。未平仓头寸、保证金要求、待处理转账、费用及结算规则都会影响可提额度。提现申请被接受，不代表资金已到达目标钱包。

当前账户读数只覆盖 HyperCore 原生永续账户，不包含现货与独立 HIP-3 DEX 余额。完整账户视图请在场所核对。

打开 Hyperliquid 官方应用 · 官方入金指南 · 独立退出步骤

桥接 API

通过钱包登录会话调用 POST /api/devices 创建设备。返回的 token 绑定指定 MT5 账号与 server。心跳和源事件请求通过 HTTPS 使用该 token。

POST /api/bridge/heartbeat
Authorization: Bearer <device-token>
Content-Type: application/json

{
  "accountLogin": "123456",
  "server": "Broker-Demo",
  "bridgeVersion": "1.0.0",
  "terminalBuild": 5400,
  "queuedEvents": 0,
  "connected": true
}

POST /api/bridge/events 接收下列源事件。账号与 ticket ID 保持字符串，volume 单位为 MT5 源手数。

{
  "eventId": "mt5:Broker-Demo:123456:987654",
  "accountLogin": "123456",
  "server": "Broker-Demo",
  "symbol": "XAUUSD",
  "side": "buy",
  "entry": "in",
  "volume": "0.01",
  "price": "2500.00",
  "occurredAt": "2026-09-19T08:00:00.123Z",
  "dealId": "987654",
  "positionId": "123789"
}

2xx 表示事件已持久接收，包括内容相同的重复事件。409 冲突需要复核，401/403 需要检查设备绑定。此端点只记录观察事件，不会下真实订单。

部署能力端点 · BTC 公开行情