> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qfex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Builder Codes（开发者分成代码）

> 创建 Builder Code、接入 QFEX 交易并获得开发者奖励

Builder Code 让集成商和合作伙伴在用户通过其应用交易时，获得部分交易手续费分成。归属于某个 Builder Code 的成交会为该代码的所有者产生 **Builder 奖励**。

这与[推荐计划](https://docs.qfex.com/cn/qfex/referral.md)不同：推荐码用于用户注册时的归因，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](https://qfex.com)，打开个人资料。
2. 打开 **Developer Settings（开发者设置）**。
3. 在 **Builder code** 区域创建代码，并设置 QFEX 与开发者的手续费分成比例。

QFEX 会生成 UUID。请将其保存在应用配置中，并自动附加到需要归因的交易 WebSocket 连接。

## 构建聚合器或交易应用

如果您的应用需要让用户连接或创建 QFEX 账户，并通过您的集成进行交易，请阅读[开发者集成指南](https://docs.qfex.com/cn/api-reference/builder-integration.md)。

推荐流程：

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 及交易接入流程，请参阅[开发者集成指南](https://docs.qfex.com/cn/api-reference/builder-integration.md)。

通过 REST 创建或查询 Builder Code、将其附加到交易 WebSocket 会话，或通过程序查询奖励，请参阅 [Builder Codes API 参考](https://docs.qfex.com/cn/api-reference/builder-codes.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.