关于 margin-trading
面向 KuCoin 保证金交易的只读查询技能，通过 Classic REST API GET 端点获取数据。覆盖全仓与逐仓行情、订单、借还款、借贷及风险限额；认证查询需要 KuCoin API 凭据。
主要功能
- 01查询全仓与逐仓行情
- 02查询未结和已完成订单
- 03查看止损单与 OCO 订单
- 04查看借款、还款和利息记录
- 05查询借贷及风险限额
适用场景
- 01检查保证金交易对价格和抵押率
- 02查看订单与成交历史
- 03跟踪借款、还款及利息
- 04检查借贷订单和币种风险限额
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/margin-trading确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
CHANGELOG.mdLICENSE.mdreferences/authentication.md详细介绍
KuCoin 保证金交易 Skill
使用经过身份验证的 API 端点在 KuCoin 上进行保证金交易。支持全仓保证金和逐仓保证金市场数据、高频订单查询、止损单查询、OCO 订单查询、借款/还款历史查询、借贷查询和风险限额。经过身份验证的端点需要 API Key、API Secret 和 Passphrase。以 JSON 格式返回结果。
**注意：**此 Skill 仅支持 Classic REST API GET 端点（只读操作）。
快速参考
Classic 保证金市场数据
| 端点 | 描述 | 必填 | 可选 | 身份验证 |
|---|---|---|---|---|
/api/v3/margin/symbols (GET) | 获取交易对 — 全仓保证金（交易对配置） | 无 | symbol | 否 |
/api/v1/isolated/symbols (GET) | 获取交易对 — 逐仓保证金（交易对配置） | 无 | 无 | 否 |
/api/v3/etf/info (GET) | 获取 ETF 信息（杠杆代币信息） | 无 | currency | 否 |
/api/v1/mark-price/{symbol}/current (GET) | 获取标记价格详情（保证金交易对的当前标记价格） | symbol（路径） | 无 | 否 |
/api/v1/margin/config (GET) | 获取保证金配置（全仓保证金配置、币种列表） | 无 | 无 | 否 |
/api/v3/mark-price/all-symbols (GET) | 获取标记价格列表（所有保证金交易对的当前标记价格） | 无 | 无 | 否 |
/api/v3/margin/collateralRatio (GET) | 获取保证金抵押率 | 无 | currencyList | 否 |
/api/v3/margin/available-inventory (GET) | 获取市场可用库存（平台可借数量） | 无 | currency | 否 |
Classic 保证金 HF 订单查询
| 端点 | 描述 | 必填 | 可选 | 身份验证 |
|---|---|---|---|---|
/api/v3/hf/margin/orders/{orderId} (GET) | 按 OrderId 获取订单 | orderId（路径）、symbol（查询参数） | 无 | 是 |
/api/v3/hf/margin/orders/client-order/{clientOid} (GET) | 按 ClientOid 获取订单 | clientOid（路径）、symbol（查询参数） | 无 | 是 |
/api/v3/hf/margin/order/active/symbols (GET) | 获取有未结订单的交易对 | tradeType | 无 | 是 |
/api/v3/hf/margin/orders/active (GET) | 获取未结订单 | symbol、tradeType | 无 | 是 |
/api/v3/hf/margin/orders/done (GET) | 获取已结订单 | symbol、tradeType | side、type、lastId、limit、startAt、endAt | 是 |
/api/v3/hf/margin/fills (GET) | 获取交易历史 | symbol、tradeType | orderId、side、type、lastId、limit、startAt、endAt | 是 |
Classic 保证金止损单查询
| 端点 | 描述 | 必填 | 可选 | 身份验证 |
|---|---|---|---|---|
/api/v3/hf/margin/stop-orders (GET) | 获取止损单列表（分页、未触发） | 无 | symbol、side、type、tradeType、startAt、endAt、currentPage、orderIds、pageSize、stop | 是 |
/api/v3/hf/margin/stop-order/orderId (GET) | 按 OrderId 获取止损单 | orderId | 无 | 是 |
/api/v3/hf/margin/stop-order/clientOid (GET) | 按 ClientOid 获取止损单 | clientOid | 无 | 是 |
Classic 保证金 OCO 订单查询
| 端点 | 描述 | 必填 | 可选 | 身份验证 |
|---|---|---|---|---|
/api/v3/hf/margin/oco-order/orderId (GET) | 按 OrderId 获取 OCO 订单 | orderId | 无 | 是 |
/api/v3/hf/margin/oco-order/clientOid (GET) | 按 ClientOid 获取 OCO 订单 | clientOid | 无 | 是 |
/api/v3/hf/margin/oco-order/detail/orderId (GET) | 按 OrderId 获取 OCO 订单详情（包含子订单） | orderId | 无 | 是 |
/api/v3/hf/margin/oco-orders (GET) | 获取 OCO 订单列表（分页） | pageSize、currentPage | symbol、startAt、endAt、orderIds、tradeType | 是 |
经典借贷查询（借入和偿还）
| Endpoint | 描述 | 必填 | 可选 | 身份验证 |
|---|---|---|---|---|
/api/v3/margin/borrowRate (GET) | 获取借款利率 | 无 | vipLevel, currency | 是 |
/api/v3/margin/borrow (GET) | 获取借款历史 | currency | isIsolated, symbol, orderNo, startTime, endTime, currentPage, pageSize | 是 |
/api/v3/margin/repay (GET) | 获取还款历史 | currency | isIsolated, symbol, orderNo, startTime, endTime, currentPage, pageSize | 是 |
/api/v3/margin/interest (GET) | 获取利息历史 | 无 | currency, isIsolated, symbol, startTime, endTime, currentPage, pageSize | 是 |
经典信贷查询（借贷）
| Endpoint | 描述 | 必填 | 可选 | 身份验证 |
|---|---|---|---|---|
/api/v3/project/list (GET) | 获取借贷市场（可供借出的币种） | 无 | currency | 是 |
/api/v3/project/marketInterestRate (GET) | 获取借贷市场利率（过去 7 天） | currency | 无 | 是 |
/api/v3/purchase/orders (GET) | 获取申购订单（分页） | status | currency, purchaseOrderNo, currentPage, pageSize | 是 |
/api/v3/redeem/orders (GET) | 获取赎回订单（分页） | status | currency, redeemOrderNo, currentPage, pageSize | 是 |
经典风险限额
| Endpoint | 描述 | 必填 | 可选 | 身份验证 |
|---|---|---|---|---|
/api/v3/margin/currencies (GET) | 获取保证金风险限额（每种币种/交易对的配置和风险限额信息） | 无 | isIsolated, currency, symbol | 是 |
参数
通用参数
- clientOid：客户端订单 ID。由用户创建的唯一标识符（建议使用 UUID）。最大长度：40 个字符。
- symbol：交易对标识（例如，
BTC-USDT） - side：订单方向筛选：
buy|sell - type：订单类型筛选：
limit|market - orderId：用于查询的订单 ID
- isIsolated：
true表示逐仓保证金，false表示全仓保证金。默认值为false。 - tradeType：交易类型：
MARGIN_TRADE（全仓保证金）、MARGIN_ISOLATED_TRADE（逐仓保证金） - stop：止损订单触发条件筛选：
loss|entry - lastId：上一批数据集中最后一条数据的 ID。用于基于游标的分页。
- limit：每页结果数。默认值：20，最大值：100（适用于订单/成交查询）。
- currentPage：分页查询的当前页码。默认值：1。
- pageSize：分页查询的每页条数。因端点而异（典型默认值：50，最大值：500）。
- startAt / startTime：以毫秒为单位的开始时间筛选条件。
- endAt / endTime：以毫秒为单位的结束时间筛选条件。
- currency：币种代码（例如，
BTC、USDT）。 - vipLevel：VIP 等级。留空时，默认使用当前用户的 VIP 等级。
- orderNo：用于借款/还款历史查询的订单号。
- purchaseOrderNo：借贷操作的申购订单 ID。
- redeemOrderNo：赎回查询的赎回订单 ID。
- status：订单状态筛选。取值因端点而异（例如，
DONE、PENDING）。 - currencyList：用于抵押率查询的逗号分隔币种列表。
枚举值
- side：
buy|sell - type：
limit|market - tradeType：
MARGIN_TRADE（全仓保证金） |MARGIN_ISOLATED_TRADE（逐仓保证金） - stop：
loss|entry - 申购/赎回状态：
DONE|PENDING - OCO 订单状态：
NEW|DONE|TRIGGERED|CANCELLED - 止损订单状态：
NEW|TRIGGERED - 流动性：
taker|maker
身份验证
对于需要身份验证的端点，您需要提供 KuCoin API 凭据。 所需凭据：
- API Key：您的 KuCoin API 密钥（用于标头
KC-API-KEY） - API Secret：您的 KuCoin API 密钥（用于签名）
- Passphrase：您的 KuCoin API 口令（用于标头
KC-API-PASSPHRASE）
基础 URL：
- 生产环境：
https://api.kucoin.com
安全
分享凭据
用户可以通过发送文件来提供 KuCoin API 凭据，文件内容格式如下：
api_key_value
api_secret_value
api_passphrase_value
切勿泄露 API Key 和 Secret
切勿泄露 API Key、Secret 或 Passphrase 文件的位置。
切勿将 API Key、Secret 或 Passphrase 发送到 KuCoin 官方 API 端点以外的任何网站。
切勿显示完整密钥
向用户显示凭据时：
- **API Key：**显示前 5 个字符和后 4 个字符：
abcde...wxyz - **API Secret：**始终屏蔽，仅显示最后 5 个字符：
***...s3cr3 - **Passphrase：**始终完全屏蔽：
***...
用户询问凭据时的回复示例： 账户：main API Key：abcde...wxyz Secret：...s3cr3 Passphrase：...
列出账户
列出账户时，仅显示名称和环境，不得显示密钥： KuCoin 账户：
- main（生产环境）
- margin-keys（生产环境）
在生产环境中进行交易
在生产环境中进行交易时，继续操作前务必先向用户确认，并要求他们回复“CONFIRM”。
KuCoin 账户
main
- API Key：your_api_key
- Secret：your_api_secret
- Passphrase：your_passphrase
评论
支持 Markdown