$npx -y skills add Kucoin/kucoin-skills-hub --skill futures-tradingKuCoin Futures trading using the KuCoin API. Futures market data, orders, positions, and funding fees. Authentication requires API Key, API Secret, and Passphrase.
| 1 | # KuCoin Futures Trading Skill |
| 2 | |
| 3 | Futures trading on KuCoin using authenticated and public API endpoints. Requires API Key, API Secret, and Passphrase for authenticated endpoints. Return the result in JSON format. |
| 4 | |
| 5 | > **Note:** This skill only supports Classic REST API GET endpoints (read-only operations). |
| 6 | |
| 7 | ## Quick Reference |
| 8 | |
| 9 | ### Classic Futures -- Market Data |
| 10 | |
| 11 | Base URL: `https://api-futures.kucoin.com` |
| 12 | |
| 13 | | Endpoint | Description | Required | Optional | Authentication | |
| 14 | |----------|-------------|----------|----------|----------------| |
| 15 | | `/api/v1/timestamp` (GET) | Get Server Time | None | None | No | |
| 16 | | `/api/v1/status` (GET) | Get Service Status | None | None | No | |
| 17 | | `/api/v1/mark-price/{symbol}/current` (GET) | Get Mark Price | symbol (path) | None | No | |
| 18 | | `/api/v1/contracts/{symbol}` (GET) | Get Symbol (contract info) | symbol (path) | None | No | |
| 19 | | `/api/v1/contracts/active` (GET) | Get All Symbols (all tradable contracts) | None | None | No | |
| 20 | | `/api/v1/ticker` (GET) | Get Ticker | symbol | None | No | |
| 21 | | `/api/v1/allTickers` (GET) | Get All Tickers | None | None | No | |
| 22 | | `/api/v1/level2/snapshot` (GET) | Get Full OrderBook | symbol | None | No | |
| 23 | | `/api/v1/level2/depth{size}` (GET) | Get Part OrderBook (20 or 100 levels) | size (path: 20 or 100), symbol | None | No | |
| 24 | | `/api/v1/trade/history` (GET) | Get Trade History (last 100 trades) | symbol | None | No | |
| 25 | | `/api/v1/kline/query` (GET) | Get Klines (candlestick data) | symbol, granularity | from (ms), to (ms) | No | |
| 26 | | `/api/v1/index/query` (GET) | Get Spot Index Price | symbol | startAt, endAt, reverse, offset, forward, maxCount | No | |
| 27 | | `/api/v1/interest/query` (GET) | Get Interest Rate Index | symbol | startAt, endAt, reverse, offset, forward, maxCount | No | |
| 28 | | `/api/v1/premium/query` (GET) | Get Premium Index | symbol | startAt, endAt, reverse, offset, forward, maxCount | No | |
| 29 | | `/api/v1/trade-statistics` (GET) | Get 24hr Stats (platform futures volume). **Must use Classic Futures base URL (`https://api-futures.kucoin.com`).** | None | None | Yes | |
| 30 | |
| 31 | ### Classic Futures -- Order Queries |
| 32 | |
| 33 | Base URL: `https://api-futures.kucoin.com` |
| 34 | |
| 35 | | Endpoint | Description | Required | Optional | Authentication | |
| 36 | |----------|-------------|----------|----------|----------------| |
| 37 | | `/api/v1/orders` (GET) | Get Order List (paginated, active or done) | None | status, symbol, side, type, startAt, endAt, currentPage, pageSize | Yes | |
| 38 | | `/api/v1/stopOrders` (GET) | Get Stop Order List | None | symbol, side, type, startAt, endAt, currentPage, pageSize | Yes | |
| 39 | | `/api/v1/orders/{order-id}` (GET) | Get Order By OrderId | order-id (path) | None | Yes | |
| 40 | | `/api/v1/orders/byClientOid` (GET) | Get Order By ClientOid | clientOid | None | Yes | |
| 41 | | `/api/v1/recentDoneOrders` (GET) | Get Recent Closed Orders (last 24h) | None | symbol | Yes | |
| 42 | | `/api/v1/openOrderStatistics` (GET) | Get Open Order Value | symbol | None | Yes | |
| 43 | | `/api/v1/fills` (GET) | Get Trade History (paginated, up to 3 months) | None | orderId, symbol, side, type, tradeTypes, startAt, endAt, currentPage, pageSize | Yes | |
| 44 | | `/api/v1/recentFills` (GET) | Get Recent Trade History (last 24h fills) | None | symbol | Yes | |
| 45 | |
| 46 | ### Classic Futures -- Position Queries |
| 47 | |
| 48 | Base URL: `https://api-futures.kucoin.com` |
| 49 | |
| 50 | | Endpoint | Description | Required | Optional | Authentication | |
| 51 | |----------|-------------|----------|----------|----------------| |
| 52 | | `/api/v2/position/getMarginMode` (GET) | Get Margin Mode | symbol | None | Yes | |
| 53 | | `/api/v2/position/getPositionMode` (GET) | Get Position Mode | None | None | Yes | |
| 54 | | `/api/v2/getMaxOpenSize` (GET) | Get Max Open Size | symbol, price, leverage | None | Yes | |
| 55 | | `/api/v2/position` (GET) | Get Position Details | symbol | None | Yes | |
| 56 | | `/api/v1/positions` (GET) | Get Position List | None | currency | Yes | |
| 57 | | `/api/v1/history-positions` (GET) | Get Positions History | None | symbol, from, to, limit, pageId | Yes | |
| 58 | | `/api/v1/margin/maxWithdrawMargin` (GET) | Get Max Withdraw Margin | symbol | positionSide | Yes | |
| 59 | | `/api/v2/getCrossUserLeverage` (GET) | Get Cross Margin Leverage | symbol | None | Yes | |
| 60 | | `/api/v2/batchGetCrossOrderLimit` (GET) | Get Cross Margin Risk Limit | symbol | totalMargin, leverage | Yes | |
| 61 | | `/api/v1/contracts/risk-limit/{symbol}` (GET) | Get Isolated Margin Risk Limit | symbol (path) | None | No | |
| 62 | |
| 63 | ### Classic Futures -- Funding Fees |
| 64 | |
| 65 | Base URL: `https://api-futures.kucoin.com` |
| 66 | |
| 67 | | Endpoint | Description | Required | Optional | Authentication | |
| 68 | |----------|-------------|----------|----------|----------------| |
| 69 | | `/api/v1/funding-rate/{symbol}/current` (GET) | Get Current Funding Rate | symbol (path) | None | No | |
| 70 | | `/api/v1/contract/funding-rates` (GET) | Get Public Funding History | symbol, from (ms), to (ms) |