aster-api-errors-v3

Parse Aster Futures v3 API error codes and rate-limit headers for retry decisions.

3|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/Pieverse-Eng/purrfect-skills --skill aster-api-errors-v3-pieverse-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aster-api-errors-v3
Source: https://github.com/Pieverse-Eng/purrfect-skills/tree/main/aster/vendor/futures-errors
Command: npx skills add https://github.com/Pieverse-Eng/purrfect-skills --skill aster-api-errors-v3-pieverse-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about aster-api-errors-v3

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle Aster Futures API error codes in my client?

To handle Aster Futures API error codes, parse JSON payloads by numeric code and map them to stable categories like 10xx, 11xx, 20xx, and 40xx for deterministic retry or fail decisions. This prevents unexpected crashes when interpreting v3 API responses.

What should I do when Aster Futures API returns HTTP 429 or 418?

When Aster Futures API returns HTTP 429, apply exponential backoff to reduce request weight. If you receive HTTP 418, your IP has been banned due to repeated rate limit violations, requiring a pause in traffic until the ban lifts.

How do X-MBX-USED-WEIGHT and X-MBX-ORDER-COUNT headers work for rate limits?

X-MBX-USED-WEIGHT and X-MBX-ORDER-COUNT headers track REQUEST_WEIGHT per IP and ORDERS per account respectively. Monitoring these headers lets clients throttle REST calls proactively and avoid hitting Aster Futures rate limits.

Why does my Aster Futures API request fail with error -1022 or -1021?

Aster Futures API error -1022 indicates a signature failure, while -1021 signals a timestamp issue, often caused by clock drift. Correcting your HMAC signature and synchronizing server time resolves these reliability failures.

Does Aster Futures API return 503 when a request is actually processed?

Yes, an HTTP 503 from Aster Futures API may indicate that the request was actually processed despite the error. Clients should treat 503 cautiously and verify state before blindly retrying the operation to avoid duplicates.

What is the best way to reduce REST rate limit pressure on Aster Futures API?

To reduce REST rate limit pressure on Aster Futures API, prefer using WebSocket streams for market data and throttle REST calls. This lowers request weight and helps avoid triggering HTTP 429 bans.