跳转到主要内容

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 账户。这使你能够:

​
Builder Code

你的 builder code 是一个与你的 builder 资料关联的 bytes32 标识符。可以在 polymarket.com/settings?tab=builder 中找到。 这是归属所需的唯一凭证 — 无需 HMAC 签名、无需单独的 API key,也不需要特殊的请求标头。
Builder code 是公开标识符 — 它们会出现在你归属的每个订单的链上 builder 字段中。只有你能控制哪些订单包含你的 code,所以请将其限定在你自己拥有的应用中。

​
附加 Builder Code

在你提交的每个订单的订单结构中传入 builderCode。SDK 会将其序列化到链上订单的 builder 字段,协议会将每一笔匹配的交易归属到你的资料。 
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,
);
每个附加了 builderCode 的订单都会被归属到你的 builder 资料 — 无需额外配置。

​
验证归属

查询归属到你的 builder code 的交易: 
const trades = await client.getBuilderTrades();

// Filtered by market
const marketTrades = await client.getBuilderTrades({
  market: "0xbd31dc8a...",
});
每个 BuilderTrade 包括:id、market、assetId、side、size、price、status、outcome、owner、maker、builder、transactionHash、matchTime、fee 和 feeUsdc。

​
故障排查

  • 确认你的 builderCode 已正确附加到每个订单
  • 检查订单是否已被撮合(而不仅仅是下单)
  • 交易量在排行榜上显示最多可能需要 24 小时
验证该 code 与 Builder 资料中显示的一致。Builder code 是以 0x 开头的 bytes32 十六进制值。

​
下一步

Builder Program

了解 Builder Program 的等级和奖励

创建订单

构建、签名和提交订单