加密 API 有效截止时间与重试重放披露雷达
已验证事实边界
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.
收起完整分析
决策矩阵
文章表格:可横向滑动,或聚焦表格区域后使用方向键。
| Check | What it means | Practical action | Unknown to keep explicit |
|---|---|---|---|
| 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 |
| 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 |
| 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 |
| Rate-limit owner | limits may be IP, User ID, connection or endpoint specific | partition workers by documented limit owner | whether subaccounts share hidden quotas |
| 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 |
| 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 |
来源地图
- 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、池子路径、稳定币余额、代币化资产或政策框架在任何未来条件下都能成功的承诺。
相关专题与工具:交易所 API 与行情数据核查
来源与证据
04- General REST API Information
- OKX API guide · okx.com
- What is a nonce? · support.kraken.com
- Advanced Trade API overview