Исследование с проверкой источников: Binance SPOT API RATE
Текст статьи показан в проверенном английском оригинале. Перевод будет добавлен после проверки источников.
Verified Fact Boundary
1. Binance WebSocket API documentation says a single connection is valid for 24 hours and users should expect disconnection after that mark. 2. Binance WebSocket API documentation says rate limit status can appear in the optional rateLimits field and includes REQUEST_WEIGHT and ORDERS limit types. 3. Binance WebSocket API documentation says requests fail with status 429 when unfilled order count or request rate limits are violated. 4. Binance WebSocket API documentation says repeated rate-limit violations can result in status 418 auto-bans. 5. Binance unfilled-order-count documentation says successful new orders increment unfilled order count while rejected or unsuccessful orders are not guaranteed to do so.
Свернуть
Decision Matrix
Таблица статьи: прокрутите по горизонтали или установите фокус на области таблицы и используйте клавиши со стрелками.
| Check | What it means | Practical action | Unknown to keep explicit |
|---|---|---|---|
| Connection lifetime | a WebSocket API session that should be renewed before or after the 24-hour window | schedule reconnects and preserve state before expiry | server-side maintenance timing |
| Ping and pong | heartbeat behavior that decides whether a connection remains live | reply promptly and monitor missed pongs | network jitter |
| REQUEST_WEIGHT | request budget across interval windows | record weight counts per bot and per IP | shared IP consumers |
| ORDERS | order-rate and unfilled-order pressure | separate order pacing from data polling | venue-side count recovery |
| 429 response | rate limit exceeded | back off and stop retry loops | partial state after timeout |
| 418 auto-ban | repeated violation consequence | treat as incident and halt bot traffic | ban duration |
| Request ID | correlation between request and response | use unique IDs for concurrent calls | duplicate replay confusion |
| 5xx timeout | execution status may be unknown | query order state before resubmitting | matching-engine outcome |
| API keys | HMAC, RSA or Ed25519 signing boundary | store keys outside content and logs | key-permission drift |
| Real-balance gate | when to allow production order flow | require dry-run evidence and kill switch | market stress behavior |
Source Map
- Binance Developer Docs: General WebSocket API Information (binance-ws-api)
- Binance Developer Docs: Spot Unfilled Order Count Rules (binance-order-count)
- Binance Developer Docs: Spot REST API (binance-rest-api)
- Binance: Terms of Use (binance-terms)
Control Notes
1. Connection lifetime
Connection lifetime is the part of the decision where the reader must turn a public source into an operating rule. In this package, it means a WebSocket API session that should be renewed before or after the 24-hour window. The useful action is to schedule reconnects and preserve state before expiry. The unresolved edge is server-side maintenance timing, so this article does not convert that uncertainty into a promise, ranking, reward, approval, safety claim or future-availability claim.
For an operator, connection lifetime should be recorded before funds, account access, wallet recovery, API order flow, whitelist changes, cross-chain transfers or tokenized-asset decisions become material. The record can stay simple: the official source URL, the date checked, the product or network under review, and a non-secret note describing why the next step is acceptable. Screenshots should avoid balances, identity documents, API keys, recovery phrases, private keys, passphrases, verification codes and support-ticket private data.
2. Ping and pong
Ping and pong is the part of the decision where the reader must turn a public source into an operating rule. In this package, it means heartbeat behavior that decides whether a connection remains live. The useful action is to reply promptly and monitor missed pongs. The unresolved edge is network jitter, so this article does not convert that uncertainty into a promise, ranking, reward, approval, safety claim or future-availability claim.
For an operator, ping and pong should be recorded before funds, account access, wallet recovery, API order flow, whitelist changes, cross-chain transfers or tokenized-asset decisions become material.
3. REQUEST_WEIGHT
REQUEST_WEIGHT is the part of the decision where the reader must turn a public source into an operating rule. In this package, it means request budget across interval windows. The useful action is to record weight counts per bot and per IP. The unresolved edge is shared IP consumers, so this article does not convert that uncertainty into a promise, ranking, reward, approval, safety claim or future-availability claim.
For an operator, request_weight should be recorded before funds, account access, wallet recovery, API order flow, whitelist changes, cross-chain transfers or tokenized-asset decisions become material.
4. ORDERS
ORDERS is the part of the decision where the reader must turn a public source into an operating rule. In this package, it means order-rate and unfilled-order pressure. The useful action is to separate order pacing from data polling. The unresolved edge is venue-side count recovery, so this article does not convert that uncertainty into a promise, ranking, reward, approval, safety claim or future-availability claim.
For an operator, orders should be recorded before funds, account access, wallet recovery, API order flow, whitelist changes, cross-chain transfers or tokenized-asset decisions become material.
5. 429 response
429 response is the part of the decision where the reader must turn a public source into an operating rule. In this package, it means rate limit exceeded. The useful action is to back off and stop retry loops. The unresolved edge is partial state after timeout, so this article does not convert that uncertainty into a promise, ranking, reward, approval, safety claim or future-availability claim.
For an operator, 429 response should be recorded before funds, account access, wallet recovery, API order flow, whitelist changes, cross-chain transfers or tokenized-asset decisions become material.
6. 418 auto-ban
418 auto-ban is the part of the decision where the reader must turn a public source into an operating rule. In this package, it means repeated violation consequence. The useful action is to treat as incident and halt bot traffic. The unresolved edge is ban duration, so this article does not convert that uncertainty into a promise, ranking, reward, approval, safety claim or future-availability claim.
For an operator, 418 auto-ban should be recorded before funds, account access, wallet recovery, API order flow, whitelist changes, cross-chain transfers or tokenized-asset decisions become material.
7. Request ID
Request ID is the part of the decision where the reader must turn a public source into an operating rule. In this package, it means correlation between request and response. The useful action is to use unique IDs for concurrent calls. The unresolved edge is duplicate replay confusion, so this article does not convert that uncertainty into a promise, ranking, reward, approval, safety claim or future-availability claim.
For an operator, request id should be recorded before funds, account access, wallet recovery, API order flow, whitelist changes, cross-chain transfers or tokenized-asset decisions become material.
8. 5xx timeout
5xx timeout is the part of the decision where the reader must turn a public source into an operating rule. In this package, it means execution status may be unknown. The useful action is to query order state before resubmitting. The unresolved edge is matching-engine outcome, so this article does not convert that uncertainty into a promise, ranking, reward, approval, safety claim or future-availability claim.
For an operator, 5xx timeout should be recorded before funds, account access, wallet recovery, API order flow, whitelist changes, cross-chain transfers or tokenized-asset decisions become material.
9. API keys
API keys is the part of the decision where the reader must turn a public source into an operating rule. In this package, it means HMAC, RSA or Ed25519 signing boundary. The useful action is to store keys outside content and logs. The unresolved edge is key-permission drift, so this article does not convert that uncertainty into a promise, ranking, reward, approval, safety claim or future-availability claim.
For an operator, api keys should be recorded before funds, account access, wallet recovery, API order flow, whitelist changes, cross-chain transfers or tokenized-asset decisions become material.
10. Real-balance gate
Real-balance gate is the part of the decision where the reader must turn a public source into an operating rule. In this package, it means when to allow production order flow. The useful action is to require dry-run evidence and kill switch. The unresolved edge is market stress behavior, so this article does not convert that uncertainty into a promise, ranking, reward, approval, safety claim or future-availability claim.
For an operator, real-balance gate should be recorded before funds, account access, wallet recovery, API order flow, whitelist changes, cross-chain transfers or tokenized-asset decisions become material.
Known Unknowns
- server-side maintenance timing
- network jitter
- shared IP consumers
- venue-side count recovery
- partial state after timeout
- ban duration
- duplicate replay confusion
- matching-engine outcome
- key-permission drift
- market stress behavior
Practical Takeaway
The safest version of this article is the one that stays boring and exact. Binance Spot API integration risk is not only an API-key problem. Binance developer documentation says the WebSocket API uses a 24-hour connection validity window, server ping/pong handling, request IDs, optional rate-limit fields, multiple rate-limit intervals, 429 responses for exceeded request or unfilled-order limits, and 418 auto-bans for repeated limit violations. Its unfilled-order-count FAQ adds that successful new orders can increment order count and that rejected or unsuccessful orders are not guaranteed to have the same effect. The operational decision is to track REQUEST_WEIGHT, ORDERS, connection lifecycle and order-state reconciliation before a bot is allowed to trade real balances. The user outcome is a clearer next inspection step, not a promise that a platform, API, transfer route or tokenized asset will work under every future condition.
Темы и инструменты:API бирж и рыночные данные
Источники
04- General WebSocket API Information · developers.binance.com
- Spot Unfilled Order Count Rules · developers.binance.com
- Spot REST API · developers.binance.com
- Terms of Use · binance.com