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

# 订单归属

> 将订单归属到你的 builder code,以获得交易量积分和手续费奖励

订单归属通过将你的 **builder code** 附加到每个订单,将交易计入你的 builder 账户。这使你能够:

* 在 [Builder 排行榜](https://builders.polymarket.com/)上追踪交易量
* 通过 [Builder Program](/builders/overview) 获得手续费奖励
* 通过 Data API 监控绩效

***

## Builder Code

你的 **builder code** 是一个与你的 builder 资料关联的 `bytes32` 标识符。可以在 [polymarket.com/settings?tab=builder](https://polymarket.com/settings?tab=builder) 中找到。

这是归属所需的唯一凭证 — 无需 HMAC 签名、无需单独的 API key,也不需要特殊的请求标头。

<Note>
  Builder code 是公开标识符 — 它们会出现在你归属的每个订单的链上 `builder` 字段中。只有你能控制哪些订单包含你的 code,所以请将其限定在你自己拥有的应用中。
</Note>

***

## 附加 Builder Code

在你提交的每个订单的订单结构中传入 `builderCode`。SDK 会将其序列化到链上订单的 `builder` 字段,协议会将每一笔匹配的交易归属到你的资料。

<CodeGroup>
  ```typescript TypeScript theme={null}
  import { ClobClient, Side, OrderType } from "@polymarket/clob-client-v2";

  const client = new ClobClient({
    host: "https://clob.polymarket.com",
    chain: 137,
    signer,
    creds: apiCreds,
    signatureType: 2,
    funderAddress,
  });

  const response = await client.createAndPostOrder(
    {
      tokenID: "0x...",
      price: 0.55,
      size: 100,
      side: Side.BUY,
      builderCode: "0xabc123...", // your builder code from polymarket.com/settings?tab=builder
    },
    { tickSize: "0.01", negRisk: false },
    OrderType.GTC,
  );
  ```

  ```python Python theme={null}
  from py_clob_client_v2 import ClobClient
  from py_clob_client_v2 import OrderArgs, OrderType, PartialCreateOrderOptions
  from py_clob_client_v2.order_builder.constants import BUY

  client = ClobClient(
      host="https://clob.polymarket.com",
      chain_id=137,
      key=private_key,
      creds=api_creds,
      signature_type=2,
      funder=funder_address,
  )

  response = client.create_and_post_order(
      OrderArgs(
          token_id="0x...",
          price=0.55,
          size=100,
          side=BUY,
          builder_code="0xabc123...",  # your builder code from polymarket.com/settings?tab=builder
      ),
      options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False),
      order_type=OrderType.GTC,
  )
  ```
</CodeGroup>

每个附加了 `builderCode` 的订单都会被归属到你的 builder 资料 — 无需额外配置。

***

## 验证归属

查询归属到你的 builder code 的交易:

<CodeGroup>
  ```typescript TypeScript theme={null}
  const trades = await client.getBuilderTrades();

  // Filtered by market
  const marketTrades = await client.getBuilderTrades({
    market: "0xbd31dc8a...",
  });
  ```

  ```python Python theme={null}
  trades = client.get_builder_trades()

  market_trades = client.get_builder_trades(
      market="0xbd31dc8a..."
  )
  ```
</CodeGroup>

每个 `BuilderTrade` 包括:`id`、`market`、`assetId`、`side`、`size`、`price`、`status`、`outcome`、`owner`、`maker`、`builder`、`transactionHash`、`matchTime`、`fee` 和 `feeUsdc`。

***

## 故障排查

<AccordionGroup>
  <Accordion title="交易量未显示在排行榜上">
    * 确认你的 `builderCode` 已正确附加到每个订单
    * 检查订单是否已被撮合(而不仅仅是下单)
    * 交易量在排行榜上显示最多可能需要 24 小时
  </Accordion>

  <Accordion title="无效的 builder code">
    验证该 code 与 [Builder 资料](https://polymarket.com/settings?tab=builder)中显示的一致。Builder code 是以 `0x` 开头的 `bytes32` 十六进制值。
  </Accordion>
</AccordionGroup>

***

## 下一步

<CardGroup cols={2}>
  <Card title="Builder Program" icon="hammer" href="/builders/overview">
    了解 Builder Program 的等级和奖励
  </Card>

  <Card title="创建订单" icon="plus" href="/trading/orders/create">
    构建、签名和提交订单
  </Card>
</CardGroup>