Files

T

AI Agent b2a29fe51f Update Polymarket documentation (2026-02-19)

- Added new documentation URLs from llms.txt index
- Updated TARGET.md with 244 total documentation pages
- Scraped new pages for trading, concepts, and API reference sections
- Updated changelog and new index pages

2026-02-19 14:31:02 +01:00

8.5 KiB

Raw Blame History

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 Methods

These methods require builder API credentials and are only relevant for Builders Program order attribution.

Client Initialization

Builder methods require the client to initialize with a separate builder config using credentials acquired from Polymarket.com and the @polymarket/builder-signing-sdk package.

```typescript TypeScript theme={null} import { ClobClient } from "@polymarket/clob-client"; import { BuilderConfig, BuilderApiKeyCreds } from "@polymarket/builder-signing-sdk";

  const builderConfig = new BuilderConfig({
    localBuilderCreds: new BuilderApiKeyCreds({
      key: process.env.BUILDER_API_KEY,
      secret: process.env.BUILDER_SECRET,
      passphrase: process.env.BUILDER_PASS_PHRASE,
    }),
  });

  const clobClient = new ClobClient(
    "https://clob.polymarket.com",
    137,
    signer,
    apiCreds, // User's API credentials from L1 authentication
    signatureType,
    funderAddress,
    undefined,
    false,
    builderConfig
  );
  ```

  ```python Python theme={null}
  from py_clob_client.client import ClobClient
  from py_builder_signing_sdk.config import BuilderConfig, BuilderApiKeyCreds
  import os

  builder_config = BuilderConfig(
      local_builder_creds=BuilderApiKeyCreds(
          key=os.getenv("BUILDER_API_KEY"),
          secret=os.getenv("BUILDER_SECRET"),
          passphrase=os.getenv("BUILDER_PASS_PHRASE"),
      )
  )

  clob_client = ClobClient(
      host="https://clob.polymarket.com",
      chain_id=137,
      key=os.getenv("PRIVATE_KEY"),
      creds=creds, # User's API credentials from L1 authentication
      signature_type=signature_type,
      funder=funder,
      builder_config=builder_config
  )
  ```
</CodeGroup>

```typescript TypeScript theme={null} import { ClobClient } from "@polymarket/clob-client"; import { BuilderConfig } from "@polymarket/builder-signing-sdk";

  const builderConfig = new BuilderConfig({
    remoteBuilderConfig: { url: "http://localhost:3000/sign" }
  });

  const clobClient = new ClobClient(
    "https://clob.polymarket.com",
    137,
    signer,
    apiCreds, // User's API credentials from L1 authentication
    signatureType,
    funder,
    undefined,
    false,
    builderConfig
  );
  ```

  ```python Python theme={null}
  from py_clob_client.client import ClobClient
  from py_builder_signing_sdk.config import BuilderConfig, RemoteBuilderConfig
  import os

  builder_config = BuilderConfig(
      remote_builder_config=RemoteBuilderConfig(
          url="http://localhost:3000/sign"
      )
  )

  clob_client = ClobClient(
      host="https://clob.polymarket.com",
      chain_id=137,
      key=os.getenv("PRIVATE_KEY"),
      creds=creds, # User's API credentials from L1 authentication
      signature_type=signature_type,
      funder=funder,
      builder_config=builder_config
  )
  ```
</CodeGroup>

See [Order Attribution](/trading/orders/attribution) for more information on builder signing.

Methods

getBuilderTrades()

Retrieves all trades attributed to your builder account. Use this to track which trades were routed through your platform.

async getBuilderTrades(
  params?: TradeParams,
): Promise<BuilderTradesPaginatedResponse>

Params (TradeParams)

Optional. Filter trades by trade ID. Optional. Filter trades by maker address. Optional. Filter trades by market condition ID. Optional. Filter trades by asset (token) ID. Optional. Return trades created before this cursor value. Optional. Return trades created after this cursor value.

Response (BuilderTradesPaginatedResponse)

Array of trades attributed to the builder account. Cursor string for fetching the next page of results. Maximum number of trades returned per page. Total number of trades returned in this response.

BuilderTrade fields

Unique identifier for the trade. Type of the trade. Hash of the taker order associated with this trade. Address of the builder who attributed this trade. Condition ID of the market this trade belongs to. Token ID of the asset traded. Side of the trade (e.g. BUY or SELL). Size of the trade in shares. Size of the trade denominated in USDC. Price at which the trade was executed. Current status of the trade. Outcome label associated with the traded asset. Index of the outcome within the market. Address of the order owner (taker). Address of the maker in the trade. On-chain transaction hash for the trade. Timestamp when the trade was matched. Bucket index used for trade grouping. Fee charged for the trade in shares. Fee charged for the trade denominated in USDC. Optional. Error message if the trade encountered an issue, otherwise null. Timestamp when the trade record was created, or null if unavailable. Timestamp when the trade record was last updated, or null if unavailable.

revokeBuilderApiKey()

Revokes the builder API key used to authenticate the current request. After revocation, the key can no longer be used for builder-authenticated requests.

async revokeBuilderApiKey(): Promise<any>

Response from the revocation request.

8.5 KiB Raw Blame History

Documentation Index