skills/aster-api-trading-v3/SKILL.md
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.
npx skillsauth add asterdex/aster-skills-hub aster-api-trading-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: https://fapi.asterdex.com. Signed (TRADE/USER_DATA). POST/DELETE: body application/x-www-form-urlencoded.
POST /fapi/v3/order (Weight: 1)
| Parameter | Req | Notes |
|-----------|-----|--------|
| symbol, side, type | Y | side: BUY/SELL; type → see below |
| positionSide | N | BOTH or LONG/SHORT (hedge); req. in Hedge Mode |
| timeInForce | N | GTC, IOC, FOK, GTX |
| quantity, reduceOnly | N | Not with closePosition; reduceOnly not in hedge |
| price, stopPrice | N | stopPrice for STOP*/TAKE_PROFIT* |
| closePosition | N | STOP_MARKET/TAKE_PROFIT_MARKET only; no quantity/reduceOnly |
| activationPrice, callbackRate | N | TRAILING_STOP_MARKET; callbackRate 0.1–5 (1=1%) |
| workingType, priceProtect | N | MARK_PRICE/CONTRACT_PRICE; "TRUE"/"FALSE" |
| newClientOrderId | N | Unique; ^[\.A-Z\:/a-z0-9_-]{1,36}$ |
| newOrderRespType | N | ACK (default), RESULT |
Type-specific required: LIMIT → timeInForce, quantity, price. MARKET → quantity. STOP/TAKE_PROFIT → quantity, price, stopPrice. STOP_MARKET/TAKE_PROFIT_MARKET → stopPrice. TRAILING_STOP_MARKET → callbackRate.
Trigger rules: STOP/STOP_MARKET: BUY → latest ≥ stopPrice; SELL → latest ≤ stopPrice. TAKE_PROFIT/TAKE_PROFIT_MARKET: opposite. TRAILING_STOP_MARKET: BUY → low ≤ activationPrice and latest ≥ low×(1+callbackRate); SELL → high ≥ activationPrice and latest ≤ high×(1-callbackRate). activationPrice: BUY < latest, SELL > latest (else -2021). closePosition=true: close all long (SELL) or short (BUY); hedge: no BUY for LONG / SELL for SHORT.
batchOrders max 5; responses match order.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 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.
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, 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.