$npx -y skills add Kucoin/kucoin-skills-hub --skill spotKuCoin Spot trading using the KuCoin API. Authentication requires API Key, API Secret, and Passphrase.
| 1 | # KuCoin Spot Skill |
| 2 | |
| 3 | Spot trading on KuCoin using authenticated 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 API - Spot Market Data |
| 10 | |
| 11 | | Endpoint | Description | Required | Optional | Authentication | |
| 12 | |----------|-------------|----------|----------|----------------| |
| 13 | | `/api/v3/announcements` (GET) | Get announcements | None | currentPage, pageSize, annType, lang, startTime, endTime | No | |
| 14 | | `/api/v3/currencies/{currency}` (GET) | Get currency detail | currency (path) | chain | No | |
| 15 | | `/api/v3/currencies` (GET) | Get all currencies | None | None | No | |
| 16 | | `/api/v2/symbols/{symbol}` (GET) | Get symbol detail | symbol (path) | None | No | |
| 17 | | `/api/v2/symbols` (GET) | Get all symbols | None | market | No | |
| 18 | | `/api/v1/market/orderbook/level1` (GET) | Get ticker (best bid/ask) | symbol | None | No | |
| 19 | | `/api/v1/market/allTickers` (GET) | Get all tickers | None | None | No | |
| 20 | | `/api/v1/market/histories` (GET) | Get trade history | symbol | None | No | |
| 21 | | `/api/v1/market/candles` (GET) | Get klines | symbol, type | startAt (sec), endAt (sec) | No | |
| 22 | | `/api/v1/market/orderbook/level2_{size}` (GET) | Get part orderbook | size (path: 20, 100), symbol | None | No | |
| 23 | | `/api/v3/market/orderbook/level2` (GET) | Get full orderbook | symbol | None | Yes | |
| 24 | | `/api/v1/market/orderbook/callauction/level2_{size}` (GET) | Get call auction part orderbook | size (path: 20, 100), symbol | None | No | |
| 25 | | `/api/v1/market/callauctionData` (GET) | Get call auction info | symbol | None | No | |
| 26 | | `/api/v1/prices` (GET) | Get fiat price | None | base, currencies | No | |
| 27 | | `/api/v1/market/stats` (GET) | Get 24hr stats | symbol | None | No | |
| 28 | | `/api/v1/markets` (GET) | Get market list | None | None | No | |
| 29 | |
| 30 | ### Classic API - Spot HF Order Queries |
| 31 | |
| 32 | | Endpoint | Description | Required | Optional | Authentication | |
| 33 | |----------|-------------|----------|----------|----------------| |
| 34 | | `/api/v1/hf/orders/{orderId}` (GET) | Get order by orderId | orderId (path), symbol | None | Yes | |
| 35 | | `/api/v1/hf/orders/client-order/{clientOid}` (GET) | Get order by clientOid | clientOid (path), symbol | None | Yes | |
| 36 | | `/api/v1/hf/orders/active/symbols` (GET) | Get symbols with open orders | None | None | Yes | |
| 37 | | `/api/v1/hf/orders/active` (GET) | Get open orders | symbol | None | Yes | |
| 38 | | `/api/v1/hf/orders/active/page` (GET) | Get open orders (paginated) | symbol | pageNum, pageSize | Yes | |
| 39 | | `/api/v1/hf/orders/done` (GET) | Get closed orders | symbol | side, type, lastId, limit, startAt, endAt | Yes | |
| 40 | | `/api/v1/hf/fills` (GET) | Get trade history | symbol | orderId, side, type, lastId, limit, startAt, endAt | Yes | |
| 41 | | `/api/v1/hf/orders/dead-cancel-all/query` (GET) | Get DCP settings | None | None | Yes | |
| 42 | |
| 43 | ### Classic API - Stop Order Queries |
| 44 | |
| 45 | | Endpoint | Description | Required | Optional | Authentication | |
| 46 | |----------|-------------|----------|----------|----------------| |
| 47 | | `/api/v1/stop-order` (GET) | Get stop orders list | None | symbol, side, type, tradeType, startAt, endAt, currentPage, orderIds, pageSize, stop | Yes | |
| 48 | | `/api/v1/stop-order/{orderId}` (GET) | Get stop order by orderId | orderId (path) | None | Yes | |
| 49 | | `/api/v1/stop-order/queryOrderByClientOid` (GET) | Get stop order by clientOid | clientOid | symbol | Yes | |
| 50 | |
| 51 | ### Classic API - OCO Order Queries |
| 52 | |
| 53 | | Endpoint | Description | Required | Optional | Authentication | |
| 54 | |----------|-------------|----------|----------|----------------| |
| 55 | | `/api/v3/oco/order/{orderId}` (GET) | Get OCO order by orderId | orderId (path) | None | Yes | |
| 56 | | `/api/v3/oco/client-order/{clientOid}` (GET) | Get OCO order by clientOid | clientOid (path) | None | Yes | |
| 57 | | `/api/v3/oco/orders` (GET) | Get OCO order list | None | symbol, startAt, endAt, orderIds, pageSize, currentPage | Yes | |
| 58 | | `/api/v3/oco/order/details/{orderId}` (GET) | Get OCO order detail by orderId | orderId (path) | None | Yes | |
| 59 | |
| 60 | --- |
| 61 | |
| 62 | ## Parameters |
| 63 | |
| 64 | ### Common Parameters |
| 65 | |
| 66 | * **symbol**: Trading pair (e.g., BTC-USDT) |
| 67 | * **currency**: Currency code (e.g., BTC, ETH, USDT) |
| 68 | * **orderId**: The unique order ID generated by the trading system |
| 69 | * **clientOid**: Client order ID, unique identifier created by the user (max 40 characters) |
| 70 | * **side**: Trade direction filter: buy | sell |
| 71 | * **type**: Order type filter: limit | market |
| 72 | * **startAt**: Start time. **Note:** For `/api/v1/market/candles`, use **seconds** (10-digit Unix timestamp). For other endpoints, use **milliseconds** (13-digit timestamp). |
| 73 | * **endAt**: End time. **Note:** For `/api/v1/market/candles`, use **seconds** (10-digit Unix timestamp). For other endpoints, use **milliseconds** (13-digit timestamp). |
| 74 | * **pageSize**: Number of items |