API 故障切换与撤单控制披露雷达

决策矩阵

来源地图

• Binance Support：Notice on Binance Spot API Update (2026-06-25)（binance-spot-api-update-20260625）
• Binance Developer Docs：Spot REST API Trade endpoints（binance-rest-trade-docs）
• Binance Developer Docs：Spot WebSocket API trading requests（binance-ws-trade-docs）
• Kraken API Center：Dead man switch（kraken-dead-man-switch）

控制说明

1. Trigger

这一项要求读者先把公开来源翻译成操作规则。这里的含义是：maintenance, disconnect, timeout, rate limit or partial failure。可执行动作是：classify trigger before writing guidance。仍然未知的是：private incident cause。因此本文不会把未知部分包装成安全承诺、收益承诺、官方背书、审批保证、可用性保证或注册诱导。

2. Cancel scope

这里的含义是：which orders can be canceled by the control。可执行动作是：state scope exactly。仍然未知的是：hidden open orders。

3. Reconnect behavior

这里的含义是：what the venue says after socket disconnect。可执行动作是：reconnect, resubscribe and reconcile。仍然未知的是：lost private messages。

4. Timer behavior

这里的含义是：whether protection requires repeated refresh calls。可执行动作是：monitor cadence and timeout margin。仍然未知的是：client clock drift。

5. Rate-limit handling

这里的含义是：whether cancel-only behavior remains available。可执行动作是：document fallback mode。仍然未知的是：live usage count。

6. Partial result

这里的含义是：cancel succeeds but new order fails or vice versa。可执行动作是：treat each leg as separate evidence。仍然未知的是：fills between legs。

7. Machine-readable state

这里的含义是：API endpoint or stream used for verification。可执行动作是：prefer read-only verification after outage。仍然未知的是：permission scope。

8. Human-readable notice

这里的含义是：announcement or status text explaining service change。可执行动作是：attach official URL and date。仍然未知的是：localized discrepancy。

9. Secret boundary

这里的含义是：API key, signature, balance and strategy data。可执行动作是：never store secrets in article evidence。仍然未知的是：debug log leakage。

10. Stop rule

这里的含义是：when radar cannot publish a safe conclusion。可执行动作是：stop on unknown order state, endpoint scope or reconnect behavior。仍然未知的是：future docs change。

仍需明确的未知项

• private incident cause
• hidden open orders
• lost private messages
• client clock drift
• live usage count
• fills between legs
• permission scope
• localized discrepancy
• debug log leakage
• future docs change

实用结论

本文最有价值的地方是克制。NexuAlpha Radar 把 API 故障切换视为披露问题，并拆成五个字段：触发条件、撤单范围、重连行为、机器可读状态和秘密边界。Binance 为其中三项提供证据：更新公告说明 Spot API 基础设施升级期间 WebSocket 连接可能断开，用户应重新连接；REST 文档描述 cancelReplace 处理与订单速率限制行为；WebSocket 文档提供 order.cancelReplace。Kraken 则提供另一类基于计时器的控制：其 Futures dead man switch 会在 timeout 到期且没有刷新或关闭时取消用户所有订单。雷达结论是：API 文章不能因为某个平台有一个端点就说它更安全，而应披露该端点撤销什么、不知道什么、断线时发生什么，以及在不暴露 API key 或余额的前提下需要核验什么证据。 用户应获得一个更清楚的核验路径，而不是一个看似肯定、实则无法由公开证据承担的承诺。