菜单
Error codes, rate limits, 429/418 handling for Aster Spot API v1. Use when handling spot API errors or building rate-aware clients.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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.
Account, balances, user trades, spot–futures transfer, withdraw, API key for Aster Spot API v1. Use when reading/updating spot account or transferring. Signed; see aster-api-spot-auth-v1.
Account, balances, user trades, spot–futures transfer, withdraw, API key for Aster Spot Testnet API v3. Use when reading/updating spot testnet account or transferring. Signed; see aster-api-spot-auth-v3.
HMAC SHA256 signed requests for Aster Spot API v1 (main). Base sapi.asterdex.com, /api/v1/. Use when calling TRADE, USER_DATA, or USER_STREAM. Signed; algorithm same as aster-api-auth-v1.
EIP-712 signed requests for Aster Spot Testnet API v3. Base sapi.asterdex-testnet.com, /api/v3/. Use when calling TRADE, USER_DATA, USER_STREAM, or MARKET_DATA on spot testnet. Algorithm same as aster-api-auth-v3.
Error codes, rate limits, 429/418 handling for Aster Spot Testnet API v3. Use when handling spot testnet API errors or building rate-aware clients.
| name | aster-api-spot-errors-v1 |
| description | Error codes, rate limits, 429/418 handling for Aster Spot API v1. Use when handling spot API errors or building rate-aware clients. |
Payload: { "code": -1121, "msg": "..." }. Handle by code (stable); messages may vary.
Rate limits: From GET /api/v1/exchangeInfo → rateLimits. REQUEST_WEIGHT: per IP (e.g. 1200/min); header X-MBX-USED-WEIGHT-*. ORDERS: per account (e.g. 100/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 /api/v1/time. -1022 INVALID_SIGNATURE → check HMAC/secret.
| Range | Category | Examples |
|---|---|---|
| 10xx | Server/network | -1000, -1001, -1003, -1021, -1022 |
| 11xx | Request/params | -1102, -1121, -1130 |
| 20xx | Processing | -2010, -2011, -2013, -2018, -2019, -2021 |
HTTP: 4XX = client (403 WAF, 429, 418); 5XX = server. 503 = may have been processed—do not assume failure.
Payload shapes: reference.md.
