aster-api-errors-v3
Aster API Errors
Payload: { "code": -1121, "msg": "..." }. Handle by code (stable); messages may vary.
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.
Security: -1021 INVALID_TIMESTAMP → recvWindow or clock; use GET /fapi/v3/time. -1022 INVALID_SIGNATURE → check signing/API wallet key.
| Range | Category | Examples |
|---|---|---|
| 10xx | Server/network | -1000, -1001, -1003, -1007, -1015, -1021, -1022 |
| 11xx | Request/params | -1102, -1121, -1130 |
| 20xx | Processing | -2010, -2011, -2013, -2018, -2019, -2021, -2025 |
| 40xx | Filters | -4004, -4014, -4023, -4047, -4048, -4164 |
HTTP: 4XX = client (403 WAF, 429, 418); 5XX = server. 503 = may have been processed—do not assume failure.
Payload shapes: reference.md.
More from asterdex/aster-skills-hub
aster-api-websocket-v3
WebSocket market + user data streams for Aster Futures API v3. Subscription model, stream names, listenKey. Use when implementing real-time market or user events (orders, balance, positions). listenKey = signed; see aster-api-auth-v3.
24aster-api-websocket-v1
WebSocket market + user data streams for Aster Futures API v1. Subscription model, stream names, listenKey (/fapi/v1/listenKey). Use when implementing real-time market or user events (orders, balance, positions). listenKey = signed; see aster-api-auth-v1.
23aster-api-trading-v3
Place, cancel, batch, and query orders for Aster Futures API v3 (/fapi/v3/). Use when placing/canceling orders or querying open/historical. Signed; see aster-api-auth-v3.
23aster-deposit-fund
Deposit funds to Aster from a wallet; private key from env. Use when the user wants to deposit to Aster or fund an Aster account.
23aster-api-auth-v3
EIP-712 signed requests for Aster Futures API v3. Nonce, signature payload, request format. Use when calling TRADE, USER_DATA, USER_STREAM, or MARKET_DATA.
23aster-api-market-data-v3
Public REST market data for Aster Futures API v3. Ping, time, exchangeInfo, depth, trades, klines, tickers, funding. Use when fetching market data. No auth.
22