源头核验研究

加密 API 有效截止时间与重试重放披露雷达

4 分钟

已验证事实边界

1. Binance Spot REST documentation says responses include used-weight headers for rate limiters and describes request security for secure endpoints. 2. OKX documentation describes expTime for supported order requests and rate-limit rejection code 50011. 3. Kraken support says nonce is required for authenticated Spot REST API calls. 4. Coinbase Advanced Trade documentation presents REST and WebSocket APIs for programmatic trading and order management. 5. Freshness controls and client order identifiers reduce retry ambiguity only when final state is reconciled after a timeout or disconnect. 6. A local bot log cannot prove a venue-side order outcome unless it is tied to a non-secret official response or subsequent status query.

收起完整分析

决策矩阵

文章表格:可横向滑动,或聚焦表格区域后使用方向键。

CheckWhat it meansPractical actionUnknown to keep explicit
Deadline fieldvenues may expose recv windows, expTime or other freshness boundariesrecord the exact supported field before enabling retrieswhether SDK defaults hide the real value sent
Nonce or timestampfreshness can be monotonic nonce, timestamp window or deadline headertest parallel workers for duplicate or stale freshness valueswhether server and client clocks diverge under load
Client order identityretries need a stable id or status lookup to avoid duplicate orderswrite client id, venue id and status into non-secret logswhether the venue treats duplicate ids as reject, replace or old-order lookup
Rate-limit ownerlimits may be IP, User ID, connection or endpoint specificpartition workers by documented limit ownerwhether subaccounts share hidden quotas
Timeout recoverynetwork timeout does not prove the venue ignored the requestquery final state before submitting a replacementwhether partial fill creates residual exposure
Disclosure qualitygood documentation separates authentication, freshness, rate limit and final-state semanticsscore the venue by documented control, not marketing copywhether account-specific behavior differs from public documentation

来源地图

  • Binance Developer Docs:General REST API Information(binance-spot-rest)
  • OKX Technical Documentation:OKX API guide(okx-api-guide)
  • Kraken Support:What is a nonce?(kraken-nonce)
  • Coinbase Developer Platform:Advanced Trade API overview(coinbase-advanced-overview)

控制说明

1. Deadline field

这一项要求读者把公开来源翻译成操作规则。这里的含义是:venues may expose recv windows, expTime or other freshness boundaries。可执行动作是:record the exact supported field before enabling retries。仍然未知的是:whether SDK defaults hide the real value sent。因此本文不会把未知部分包装成收益承诺、牌照承诺、审批保证、安全保证、恢复保证、平台排名或价格暗示。

2. Nonce or timestamp

这里的含义是:freshness can be monotonic nonce, timestamp window or deadline header。可执行动作是:test parallel workers for duplicate or stale freshness values。仍然未知的是:whether server and client clocks diverge under load。

操作测试也必须很窄。这就是本文坚持以清单形式呈现的原因。

3. Client order identity

这里的含义是:retries need a stable id or status lookup to avoid duplicate orders。可执行动作是:write client id, venue id and status into non-secret logs。仍然未知的是:whether the venue treats duplicate ids as reject, replace or old-order lookup。

操作测试也必须很窄。这就是本文坚持以清单形式呈现的原因。

4. Rate-limit owner

这里的含义是:limits may be IP, User ID, connection or endpoint specific。可执行动作是:partition workers by documented limit owner。仍然未知的是:whether subaccounts share hidden quotas。

操作测试也必须很窄。这就是本文坚持以清单形式呈现的原因。

5. Timeout recovery

这里的含义是:network timeout does not prove the venue ignored the request。可执行动作是:query final state before submitting a replacement。仍然未知的是:whether partial fill creates residual exposure。

操作测试也必须很窄。这就是本文坚持以清单形式呈现的原因。

6. Disclosure quality

这里的含义是:good documentation separates authentication, freshness, rate limit and final-state semantics。可执行动作是:score the venue by documented control, not marketing copy。仍然未知的是:whether account-specific behavior differs from public documentation。

操作测试也必须很窄。这就是本文坚持以清单形式呈现的原因。

仍需明确的未知项

  • whether SDK defaults hide the real value sent
  • whether server and client clocks diverge under load
  • whether the venue treats duplicate ids as reject, replace or old-order lookup
  • whether subaccounts share hidden quotas
  • whether partial fill creates residual exposure
  • whether account-specific behavior differs from public documentation

实用结论

NexuAlpha 雷达把 request freshness 视为披露字段,而不是隐藏实现细节。Binance 文档暴露 signed-request security 与 response weight headers;OKX 文档说明 expTime 与 rate-limit code 50011;Kraken 支持文档说明 authenticated Spot REST calls 需要 nonce;Coinbase Advanced Trade 文档把 programmatic order management 放在 REST 与 WebSocket 表面中。实用雷达输出是一张表:平台是否说明 deadline、nonce 或 timestamp;是否暴露 client order identity;是否发布 rate-limit ownership;集成是否在重试前证明 final order state。 本文停在证据边界内,帮助读者决定下一步核验什么,而不是把公开文档改写成私人账户、钱包、API key、池子路径、稳定币余额、代币化资产或政策框架在任何未来条件下都能成功的承诺。

来源与证据

04
  1. Binance Developer DocsGeneral REST API Information
  2. OKX Technical DocumentationOKX API guide · okx.com
  3. Kraken SupportWhat is a nonce? · support.kraken.com
  4. Coinbase Developer PlatformAdvanced Trade API overview