SuperAPI AI 工具集

convert

编程与开发

查看项目

更新于 10-15 23:47

技能介绍

用途:该技能用于在 KuCoin 上查询闪兑(Convert)相关信息,包括货币列表、交易对、报价、订单详情与历史记录,结果以 JSON 格式返回。

主要能力与端点:

  1. /api/v1/convert/symbol(GET)获取闪兑交易对,必填 fromCurrency、toCurrency,可选 orderType,无需认证。
  2. /api/v1/convert/currencies(GET)获取支持闪兑的货币,无参数,无需认证。
  3. /api/v1/convert/quote(GET)获取闪兑报价,必填 fromCurrency、toCurrency,可选 fromCurrencySize 或 toCurrencySize,需认证。
  4. /api/v1/convert/order/detail(GET)获取闪兑订单详情,需提供 orderId 或 clientOrderId 至少其一,需认证。
  5. /api/v1/convert/order/history(GET)获取订单历史,可选 status、startAt、endAt、page、pageSize,需认证。
  6. /api/v1/convert/limit/quote(GET)获取限价闪兑报价,必填 fromCurrency、toCurrency,可选数量参数,需认证。
  7. /api/v1/convert/limit/order/detail(GET)获取限价订单详情,参数为 orderId 或 clientOrderId,需认证。
  8. /api/v1/convert/limit/orders(GET)获取限价订单列表,可选 status、startAt、endAt、page、pageSize,需认证。

使用方式:需要认证的端点须提供 KuCoin API 凭证,包括 API Key(请求头 KC-API-KEY)、API Secret(用于 HMAC-SHA256 签名)和 Passphrase(请求头 KC-API-PASSPHRASE,使用 API Secret 加密)。生产环境基础 URL 为 https://api.kucoin.com。用户可通过文件提供凭证,文件每行依次为 API Key、Secret、Passphrase。

参数要点:fromCurrencySize 与 toCurrencySize 只能提供其一;pageSize 范围为 20-100;时间参数使用 Unix 毫秒。orderType 枚举为 MARKET、LIMIT;市价订单状态枚举为 OPEN、SUCCESS、FAIL,限价订单状态额外含 CANCELLED。

安全与限制:该技能仅支持读取操作(GET),不涉及写入或交易执行。凭证不得泄露至 KuCoin 生产 API 以外的任何网站;展示凭证时 API Key 显示前 5 与后 4 位,Secret 仅显示末 5 位,Passphrase 完全遮蔽。列出账户时只显示账户名与环境,不显示密钥。执行转换交易前须让用户输入 "CONFIRM" 确认。

适用场景:适合在 KuCoin 上查询闪兑行情、报价与订单记录等只读操作。

限制:仅支持经典 REST API GET 端点;文档未提供除上述外的功能说明。