mcpField
C
convert

convert

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

关于 convert

用于查询 KuCoin 兑换交易对、报价和订单详情的 Claude Skill。它通过只读的 Classic REST GET 端点获取数据，并以 JSON 返回结果。

主要功能

  1. 01查询可用兑换交易对和币种
  2. 02获取市价与限价报价
  3. 03查询兑换订单详情
  4. 04查看市价与限价订单历史

适用场景

  1. 01兑换前核对可用币种
  2. 02查看币种交易对报价
  3. 03检查兑换订单状态和历史

安装

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

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

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

包含的文件

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

CHANGELOG.md
LICENSE.md
references/
authentication.md

详细介绍

KuCoin Convert 技能

在 KuCoin 上查询 Convert 货币、报价和订单详情。以 JSON 格式返回结果。

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

快速参考

端点描述必填可选身份验证
/api/v1/convert/symbol (GET)获取 Convert 交易对fromCurrency, toCurrencyorderType否
/api/v1/convert/currencies (GET)获取 Convert 货币无无否
/api/v1/convert/quote (GET)获取 Convert 报价fromCurrency, toCurrencyfromCurrencySize, toCurrencySize是
/api/v1/convert/order/detail (GET)获取 Convert 订单详情orderId 或 clientOrderId（至少填写一个）无是
/api/v1/convert/order/history (GET)获取 Convert 订单历史无status, startAt, endAt, page, pageSize是
/api/v1/convert/limit/quote (GET)获取 Convert 限价报价fromCurrency, toCurrencyfromCurrencySize, toCurrencySize是
/api/v1/convert/limit/order/detail (GET)获取 Convert 限价订单详情无orderId, clientOrderId是
/api/v1/convert/limit/orders (GET)获取 Convert 限价订单无status, startAt, endAt, page, pageSize是

参数

通用参数
  • fromCurrency：交易对的源货币（例如 BTC）
  • toCurrency：交易对的目标货币（例如 USDT）
  • fromCurrencySize：要兑换的源货币数量。必须提供 fromCurrencySize 或 toCurrencySize，但不能同时提供两者。
  • toCurrencySize：要兑换的目标货币数量。必须提供 fromCurrencySize 或 toCurrencySize，但不能同时提供两者。
  • orderType：查询 Convert 交易对时使用的订单类型筛选条件（例如 MARKET）
  • orderId：Convert 订单 ID。查询详情的端点必须提供 orderId 或 clientOrderId。
  • clientOrderId：由用户定义的唯一订单标识符。最多 40 个字符。
  • status：查询订单历史时使用的订单状态筛选条件。
  • startAt：订单开始时间筛选条件，单位为 Unix 毫秒。
  • endAt：订单结束时间筛选条件，单位为 Unix 毫秒。
  • page：分页结果的当前页码。
  • pageSize：每页结果数（20-100）。
枚举值
  • orderType：MARKET | LIMIT
  • status（市价订单）：OPEN | SUCCESS | FAIL
  • status（限价订单）：OPEN | SUCCESS | FAIL | CANCELLED

身份验证

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

  • API Key（KC-API-KEY）：你的 KuCoin API 密钥（通过请求头发送）
  • API Secret：你的 KuCoin API 密钥密文（用于 HMAC-SHA256 签名）
  • Passphrase（KC-API-PASSPHRASE）：你的 KuCoin API 口令（通过请求头发送，使用 API Secret 通过 HMAC-SHA256 加密）

基础 URL：

安全

分享凭据

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

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

切勿泄露 API key、secret 和 passphrase 文件的位置。

切勿将 API key、secret 和 passphrase 发送到 KuCoin 生产 API 以外的任何网站。

切勿显示完整密钥

向用户展示凭据时：

  • API Key： 显示前 5 个字符和后 4 个字符：su1Qc...8akf
  • Secret Key： 始终遮盖，仅显示末尾 5 个字符：***...aws1
  • Passphrase： 始终完全遮盖：***...

用户询问凭据时的示例回复： 账户：main API Key：su1Qc...8akf Secret：...aws1 Passphrase：... 环境：生产环境

列出账户

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

  • main（生产环境）
  • trading-bot（生产环境）
交易

执行兑换交易时，务必先要求用户输入“CONFIRM”以确认，然后再继续。

KuCoin 账户

main
  • API Key：your_api_key
  • Secret：your_api_secret

评论

支持 Markdown