$npx -y skills add asterdex/aster-skills-hub --skill aster-api-errors-v3Error codes, rate limits, 429/418 handling, retry/backoff for Aster Futures API v3. Use when handling API errors or building rate-aware clients.
| 1 | # Aster API Errors |
| 2 | |
| 3 | **Payload:** `{ "code": -1121, "msg": "..." }`. Handle by **code** (stable); messages may vary. |
| 4 | |
| 5 | **Rate limits:** From GET /fapi/v3/exchangeInfo → rateLimits. **REQUEST_WEIGHT:** per IP (e.g. 2400/min); header `X-MBX-USED-WEIGHT-*`. **ORDERS:** per account (e.g. 1200/min); header `X-MBX-ORDER-COUNT-*`. **429:** back off. **418:** IP banned (2 min–3 days). Prefer WebSocket to reduce REST load. |
| 6 | |
| 7 | **Security:** -1021 INVALID_TIMESTAMP → recvWindow or clock; use GET /fapi/v3/time. -1022 INVALID_SIGNATURE → check signing/API wallet key. |
| 8 | |
| 9 | | Range | Category | Examples | |
| 10 | |-------|----------|----------| |
| 11 | | 10xx | Server/network | -1000, -1001, -1003, -1007, -1015, -1021, -1022 | |
| 12 | | 11xx | Request/params | -1102, -1121, -1130 | |
| 13 | | 20xx | Processing | -2010, -2011, -2013, -2018, -2019, -2021, -2025 | |
| 14 | | 40xx | Filters | -4004, -4014, -4023, -4047, -4048, -4164 | |
| 15 | |
| 16 | **HTTP:** 4XX = client (403 WAF, 429, 418); 5XX = server. 503 = may have been processed—do not assume failure. |
| 17 | |
| 18 | Payload shapes: [reference.md](reference.md). |