
# FAQs

## Q1：WEEX 是否提供合伙人 / 返佣 API？

是的。WEEX 已提供 Partner API，可用于查询邀请用户、交易量、返佣、资产等合伙人相关数据。

文档入口：[Partner API](/zh-CN/products/partner/intro)

## Q2：我调用返佣接口返回 403 或 40022，是什么原因？

通常是因为使用了旧版接口或账号权限不匹配。请优先使用 V3 Partner API，并确认当前账号已具备合伙人/返佣相关权限。

返佣接口示例：[GetAffiliateCommission](/zh-CN/products/partner/rebate-endpoints/GetAffiliateCommission)

## Q3：我可以查询自己邀请的用户列表吗？

可以。可使用 `GetAffiliateUIDs` 查询邀请用户列表。

文档：[GetAffiliateUIDs](/zh-CN/products/partner/rebate-endpoints/GetAffiliateUIDs)

## Q4：可以查询某个指定 UID 的交易数据吗？

可以。可使用 `GetChannelUserTradeAndAsset` 查询指定邀请用户的交易量、入金、出金和返佣等数据。

文档：[GetChannelUserTradeAndAsset](/zh-CN/products/partner/rebate-endpoints/GetChannelUserTradeAndAsset)

## Q5：可以查询用户的现货和合约交易量吗？

可以。`GetChannelUserTradeAndAsset` 支持查询邀请用户的现货和合约交易量，并支持自定义时间范围。

## Q6：可以查询我的返佣和用户手续费吗？

可以。可使用 `GetAffiliateCommission` 查询返佣记录、手续费、返佣比例、交易对、maker/taker 等信息。

文档：[GetAffiliateCommission](/zh-CN/products/partner/rebate-endpoints/GetAffiliateCommission)

## Q7：可以查询邀请用户的资产、余额和入金信息吗？

可以。可使用 `GetAffiliateAssets` 查询邀请用户的现货资产、合约资产、可用余额和入金相关信息。

文档：[GetAffiliateAssets](/zh-CN/products/partner/rebate-endpoints/GetAffiliateAssets)

## Q8：API 是否会返回用户 KYC 状态或注册时间？

可以。使用 `GetAffiliateUIDs` 查询邀请用户信息，返回的 `channelUserInfoItemList` 中包含 `kycResult`（KYC 认证状态）和 `registerTime`（注册时间戳，单位：毫秒）。查询范围以合伙人账号的权限和邀请关系为准。

文档：[获取代理邀请用户的 UID 列表](/zh-CN/catalog/vip-institutional-partner/api/rest-api/rebate-endpoints#获取代理邀请用户的uid列表)

## Q9：API 是否可以查询用户当前持仓或跟单信息？

目前暂不支持通过 API 查询邀请用户的当前合约持仓、跟单或复制交易相关信息。

## Q10：如何确认用户是否通过我的邀请码注册？

可以使用 `VerifyReferrals` 接口验证用户与邀请码/邀请关系是否匹配。

文档：[VerifyReferrals](/zh-CN/products/partner/rebate-endpoints/VerifyReferrals)

## Q11：可以查询下级代理或子渠道数据吗？

可以。可使用 `QuerySubChannelTransactions` 查询下级代理相关信息。

文档：[QuerySubChannelTransactions](/zh-CN/products/partner/rebate-endpoints/QuerySubChannelTransactions)

## Q12：合伙人 API 是否有测试环境？

目前合伙人 API 暂无专门的 sandbox/test 环境。Demo trading API 仅适用于部分交易接口测试，不能作为合伙人 API 测试环境。

## Q13：返佣数据为什么查询为空？

可能原因包括：返佣尚未结算、查询时间范围不正确、必填参数缺失，或该时间范围内没有符合条件的数据。建议确认时间范围和参数后再查询。

## Q14：交易量、返佣、入金和出金字段是什么单位？

相关金额字段通常按 USDT 口径返回。

## Q15：每个子合伙人创建自己的 API Key 后，可以看到哪些数据？

子合伙人使用自己账号创建的 API Key 时，只能查看其账号权限范围内的邀请用户和返佣数据。

## Q16：API 请求如何签名？

请按照 Partner API 签名文档生成 `ACCESS-SIGN`，并在请求头中携带 `ACCESS-KEY`、`ACCESS-SIGN`、`ACCESS-TIMESTAMP`、`ACCESS-PASSPHRASE` 等信息。

文档：[Signature](/zh-CN/products/partner/QuickStart/Signature)
