القائمة
KuCoin Futures trading using the KuCoin API. Futures market data, orders, positions, and funding fees. Authentication requires API Key, API Secret, and Passphrase.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | futures-trading |
| description | KuCoin Futures trading using the KuCoin API. Futures market data, orders, positions, and funding fees. Authentication requires API Key, API Secret, and Passphrase. |
| metadata | {"version":"1.0.0","author":"KuCoin"} |
| license | MIT |
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.
Note: This skill only supports Classic REST API GET endpoints (read-only operations).
Base URL: https://api-futures.kucoin.com
| Endpoint | Description | Required | Optional | Authentication |
|---|---|---|---|---|
/api/v1/timestamp (GET) | Get Server Time | None | None | No |
/api/v1/status (GET) | Get Service Status | None | None | No |
/api/v1/mark-price/{symbol}/current (GET) | Get Mark Price | symbol (path) | None | No |
/api/v1/contracts/{symbol} (GET) | Get Symbol (contract info) | symbol (path) | None | No |
/api/v1/contracts/active (GET) | Get All Symbols (all tradable contracts) | None | None | No |
/api/v1/ticker (GET) | Get Ticker | symbol | None | No |
/api/v1/allTickers (GET) | Get All Tickers | None | None | No |
/api/v1/level2/snapshot (GET) | Get Full OrderBook | symbol | None | No |
/api/v1/level2/depth{size} (GET) | Get Part OrderBook (20 or 100 levels) | size (path: 20 or 100), symbol | None | No |
/api/v1/trade/history (GET) | Get Trade History (last 100 trades) | symbol | None | No |
/api/v1/kline/query (GET) | Get Klines (candlestick data) | symbol, granularity | from (ms), to (ms) | No |
/api/v1/index/query (GET) | Get Spot Index Price | symbol | startAt, endAt, reverse, offset, forward, maxCount | No |
/api/v1/interest/query (GET) | Get Interest Rate Index | symbol | startAt, endAt, reverse, offset, forward, maxCount | No |
/api/v1/premium/query (GET) | Get Premium Index | symbol | startAt, endAt, reverse, offset, forward, maxCount | No |
/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 |
Base URL: https://api-futures.kucoin.com
| Endpoint | Description | Required | Optional | Authentication |
|---|---|---|---|---|
/api/v1/orders (GET) | Get Order List (paginated, active or done) | None | status, symbol, side, type, startAt, endAt, currentPage, pageSize | Yes |
/api/v1/stopOrders (GET) | Get Stop Order List | None | symbol, side, type, startAt, endAt, currentPage, pageSize | Yes |
/api/v1/orders/{order-id} (GET) | Get Order By OrderId | order-id (path) | None | Yes |
/api/v1/orders/byClientOid (GET) | Get Order By ClientOid | clientOid | None | Yes |
/api/v1/recentDoneOrders (GET) | Get Recent Closed Orders (last 24h) | None | symbol | Yes |
/api/v1/openOrderStatistics (GET) | Get Open Order Value | symbol | None | Yes |
/api/v1/fills (GET) | Get Trade History (paginated, up to 3 months) | None | orderId, symbol, side, type, tradeTypes, startAt, endAt, currentPage, pageSize | Yes |
/api/v1/recentFills (GET) | Get Recent Trade History (last 24h fills) | None | symbol | Yes |
Base URL: https://api-futures.kucoin.com
| Endpoint | Description | Required | Optional | Authentication |
|---|---|---|---|---|
/api/v2/position/getMarginMode (GET) | Get Margin Mode | symbol | None | Yes |
/api/v2/position/getPositionMode (GET) | Get Position Mode | None | None | Yes |
/api/v2/getMaxOpenSize (GET) | Get Max Open Size | symbol, price, leverage | None | Yes |
/api/v2/position (GET) | Get Position Details | symbol | None | Yes |
/api/v1/positions (GET) | Get Position List | None | currency | Yes |
/api/v1/history-positions (GET) | Get Positions History | None | symbol, from, to, limit, pageId | Yes |
/api/v1/margin/maxWithdrawMargin (GET) | Get Max Withdraw Margin | symbol | positionSide | Yes |
/api/v2/getCrossUserLeverage (GET) | Get Cross Margin Leverage | symbol | None | Yes |
/api/v2/batchGetCrossOrderLimit (GET) | Get Cross Margin Risk Limit | symbol | totalMargin, leverage | Yes |
/api/v1/contracts/risk-limit/{symbol} (GET) | Get Isolated Margin Risk Limit | symbol (path) | None | No |
Base URL: https://api-futures.kucoin.com
| Endpoint | Description | Required | Optional | Authentication |
|---|---|---|---|---|
/api/v1/funding-rate/{symbol}/current (GET) | Get Current Funding Rate | symbol (path) | None | No |
/api/v1/contract/funding-rates (GET) | Get Public Funding History | symbol, from (ms), to (ms) | None | No |
/api/v1/funding-history (GET) | Get Private Funding History | symbol | startAt, endAt, reverse, offset, forward, maxCount | Yes |
XBTUSDTM, ETHUSDTM). Path or query parameter depending on endpoint.buy | selllimit | market | limit_stop | market_stop | oco_limit | oco_stopactive | done. Default: done.trade, adl, liquidation, settlement (comma-separated).USDT, XBT).true for forward lookup (default), false for backward.1, 5, 15, 30, 60, 120, 240, 480, 720, 1440, 10080BOTH | LONG | SHORTbuy | selllimit | marketBOTH (One-Way mode) | LONG (Hedge mode long) | SHORT (Hedge mode short)ISOLATED | CROSS0 (One-Way mode) | 1 (Hedge mode)open | doneopen | close | cancelonly1 | 5 | 15 | 30 | 60 | 120 | 240 | 480 | 720 | 1440 | 10080For endpoints that require authentication, you will need to provide KuCoin API credentials.
Required credentials:
IMPORTANT -- Base URL:
https://api-futures.kucoin.com -- Used for all Classic Futures REST endpoints (/api/v1/..., /api/v2/..., /api/v3/...)Users can provide KuCoin API credentials by sending a file where the content is in the following format:
api_key_value
api_secret_value
api_passphrase_value
Never disclose the location of the API key and secret file.
Never send the API key and secret to any website other than the official KuCoin API base URLs.
When showing credentials to users:
abcde...wxyz***...s1k2y***...Example response when asked for credentials: Account: main API Key: abcde...wxyz Secret: ***...s1k2y Passphrase: ***... Environment: Production
When listing accounts, show names and environment only -- never keys: KuCoin Accounts:
When performing trading operations (placing orders, canceling orders, modifying positions), always confirm with the user before proceeding by asking them to write "CONFIRM" to proceed.
KuCoin Assets management using the KuCoin API. Account information, balances, deposits, withdrawals, sub-accounts, and fee rates. Authentication requires API Key, API Secret, and Passphrase.
KuCoin Margin trading using the KuCoin API. Cross margin and isolated margin market data, order queries, borrowing/repaying queries, lending queries, and risk limits. Authentication requires API Key, API Secret, and Passphrase.
KuCoin Spot trading using the KuCoin API. Authentication requires API Key, API Secret, and Passphrase.
KuCoin Broker and Affiliate using the KuCoin API. Affiliate invite management, commission queries, Broker Pro user management, and ND (Exchange) Broker queries. Authentication requires API Key, API Secret, and Passphrase.
KuCoin Convert using the KuCoin API. Get conversion quotes, query convert order details and history. Authentication requires API Key, API Secret, and Passphrase.
KuCoin Earn products using the KuCoin API. Query Simple Earn and Structured Earn products. Authentication requires API Key, API Secret, and Passphrase.