跳转到主要内容
Builder Code 让集成商和合作伙伴在用户通过其应用交易时,获得部分交易手续费分成。归属于某个 Builder Code 的成交会为该代码的所有者产生 Builder 奖励。 这与推荐计划不同:推荐码用于用户注册时的归因,Builder Code 则在用户通过集成应用交易时附加。

运作方式

  1. 开发者使用自己的 QFEX 账户创建一个 Builder Code,QFEX 会生成一个 UUID。
  2. 开发者以基点为单位配置两项手续费分成(1 bp = 0.01%):
    • QFEX 的分成至少为 50%。
    • 开发者的分成最高为 50%。
    • 两项分成之和不必等于 100%。
  3. 开发者为每位终端用户单独完成身份认证,通常通过 QFEX OAuth。
  4. 在该用户的交易 WebSocket 连接进行身份认证时,自动附加自己的 Builder Code UUID。
  5. 该连接下提交的订单会根据配置产生 Builder 奖励。交易者仍支付完整交易手续费。
您不需要为每位交易者创建单独的 Builder Code,也不会将用户的 QFEX 账户永久绑定给某个开发者。Builder 归因只适用于当前交易 WebSocket 连接。 如果代码缺失或无效,交易者仍支付全额手续费,但不会向任何开发者发放 Builder 奖励。

创建 Builder Code

每个 QFEX 账户最多有一个有效的 Builder Code。
  1. 登录 qfex.com,打开个人资料。
  2. 打开 Developer Settings(开发者设置)。
  3. 在 Builder code 区域创建代码,并设置 QFEX 与开发者的手续费分成比例。
QFEX 会生成 UUID。请将其保存在应用配置中,并自动附加到需要归因的交易 WebSocket 连接。

构建聚合器或交易应用

如果您的应用需要让用户连接或创建 QFEX 账户,并通过您的集成进行交易,请阅读开发者集成指南。 推荐流程:
  1. 用户在您的应用中选择 Connect QFEX(连接 QFEX)。
  2. QFEX 负责登录、开户、多因素认证(MFA)及用户准入。
  3. 用户授权后,您的应用收到 OAuth 用户令牌。
  4. 应用打开该用户已认证的交易 WebSocket 连接。
  5. 在连接的身份认证消息中附加您自己的 Builder UUID。
  6. 该连接上的普通订单、止损单和 TWAP 订单会自动归因给您。
您的应用绝不应要求用户交出 QFEX 密码、MFA 验证码或 API 密钥。

Builder 奖励

交易者继续支付正常交易手续费。配置的开发者分成将以 Builder 奖励形式记入 Builder Code 所有者的账户。 例如,如果 QFEX 分成 50%,开发者分成 30%,那么 QFEX 保留手续费的 50%,开发者获得 30% 的 Builder 奖励,其余 20% 不作为 Builder 奖励支付。

开发者资源

完整 OAuth 及交易接入流程,请参阅开发者集成指南。 通过 REST 创建或查询 Builder Code、将其附加到交易 WebSocket 会话,或通过程序查询奖励,请参阅 Builder Codes API 参考。