关于 futures-trading
futures-trading 是用于查询 KuCoin Futures 的技能，可获取公开市场数据及经认证的账户信息。它仅支持 Classic REST API 的只读 GET 端点，并以 JSON 返回结果。
主要功能
- 01公开期货市场数据
- 02经认证的订单查询
- 03持仓与保证金查询
- 04资金费率及历史查询
- 05JSON 结果格式
适用场景
- 01查看期货价格和订单簿
- 02检查订单与成交记录
- 03查看持仓和保证金设置
- 04查询资金费率及历史
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/futures-trading确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
CHANGELOG.mdLICENSE.mdreferences/authentication.md详细介绍
KuCoin Futures 交易技能
使用经过身份验证的 API 端点和公共 API 端点在 KuCoin 上进行期货交易。经过身份验证的端点需要 API Key、API Secret 和 Passphrase。以 JSON 格式返回结果。
注意： 此技能仅支持 Classic REST API GET 端点（只读操作）。
快速参考
Classic Futures -- 市场数据
基础 URL：https://api-futures.kucoin.com
| 端点 | 说明 | 必填 | 可选 | 身份验证 |
|---|---|---|---|---|
/api/v1/timestamp (GET) | 获取服务器时间 | 无 | 无 | 否 |
/api/v1/status (GET) | 获取服务状态 | 无 | 无 | 否 |
/api/v1/mark-price/{symbol}/current (GET) | 获取标记价格 | symbol（路径） | 无 | 否 |
/api/v1/contracts/{symbol} (GET) | 获取交易对（合约信息） | symbol（路径） | 无 | 否 |
/api/v1/contracts/active (GET) | 获取所有交易对（所有可交易合约） | 无 | 无 | 否 |
/api/v1/ticker (GET) | 获取行情 | symbol | 无 | 否 |
/api/v1/allTickers (GET) | 获取所有行情 | 无 | 无 | 否 |
/api/v1/level2/snapshot (GET) | 获取完整订单簿 | symbol | 无 | 否 |
/api/v1/level2/depth{size} (GET) | 获取部分订单簿（20 或 100 档） | size（路径：20 或 100）、symbol | 无 | 否 |
/api/v1/trade/history (GET) | 获取交易历史（最近 100 笔交易） | symbol | 无 | 否 |
/api/v1/kline/query (GET) | 获取 K 线（蜡烛图数据） | symbol、granularity | from（毫秒）、to（毫秒） | 否 |
/api/v1/index/query (GET) | 获取现货指数价格 | symbol | startAt、endAt、reverse、offset、forward、maxCount | 否 |
/api/v1/interest/query (GET) | 获取利率指数 | symbol | startAt、endAt、reverse、offset、forward、maxCount | 否 |
/api/v1/premium/query (GET) | 获取溢价指数 | symbol | startAt、endAt、reverse、offset、forward、maxCount | 否 |
/api/v1/trade-statistics (GET) | 获取 24 小时统计数据（平台期货交易量）。必须使用 Classic Futures 基础 URL（https://api-futures.kucoin.com）。 | 无 | 无 | 是 |
Classic Futures -- 订单查询
基础 URL：https://api-futures.kucoin.com
| 端点 | 说明 | 必填 | 可选 | 身份验证 |
|---|---|---|---|---|
/api/v1/orders (GET) | 获取订单列表（分页，活动订单或已完成订单） | 无 | status、symbol、side、type、startAt、endAt、currentPage、pageSize | 是 |
/api/v1/stopOrders (GET) | 获取止损订单列表 | 无 | symbol、side、type、startAt、endAt、currentPage、pageSize | 是 |
/api/v1/orders/{order-id} (GET) | 按 OrderId 获取订单 | order-id（路径） | 无 | 是 |
/api/v1/orders/byClientOid (GET) | 按 ClientOid 获取订单 | clientOid | 无 | 是 |
/api/v1/recentDoneOrders (GET) | 获取最近的已关闭订单（过去 24 小时） | 无 | symbol | 是 |
/api/v1/openOrderStatistics (GET) | 获取未完成订单价值 | symbol | 无 | 是 |
/api/v1/fills (GET) | 获取交易历史（分页，最长 3 个月） | 无 | orderId、symbol、side、type、tradeTypes、startAt、endAt、currentPage、pageSize | 是 |
/api/v1/recentFills (GET) | 获取最近的交易历史（过去 24 小时的成交记录） | 无 | symbol | 是 |
经典合约 —— 持仓查询
基础 URL：https://api-futures.kucoin.com
| Endpoint | 描述 | 必需 | 可选 | 身份验证 |
|---|---|---|---|---|
/api/v2/position/getMarginMode (GET) | 获取保证金模式 | symbol | 无 | 是 |
/api/v2/position/getPositionMode (GET) | 获取持仓模式 | 无 | 无 | 是 |
/api/v2/getMaxOpenSize (GET) | 获取最大开仓量 | symbol, price, leverage | 无 | 是 |
/api/v2/position (GET) | 获取持仓详情 | symbol | 无 | 是 |
/api/v1/positions (GET) | 获取持仓列表 | 无 | currency | 是 |
/api/v1/history-positions (GET) | 获取历史持仓 | 无 | symbol, from, to, limit, pageId | 是 |
/api/v1/margin/maxWithdrawMargin (GET) | 获取最大可提取保证金 | symbol | positionSide | 是 |
/api/v2/getCrossUserLeverage (GET) | 获取全仓杠杆 | symbol | 无 | 是 |
/api/v2/batchGetCrossOrderLimit (GET) | 获取全仓风险限额 | symbol | totalMargin, leverage | 是 |
/api/v1/contracts/risk-limit/{symbol} (GET) | 获取逐仓风险限额 | symbol (path) | 无 | 否 |
经典合约 —— 资金费用
基础 URL：https://api-futures.kucoin.com
| Endpoint | 描述 | 必需 | 可选 | 身份验证 |
|---|---|---|---|---|
/api/v1/funding-rate/{symbol}/current (GET) | 获取当前资金费率 | symbol (path) | 无 | 否 |
/api/v1/contract/funding-rates (GET) | 获取公开资金费率历史 | symbol, from (ms), to (ms) | 无 | 否 |
/api/v1/funding-history (GET) | 获取私有资金费历史 | symbol | startAt, endAt, reverse, offset, forward, maxCount | 是 |
参数
常用参数
- symbol：合约代码（例如，
XBTUSDTM、ETHUSDTM）。根据 Endpoint 的不同，它是路径参数或查询参数。 - clientOid：用户定义的唯一订单 ID，最多 40 个字符。
- startAt / from：开始时间，单位为毫秒（13 位 Unix 时间戳）。
- endAt / to：结束时间，单位为毫秒（13 位 Unix 时间戳）。
- pageSize：每页记录数。默认值因 Endpoint 而异（通常为 50，最大为 200）。
- currentPage：分页查询的当前页码。默认值：1。
- side：订单方向筛选条件：
buy|sell - type：订单类型筛选条件：
limit|market|limit_stop|market_stop|oco_limit|oco_stop - status：订单列表的订单状态筛选条件：
active|done。默认值：done。 - tradeTypes：成交历史的交易类型筛选条件：
trade、adl、liquidation、settlement（以逗号分隔）。 - currency：币种代码筛选条件（例如，
USDT、XBT）。 - reverse：布尔值。反转结果顺序。
- offset：分页起始偏移量。
- forward：布尔值。
true表示向前查询（默认值），false表示向后查询。 - maxCount：每页显示数量。默认值为 50。
- granularity：K 线间隔（分钟）：
1、5、15、30、60、120、240、480、720、1440、10080 - positionSide：持仓方向筛选条件：
BOTH|LONG|SHORT - price：最大开仓量查询的价格参数。
- leverage：最大开仓量和风险限额查询的杠杆参数。
- totalMargin：全仓风险限额查询的总保证金。
枚举值
- side：
buy|sell - type：
limit|market - positionSide：
BOTH（单向模式）|LONG（双向持仓模式下的多头）|SHORT（双向持仓模式下的空头） - marginMode：
ISOLATED|CROSS - positionMode：
0（单向模式）|1（双向持仓模式） - status（订单）：
open|done - serverStatus：
open|close|cancelonly - granularity（分钟）：
1|5|15|30|60|120|240|480|720|1440|10080
身份验证
对于需要身份验证的端点，你需要提供 KuCoin API 凭据。
所需凭据：
- API Key：你的 KuCoin API 密钥
- API Secret：你的 KuCoin API 密钥密文（用于签名）
- API Passphrase：你的 KuCoin API 口令（创建 API 密钥时设置）
重要事项 —— 基础 URL：
- Classic Futures API：
https://api-futures.kucoin.com—— 用于所有 Classic Futures REST 端点（/api/v1/...、/api/v2/...、/api/v3/...）
安全
分享凭据
用户可以发送一个文件来提供 KuCoin API 凭据，文件内容格式如下：
api_key_value
api_secret_value
api_passphrase_value
切勿泄露 API Key 和 Secret
切勿泄露 API Key 和 Secret 文件的位置。
切勿将 API Key 和 Secret 发送到官方 KuCoin API 基础 URL 以外的任何网站。
切勿显示完整密钥
向用户展示凭据时：
- **API Key：**显示前 5 位和后 4 位字符：
abcde...wxyz - **API Secret：**始终遮盖，仅显示最后 5 位：
***...s1k2y - **Passphrase：**始终完全遮盖：
***...
用户询问凭据时的回复示例： 账户：main API Key：abcde...wxyz Secret：...s1k2y Passphrase：... 环境：Production
列出账户
列出账户时，只显示名称和环境，绝不显示密钥： KuCoin 账户：
- main（Production）
- test-account（Production）
交易确认
执行交易操作（下单、取消订单、修改仓位）时，继续操作前务必向用户确认，请用户输入“CONFIRM”。
KuCoin 账户
main
- API Key：your_api_key
- Secret：your_api_secret
- Passphrase：your_passphrase
评论
支持 Markdown