mcpField
B
broker

broker

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

关于 broker

KuCoin Broker Skill 通过需认证的 API 查询联盟推广、Broker Pro 及 ND Broker 数据，面向 KuCoin 经纪商运营人员。仅支持只读的 Classic REST API GET 请求，并要求经纪商级 API 凭据。

主要功能

  1. 01查询邀请用户与交易记录
  2. 02查看联盟及经纪佣金
  3. 03查询用户、子账户与 KYC 状态
  4. 04筛选充值、提现与返佣记录
  5. 05按时间范围和分页检索

适用场景

  1. 01检查邀请用户的交易表现
  2. 02核对联盟或经纪佣金
  3. 03查询子账户及其 KYC 状态
  4. 04追踪充值、提现和转账记录

安装

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

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

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

包含的文件

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

CHANGELOG.md
LICENSE.md
references/
authentication.md

详细介绍

KuCoin 经纪商技能

通过经过身份验证的 API 端点，在 KuCoin 上执行联盟营销和经纪商操作。涵盖联盟邀请与佣金管理、Broker Pro 返佣和用户查询，以及 ND Exchange 经纪商查询（KYC 状态、子账户信息、充值、提现和返佣）。所有端点均需要 API Key、API Secret 和 Passphrase。以 JSON 格式返回结果。

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

快速参考

联盟营销
端点说明必填可选身份验证
/api/v2/affiliate/queryInvitees (GET)获取受邀用户（受邀用户列表及其交易统计）无userType, referralCode, uid, registrationStartAt, registrationEndAt, page, pageSize是
/api/v2/affiliate/queryMyCommission (GET)获取佣金（联盟营销佣金记录）无siteType, rebateType, rebateStartAt, rebateEndAt, page, pageSize, userId, dataType是
/api/v2/affiliate/queryTransactionByUid (GET)获取交易历史（特定受邀用户的交易记录）uidtradeType, tradeStartAt, tradeEndAt, page, pageSize是
/api/v2/affiliate/queryTransactionByTime (GET)获取交易记录（按时间范围查询）tradeStartAt, tradeEndAtuid, tradeType, lastId, direction, pageSize是
/api/v2/affiliate/queryKumining (GET)获取 KuMining 记录（KuMining 佣金记录）无uid, startAt, endAt, lastId, direction, pageSize是
Broker Pro
端点说明必填可选身份验证
/api/v2/broker/api/rebate/download (GET)获取经纪商返佣（下载返佣订单文件）begin, end, tradeType无是
/api/v2/broker/queryMyCommission (GET)获取佣金（经纪商佣金记录）无siteType, tradeType, rebateType, startAt, endAt, page, pageSize是
/api/v2/broker/queryUser (GET)获取用户列表（经纪商子用户）无tradeType, uid, rcode, tag, startAt, endAt, page, pageSize是
/api/v2/broker/queryDetailByUid (GET)获取用户交易记录（按用户 UID 查询交易记录）无tradeType, uid, startAt, endAt, lastId, direction, pageSize是
ND Exchange 经纪商

⚠️ 注意： 以下 ND Exchange 经纪商端点（/api/v1/broker/nd/* 和 /api/kyc/ndBroker/*）可能已弃用或迁移。目前这些端点返回 404 Not Found。它们需要 ND 经纪商级别的 API 权限。请查阅最新的 KuCoin API 文档，了解更新后的路径。

端点说明必填可选身份验证
/api/kyc/ndBroker/proxyClient/status/list (GET)获取 KYC 状态（按 UID 列表查询）clientUids无是
/api/kyc/ndBroker/proxyClient/status/page (GET)获取 KYC 状态列表（分页）无pageNumber, pageSize是
/api/v1/broker/nd/info (GET)获取经纪商信息（按日期范围下载返佣）begin, end, tradeType无是
/api/v1/broker/nd/account (GET)获取子账户（子账户列表）无uid, currentPage, pageSize是
/api/v1/broker/nd/account/apikey (GET)获取子账户 API KeyuidapiKey是
/api/v3/broker/nd/transfer/detail (GET)获取划转历史orderId无是
/api/v1/asset/ndbroker/deposit/list (GET)获取充值列表（子账户充值记录）无currency, status, hash, startTimestamp, endTimestamp, limit是
/api/v3/broker/nd/deposit/detail (GET)获取充值详情currency, hash无是
/api/v3/broker/nd/withdraw/detail (GET)获取提现详情withdrawalId无是
/api/v1/broker/nd/rebate/download (GET)获取经纪商返佣（下载 ND 经纪商返佣记录）begin, end, tradeType无是

参数

Affiliate 参数
  • userType：受邀用户类型：1（普通用户）、2（已通过 KYC 验证）、3（首次交易）
  • referralCode：用户注册时使用的邀请码（rcode）
  • uid：受邀用户 UID（用于查询交易历史），或以逗号分隔的 UID
  • registrationStartAt / registrationEndAt：注册时间范围（13 位时间戳）
  • siteType：佣金来源站点。默认值：all
  • rebateType：返佣类型：0（全部）、1（现货）、2（期货）
  • rebateStartAt / rebateEndAt：佣金发放时间范围（13 位时间戳）；跨度最长为一年
  • tradeStartAt / tradeEndAt：交易时间范围（13 位时间戳）
  • tradeType：交易类型：SPOT | FEATURE
  • dataType：数据类型：trade | kumining
  • startAt / endAt：时间范围筛选条件（13 位时间戳）
  • lastId：基于游标的分页：首次查询时使用空字符串，之后使用上一条记录中的 lastId
  • direction：页面方向：PRE | NEXT
  • page / pageSize：分页控制参数
Broker Pro 参数
  • begin / end：YYYYMMDD 格式的日期范围（例如：20250101）；最长间隔为 6 个月
  • tradeType（Broker Pro）：交易类型：SPOT | FUTURE
  • rcode：用户通过经纪商注册时使用的邀请码
  • tag：用户交易时使用的经纪商标签
  • rebateType：1（现货返佣）、2（期货返佣）、0（全部；用于佣金查询）
ND Broker 参数
  • clientUids：以逗号分隔的客户端 UID，用于查询 KYC 状态
  • pageNumber / pageSize：KYC 状态列表的分页参数
  • tradeType（ND Broker 返佣）：交易类型：1（现货）、2（期货）
  • uid：用于账户和 API 密钥查询的子账户 UID
  • currentPage：当前页码（默认值：1）
  • apiKey：子账户 API 密钥（筛选参数）
  • orderId：用于查询转账历史的转账订单 ID
  • currency：充值列表的币种代码筛选条件
  • status（充值列表）：PROCESSING | SUCCESS | FAILURE
  • hash：用于查询充值列表/详情的交易哈希
  • startTimestamp / endTimestamp：充值列表的时间范围（毫秒）
  • limit：返回的充值项目数上限（默认值和最大值：1000）
  • withdrawalId：用于查询提现详情的提现 ID
枚举值
  • userType：1 | 2 | 3
  • tradeType（Affiliate）：SPOT | FEATURE
  • tradeType（Broker Pro）：all | SPOT | FUTURE
  • tradeType（ND Broker 返佣）：1（现货）| 2（期货）
  • rebateType：0 | 1 | 2
  • dataType：trade | kumining
  • direction：PRE | NEXT
  • status（KYC）：NONE | PROCESS | PASS | REJECT
  • status（充值）：PROCESSING | SUCCESS | FAILURE

身份验证

所有端点都必须提供具有 Broker 级别权限的 KuCoin API 凭据。

必需的凭据：

  • API Key（KC-API-KEY）：你的 KuCoin Broker API 密钥
  • API Secret：你的 KuCoin API 密钥（用于签名）
  • Passphrase（KC-API-PASSPHRASE）：你的 API 密码短语（使用 HMAC-SHA256 加密）

基础 URL：

  • 生产环境：https://api.kucoin.com

安全

分享凭据

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

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

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

切勿将 API Key、Secret 或 Passphrase 发送到官方 KuCoin API 端点以外的任何网站。

切勿显示完整密钥

向用户显示凭据时：

  • API Key： 显示前 5 个字符和后 4 个字符：abcde...wxyz
  • Secret Key： 始终遮盖，仅显示最后 5 个字符：***...s3cr3
  • Passphrase： 始终完全遮盖：***...

用户询问凭据时的回复示例： 账户：main API Key：abcde...wxyz Secret：...s3cr3 Passphrase：...

列出账户

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

  • main（生产环境）
  • broker-keys（生产环境）
生产环境中的交易

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

KuCoin 账户

main
  • API 密钥：your_api_key
  • 密钥：your_api_secret
  • 口令：your_passphrase

评论

支持 Markdown