broker

用途：在 KuCoin 上执行经纪商（Broker）与联盟（Affiliate）相关查询，全部基于已认证的经典 REST API GET 接口，仅支持只读操作。

主要能力：

1. 联盟：查询被邀请用户及交易统计、佣金记录、指定 UID 或按时间范围的交易记录、KuMining 佣金记录。
2. Broker Pro：下载返佣订单文件、查询佣金记录、子用户列表、按 UID 查询用户交易。
3. ND 交易所经纪商：KYC 状态（按 UID 列表或分页）、经纪商信息、子账户及 API Key、划转记录、充值列表与详情、提现详情、返佣下载。注意：ND 相关路径 /api/v1/broker/nd/* 与 /api/kyc/ndBroker/* 可能已弃用或迁移，目前返回 404，需咨询最新 KuCoin API 文档。

认证：所有接口需 KuCoin API 凭证及经纪商级权限，包括 API Key（KC-API-KEY）、API Secret（签名用）、Passphrase（KC-API-PASSPHRASE，HMAC-SHA256 加密）。生产环境基址为 https://api.kucoin.com。用户可通过文件提供凭证，格式为三行：api-key、api-secret、passphrase。

常见参数：时间范围多为 13 位时间戳；Broker Pro 的 begin/end 使用 YYYYMMDD 且最长 6 个月；返佣时间跨度最长一年。分页可用 page/pageSize 或 lastId+direction（PRE|NEXT）。枚举如 userType(1|2|3)、tradeType、rebateType(0|1|2)、dataType(trade|kumining)、status 等。

安全与限制：切勿泄露密钥文件位置，切勿将密钥发送至 KuCoin 官方以外的站点。展示凭证时需掩码：API Key 显示前 5 后 4（如 abcde...wxyz），Secret 仅显示后 5，Passphrase 全部掩码。列出账户仅显示名称与环境，不显示密钥。涉及修改数据的操作（划转、创建子账户、更新 API Key）须先让用户输入 CONFIRM 确认。本技能资料仅提到只读 GET，具体写操作未提供。