跳转至

2026-10-27

2026-10-27

Futures V3 — 查询Builder用户佣金

  • 新增 GET /fapi/v3/builder/userCommissions（USER_DATA，权重 5）：分页查询调用者 Builder 代码下用户成交产生的 Builder 手续费。
  • 参数：userAddresses（最多 50 个，逗号分隔）、startTime、endTime、page（默认 1）、limit（默认 50；最大 1000）、nonce、signer、signature。
  • 查询的成交范围与 GET /fapi/v3/builder/userTrades 相同，但仅返回手续费相关字段（tradeId、insertTime、orderId、symbol、feeAsset、marginAsset、builderFee、userAddress）。
  • 不受用户隐私模式限制——已开启隐私模式的用户的成交也会返回。
  • 时间窗口：默认最近 7 天；startTime 不能早于 90 天前。