$npx -y skills add asterdex/aster-skills-hub --skill aster-api-spot-trading-v3Place, cancel, and query spot orders for Aster Spot Testnet API v3 (/api/v3/). Use when placing/canceling spot testnet orders or querying open/historical. Signed; see aster-api-spot-auth-v3.
| 1 | # Aster Spot API Trading (v3 — Testnet) |
| 2 | |
| 3 | **Base:** https://sapi.asterdex-testnet.com. Signed (TRADE/USER_DATA). POST/DELETE: body application/x-www-form-urlencoded. |
| 4 | |
| 5 | ## New order |
| 6 | |
| 7 | **POST /api/v3/order** (W: 1) |
| 8 | |
| 9 | | Parameter | Req | Notes | |
| 10 | |-----------|-----|--------| |
| 11 | | symbol, side, type | Y | side: BUY/SELL; type → see below | |
| 12 | | timeInForce | N | GTC, IOC, FOK, GTX | |
| 13 | | quantity, quoteOrderQty | N | MARKET BUY: quantity or quoteOrderQty; MARKET SELL: quantity | |
| 14 | | price, stopPrice | N | stopPrice for STOP*, TAKE_PROFIT* | |
| 15 | | newClientOrderId | N | Unique client order ID | |
| 16 | |
| 17 | **Type-specific required:** LIMIT → timeInForce, quantity, price. MARKET → quantity or quoteOrderQty (BUY). STOP/TAKE_PROFIT → quantity, price, stopPrice. STOP_MARKET/TAKE_PROFIT_MARKET → quantity, stopPrice. |
| 18 | |
| 19 | **Order types:** LIMIT, MARKET, STOP, TAKE_PROFIT, STOP_MARKET, TAKE_PROFIT_MARKET. |
| 20 | |
| 21 | ## Cancel / Query |
| 22 | |
| 23 | - **DELETE /api/v3/order** (W: 1): symbol + orderId or origClientOrderId. |
| 24 | - **GET /api/v3/order** (W: 1): symbol + orderId or origClientOrderId. |
| 25 | - **GET /api/v3/openOrders** (W: 1 or 40): symbol optional; no symbol = all (40). |
| 26 | - **DELETE /api/v3/allOpenOrders** (W: 1): symbol (required); optional orderIdList or origClientOrderIdList for batch cancel. |
| 27 | - **GET /api/v3/allOrders** (W: 5): symbol req.; orderId, startTime, endTime, limit (500 default, 1000 max). Max range 7 days. |
| 28 | |
| 29 | No POST batchOrders (create); batch cancel via allOpenOrders with list params. |
| 30 | |
| 31 | Payload shapes: [reference.md](reference.md). |