mcpField
A
assets

assets

github.com/kucoin其他2885 次安装32 周前更新
代码仓库

关于 assets

KuCoin Assets Skill 为使用 KuCoin 的用户提供账户与资金资产查询，覆盖现货、保证金、期货及子账户等信息。它仅调用经过认证的 Classic REST API GET 端点，执行只读操作并以 JSON 返回。

主要功能

  1. 01查询账户余额与账本
  2. 02查看子账户及余额
  3. 03查询充值和提现记录
  4. 04获取划转额度与交易费
  5. 05仅支持只读 GET 操作

适用场景

  1. 01核对现货、保证金或期货账户资产
  2. 02查看子账户余额和 API 密钥信息
  3. 03查询充值、提现及账本历史

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/kucoin/kucoin-skills-hub --skill assets

安装后在 Claude Code 中输入/assets确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

CHANGELOG.md
LICENSE.md
references/
authentication.md

详细介绍

KuCoin 资产技能

通过经过身份验证的 API 端点管理 KuCoin 资产。所有端点均需要 API Key、API Secret 和 Passphrase。以 JSON 格式返回结果。

**注意：**此技能仅支持 Classic REST API GET 端点（只读操作）。

快速参考

Classic API -- 账户与资金
端点描述必需可选身份验证
GET /api/v2/user-info获取账户摘要信息无无是
GET /api/v1/user/api-key获取 API 密钥信息无无是
GET /api/v1/hf/accounts/opened获取账户类型 - 现货无无是
GET /api/v1/accounts获取账户列表 - 现货无currency, type是
GET /api/v1/accounts/{accountId}获取账户详情 - 现货accountId (path)无是
GET /api/v3/margin/accounts获取账户 - 全仓保证金。注意：需要启用账户的保证金交易功能。无quoteCurrency, queryType是
GET /api/v3/isolated/accounts获取账户 - 逐仓保证金。注意：需要启用账户的保证金交易功能。无symbol, quoteCurrency, queryType是
GET /api/v1/account-overview获取账户 - 期货。注意：必须使用期货基础 URL（https://api-futures.kucoin.com）。无currency是
GET /api/v1/accounts/ledgers获取账户账本 - 现货/保证金无currency, direction, bizType, startAt, endAt, currentPage, pageSize是
GET /api/v1/hf/accounts/ledgers获取账户账本 - Trade_hf无currency, direction, bizType, lastId, limit, startAt, endAt是
GET /api/v3/hf/margin/account/ledgers获取账户账本 - Margin_hf无currency, direction, bizType, lastId, limit, startAt, endAt是
GET /api/v1/transaction-history获取账户账本 - 期货。注意：必须使用期货基础 URL（https://api-futures.kucoin.com）。无currency, type, offset, forward, maxCount, startAt, endAt是
Classic API -- 子账户
端点描述必需可选身份验证
GET /api/v2/sub/user获取子账户列表 - 摘要信息无currentPage, pageSize是
GET /api/v1/sub-accounts/{subUserId}获取子账户详情 - 余额subUserId (path)includeBaseAmount, baseCurrency, baseAmount是
GET /api/v2/sub-accounts获取子账户列表 - 现货余额（V2）无currentPage, pageSize是
GET /api/v1/account-overview-all获取子账户列表 - 期货余额（V2）。注意：必须使用期货基础 URL（https://api-futures.kucoin.com）。无currency是
Classic API -- 子账户 API
端点描述必需可选身份验证
GET /api/v1/sub/api-key获取子账户 API 列表subNameapiKey是
Classic API -- 充值
端点描述必需可选身份验证
GET /api/v3/deposit-addresses获取充值地址（V3）currencychain是
GET /api/v1/deposits获取充值记录currencystatus, startAt, endAt, currentPage, pageSize是
Classic API -- 提现
端点描述必需可选身份验证
GET /api/v1/withdrawals/quotas获取提现额度currencychain是
GET /api/v1/withdrawals/{withdrawalId}按 ID 获取提现记录withdrawalId (path)无是
GET /api/v1/withdrawals获取提现记录currencystatus, startAt, endAt, currentPage, pageSize是
Classic API -- Transfer
EndpointDescriptionRequiredOptionalAuthentication
GET /api/v1/accounts/transferable获取可转账额度currency, typetagYes
Classic API -- Trade Fee
EndpointDescriptionRequiredOptionalAuthentication
GET /api/v1/base-fee获取基础费率 - 现货／杠杆NonecurrencyTypeYes
GET /api/v1/trade-fees获取实际费率 - 现货／杠杆symbolsNoneYes
GET /api/v1/trade-fees获取实际费率 - 期货。注意：必须使用期货基础 URL（https://api-futures.kucoin.com）。symbolsNoneYes

参数

常用参数
  • currency：货币代码（例如，BTC、USDT、ETH）。部分端点支持使用逗号分隔多个货币进行查询。
  • chain：货币的链 ID（例如，eth、trx、bsc、ton2、arbitrum）。建议用于多链货币。
  • startAt / endAt：开始和结束时间，单位为 Unix 纪元以来的毫秒数。
  • currentPage：当前请求页，默认为 1。
  • pageSize：每页结果数。因端点而异（典型范围为最少 10，最多 100-500）。
  • lastId：上一批数据中最后一条数据的 ID。用于基于游标的分页。
  • direction：转账方向：in 或 out。
Classic API 账户参数
  • type（现货账户列表）：账户类型：main（资金账户）、trade（现货账户）。
  • accountId：账户 ID（账户详情的路径参数）。
  • quoteCurrency：杠杆账户的计价货币：USDT、KCS、BTC。
  • queryType（全仓杠杆）：MARGIN、MARGIN_V2、ALL。
  • queryType（逐仓杠杆）：ISOLATED、ISOLATED_V2、ALL。
  • bizType（现货／杠杆账本）：DEPOSIT、WITHDRAW、TRANSFER、SUB_TRANSFER、TRADE_EXCHANGE、MARGIN_EXCHANGE、KUCOIN_BONUS、BROKER_TRANSFER。
  • bizType（Trade_hf 账本）：TRADE_EXCHANGE、TRANSFER、SUB_TRANSFER、RETURNED_FEES、DEDUCTION_FEES、OTHER。
  • bizType（Margin_hf 账本）：TRANSFER、MARGIN_EXCHANGE、ISOLATED_EXCHANGE、LIQUIDATION、ASSERT_RETURN。
  • type（期货账本）：RealisedPNL、Deposit、Withdrawal、TransferIn、TransferOut。
  • offset：期货账本分页的起始偏移量。
  • forward：布尔值。true 表示向前查询（默认值），false 表示向后查询。
  • maxCount：期货账本每页显示数量，默认为 50。
  • limit：HF 账本查询的每页结果数。
子账户参数
  • subUserId：子账户的用户 ID（路径参数）。
  • subName：子账户名称（用于查询 API 密钥）。
  • apiKey：子账户的 API 密钥（筛选参数）。
  • includeBaseAmount：布尔值。true 表示显示所有货币，包括余额为零的货币。
  • baseCurrency：用于转换并显示资产价值的货币。
  • baseAmount：筛选条件：货币余额必须 >= 此金额。
充值与提现参数
  • status（充值历史）：PROCESSING、SUCCESS、FAILURE、WAIT_TRM_MGT、TRM_MGT_REJECTED。
  • status（提现历史）：PROCESSING、REVIEW、WALLET_PROCESSING、SUCCESS、FAILURE。
  • withdrawalId：提现 ID（路径参数）。
转账参数
  • type（可转账额度）：账户类型：MAIN、TRADE、MARGIN、ISOLATED、MARGIN_V2、ISOLATED_V2。
  • tag：当账户类型为 ISOLATED 时必需的交易对（例如，BTC-USDT）。
交易费率参数
  • currencyType：货币类型：0（加密货币）、1（法币）。默认为 0。
  • symbols：用于费率查询的交易对符号。现货／杠杆：例如，BTC-USDT,ETH-USDT（最多 10 个）。期货：例如，XBTUSDTM（必须使用期货基础 URL）。

枚举

账户类型（Classic API）
值描述
main资金账户
trade现货交易账户
MAIN资金账户（划转场景）
TRADE现货交易账户（划转场景）
CONTRACT期货账户（划转场景）
MARGIN全仓杠杆账户（HF）
ISOLATED逐仓杠杆账户（HF）
MARGIN_V2全仓杠杆账户（旧版，逐步停用）
ISOLATED_V2逐仓杠杆账户（旧版，逐步停用）
充值状态
值描述
PROCESSING充值正在处理中
SUCCESS充值成功完成
FAILURE充值失败
WAIT_TRM_MGT等待旅行规则管理
TRM_MGT_REJECTED被旅行规则管理拒绝
提现状态
值描述
REVIEW审核中
PROCESSING处理中
WALLET_PROCESSING钱包处理中
SUCCESS提现成功完成
FAILURE提现失败

身份验证

所有端点都必须提供 KuCoin API 凭据。

所需凭据：

  • API Key：你的 KuCoin API 密钥（通过 KC-API-KEY 请求头发送）
  • API Secret：你的 KuCoin API Secret（用于 HMAC-SHA256 签名）
  • Passphrase：创建 API Key 时设置的 Passphrase（通过 KC-API-PASSPHRASE 请求头发送，API Key Version 2 中会加密）

基础 URL：

环境URL
生产环境https://api.kucoin.com

安全

分享凭据

用户可以通过发送文件来提供 KuCoin API 凭据，文件内容格式如下：

your-api-key
your-api-secret
your-passphrase
切勿泄露 API Key、Secret 和 Passphrase

切勿泄露 API Key、Secret 和 Passphrase 文件的位置。

切勿将 API Key、Secret 或 Passphrase 发送到 KuCoin 生产 API 以外的任何网站。

切勿显示完整密钥

向用户显示凭据时：

  • **API Key：**显示前 5 个字符和后 4 个字符：68d4a...841d
  • **Secret Key：**始终打码，只显示最后 5 个字符：***...b2340
  • **Passphrase：**始终完全打码：***...

用户询问凭据时的回复示例： 账户：main API Key：68d4a...841d Secret：...b2340 Passphrase：... 环境：生产环境

列出账户

列出账户时，只显示名称和环境，切勿显示密钥： KuCoin 账户：

  • main（生产环境）
  • sub-keys（生产环境）
交易

执行会修改数据的操作（划转、提现、创建子账户）时，务必先请用户输入“CONFIRM”确认，然后再继续。

KuCoin 账户

main
  • API Key：your_api_key
  • Secret：your_api_secret
  • Passphrase：your_passphrase

评论

支持 Markdown