메뉴
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.
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 API v1. Use when handling spot API errors or building rate-aware clients.
| name | aster-api-websocket-v3 |
| description | 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. |
Base: wss://fstream.asterdex.com. Raw: /ws/<streamName>. Combined: /stream?streams=name1/name2/... → {"stream":"<name>","data":<payload>}. Stream names lowercase (e.g. btcusdt).
Limits: 24h; ping 5 min → pong within 15 min; 10 msg/s; max 200 streams.
JSON: Subscribe {"method":"SUBSCRIBE","params":["btcusdt@aggTrade","btcusdt@depth"],"id":1} → {"result":null,"id":1}. Unsubscribe: UNSUBSCRIBE + params. List: LIST_SUBSCRIPTIONS. id = unsigned int.
| Stream | Description |
|---|---|
<symbol>@aggTrade | Aggregate trades (100ms) |
<symbol>@depth | Diff. book depth (250/500/100ms: @depth@500ms, @depth@100ms) |
<symbol>@depth5, @depth10, @depth20 | Partial book depth |
<symbol>@kline_<interval> | Kline (e.g. 1m, 1h); interval as in REST |
<symbol>@markPrice, <symbol>@markPrice@1s | Mark price (3s or 1s) |
!markPrice@arr, !markPrice@arr@1s | All symbols mark price |
<symbol>@miniTicker | 24h mini ticker (500ms) |
!miniTicker@arr | All mini tickers (1000ms) |
<symbol>@ticker | 24h ticker (500ms) |
!ticker@arr | All tickers (1000ms) |
<symbol>@bookTicker | Best bid/ask (real-time) |
!bookTicker | All book tickers |
<symbol>@forceOrder | Liquidation snapshot (1000ms) |
!forceOrder@arr | All liquidations |
POST /fapi/v3/listenKey (signed) → { "listenKey": "..." }. If account already has active listenKey, same key returned and validity extended 60 min.wss://fstream.asterdex.com/ws/<listenKey>.PUT /fapi/v3/listenKey (signed) at least every <60 min (e.g. every 30 min).DELETE /fapi/v3/listenKey (signed).User data events are not guaranteed in order during heavy load; order updates by event time E.
Events: ACCOUNT_UPDATE (balance/position), ORDER_TRADE_UPDATE, ACCOUNT_CONFIG_UPDATE (leverage, multi-asset, position mode), MARGIN_CALL, listenKeyExpired.
btcusdt@depth (or combined).GET /fapi/v3/depth?symbol=BTCUSDT&limit=1000.u < snapshot lastUpdateId.U ≤ lastUpdateId and u ≥ lastUpdateId.pu must equal previous event’s u; else re-sync from step 3.Payload shapes: reference.md.