What problem does it solve?
Provides definitive guidance to interpret Aster Futures v3 API error responses and rate-limit signals so clients can make correct retry, backoff, or fail decisions and avoid account/IP bans.
Core Features & Use Cases
- Error classification: Map JSON payloads like { "code": -1121, "msg": "..." } to stable numeric codes and categories (10xx, 11xx, 20xx, 40xx) for deterministic handling.
- Rate-limit handling: Explain REQUEST_WEIGHT (per IP) and ORDERS (per account) semantics, relevant headers X-MBX-USED-WEIGHT-* and X-MBX-ORDER-COUNT-*, and strategies for backing off on HTTP 429 and detecting HTTP 418 IP bans.
- Security & reliability: Identify signature/timestamp failures (-1022, -1021), note that 503 may indicate a processed request, and recommend preferring WebSocket or throttling REST calls to reduce REST load.
- Use case: Build resilient REST/WebSocket clients and SDK wrappers that parse error codes, apply exponential backoff, surface actionable diagnostics, and avoid triggering rate-limit bans.
Quick Start
Use the aster-api-errors-v3 guidance to interpret an Aster Futures API error payload and return the recommended retry/backoff or fail action.