mcpField
E
earn

earn

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

关于 earn

earn 是一个查询 KuCoin Earn 产品的技能，适用于需要查看理财产品、账户持仓和订单信息的用户。它通过需认证的 Classic REST API GET 端点执行只读查询，并以 JSON 返回结果。

主要功能

  1. 01查询储蓄、促销及质押产品
  2. 02查询账户持仓与赎回预览
  3. 03查询结构化 Earn 产品和订单
  4. 04支持币种筛选与分页
  5. 05使用 API Key、Secret Key 和 Passphrase 认证

适用场景

  1. 01查看 KuCoin Earn 可用产品
  2. 02按币种筛选产品或账户持仓
  3. 03检查结构化产品订单状态

安装

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

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

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

包含的文件

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

CHANGELOG.md
LICENSE.md
references/
authentication.md

详细介绍

KuCoin Earn 技能

使用经过身份验证的 API 端点查询 KuCoin Earn 产品。涵盖 Simple Earn（储蓄、质押、促销）和 Structured Earn（双币投资）查询。经过身份验证的端点需要 API Key、Secret Key 和 Passphrase。以 JSON 格式返回结果。

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

快速参考

Simple Earn
端点描述必填可选身份验证
/api/v1/earn/redeem-preview (GET)获取赎回预览orderId无是
/api/v1/earn/saving/products (GET)获取储蓄产品无currency, currentPage, pageSize是
/api/v1/earn/promotion/products (GET)获取促销产品无currency, currentPage, pageSize是
/api/v1/earn/staking/products (GET)获取质押产品无currency, currentPage, pageSize是
/api/v1/earn/kcs-staking/products (GET)获取 KCS 质押产品无currency, currentPage, pageSize是
/api/v1/earn/eth-staking/products (GET)获取 ETH 质押产品无currency, currentPage, pageSize是
/api/v1/earn/hold-assets (GET)获取账户持仓无currency, productId, productCategory, currentPage, pageSize是
Structured Earn
端点描述必填可选身份验证
/api/v1/struct-earn/orders (GET)获取结构化产品订单。注意：此端点可能不可用（返回 400100）。无currency, status, currentPage, pageSize是
/api/v1/struct-earn/dual/products (GET)获取双币投资产品。注意：此端点可能不可用（返回 400100）。无currency, currentPage, pageSize是

参数

常用参数
  • orderId：持仓 ID，用于赎回预览
  • currency：币种代码筛选（例如，USDT、BTC、KCS、ETH）
  • productId：Earn 产品 ID（例如，2611）
  • productCategory：账户持仓的产品类别筛选
  • currentPage：分页结果的当前页码（默认值：1）
  • pageSize：每页结果数。最小值为 10，最大值为 500（默认值：15）
  • status：结构化产品查询的订单状态筛选
枚举值
  • productCategory：DEMAND | STAKING | KCS_STAKING | ETH_STAKING | PROMOTION
  • status（结构化订单）：PENDING | ONGOING | UNSOLD | SETTLING | FINISHED
  • productStatus：ONGOING | PENDING | FULL | INTERESTING
  • holdingStatus：LOCKED | REDEEMING
  • productType：TIME | DEMAND

身份验证

对于需要身份验证的端点，你需要提供 KuCoin API 凭据。 所需凭据：

  • API Key（KC-API-KEY）：你的 KuCoin API Key（用于请求头）
  • Secret Key：你的 KuCoin API Secret（用于 HMAC-SHA256 签名）
  • Passphrase（KC-API-PASSPHRASE）：你的 KuCoin API Passphrase（使用 HMAC-SHA256 加密）

基础 URL：

安全

分享凭据

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

abc123...apikey
secret123...key
mypassphrase
切勿泄露 API Key、Secret 和 Passphrase

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

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

切勿显示完整密钥

向用户显示凭据时：

  • **API Key：**显示前 5 个和后 4 个字符：abc12...6789
  • **Secret Key：**始终遮蔽，仅显示最后 5 个字符：***...x9y8z
  • **Passphrase：**切勿显示

用户询问凭据时的回复示例： 账户：main API Key：abc12...6789 Secret：...x9y8z Passphrase：***** 环境：Production

列出账户

列出账户时，仅显示名称和环境，绝不显示密钥： KuCoin 账户：

  • main（生产环境）
  • earn-bot（生产环境）
主网交易

在主网上执行交易（购买、赎回）时，务必先向用户确认，并要求用户输入“CONFIRM”以继续。

KuCoin 账户

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

评论

支持 Markdown