skills/aster-api-websocket-v3/SKILL.md
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.
npx skillsauth add asterdex/aster-skills-hub aster-api-websocket-v3Install this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
tools
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.
development
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.
development
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.
development
Place, cancel, batch, countdown-cancel, and query orders for Aster Futures API v1 (/fapi/v1/). Use when placing/canceling orders or querying open/historical. Signed; see aster-api-auth-v1.