docs: daily sync Polymarket docs 2026-06-28 - refresh 50 updated files

docs/api-reference/bridge/create-bridge-addresses.md

@@ -27,6 +27,8 @@ paths:
       tags:
         - Bridge
       summary: Create bridge addresses
+      parameters:
+        - $ref: '#/components/parameters/BuilderCodeHeader'
       requestBody:
         required: true
         content:
@@ -43,7 +45,9 @@ paths:
               schema:
                 $ref: '#/components/schemas/DepositResponse'
         '400':
-          description: Bad Request - Invalid address or request body
+          description: >-
+            Bad Request - Invalid address, request body, or malformed
+            X-Builder-Code
           content:
             application/json:
               schema:
@@ -55,6 +59,21 @@ paths:
               schema:
                 $ref: '#/components/schemas/ErrorResponse'
 components:
+  parameters:
+    BuilderCodeHeader:
+      name: X-Builder-Code
+      in: header
+      required: false
+      description: >
+        Optional builder code (bytes32 hex) attributing this request to your
+        integration so transfer issues can be traced to your app. Omitting it
+        still succeeds but returns a `missing_builder_code` warning; a malformed
+        code returns 400. Get your code at
+        https://polymarket.com/settings?tab=builder
+      schema:
+        type: string
+        pattern: ^0x[a-fA-F0-9]{64}$
+        example: '0x00000000000000000000000000000000000000000000000000000000abcd1234'
   schemas:
     DepositRequest:
       type: object

docs/api-reference/bridge/create-withdrawal-addresses.md

@@ -27,6 +27,8 @@ paths:
       tags:
         - Bridge
       summary: Create withdrawal addresses
+      parameters:
+        - $ref: '#/components/parameters/BuilderCodeHeader'
       requestBody:
         required: true
         content:
@@ -54,7 +56,7 @@ paths:
                   Send funds to these addresses to bridge to your destination
                   chain and token.
         '400':
-          description: Bad Request - Invalid or missing parameters
+          description: Bad Request - Invalid/missing parameters or malformed X-Builder-Code
           content:
             application/json:
               schema:
@@ -66,6 +68,21 @@ paths:
               schema:
                 $ref: '#/components/schemas/ErrorResponse'
 components:
+  parameters:
+    BuilderCodeHeader:
+      name: X-Builder-Code
+      in: header
+      required: false
+      description: >
+        Optional builder code (bytes32 hex) attributing this request to your
+        integration so transfer issues can be traced to your app. Omitting it
+        still succeeds but returns a `missing_builder_code` warning; a malformed
+        code returns 400. Get your code at
+        https://polymarket.com/settings?tab=builder
+      schema:
+        type: string
+        pattern: ^0x[a-fA-F0-9]{64}$
+        example: '0x00000000000000000000000000000000000000000000000000000000abcd1234'
   schemas:
     WithdrawalRequest:
       type: object

docs/api-reference/core/get-user-activity.md

@@ -88,6 +88,9 @@ paths:
                 - REDEEM
                 - REWARD
                 - CONVERSION
+                - DEPOSIT
+                - WITHDRAWAL
+                - YIELD
                 - MAKER_REBATE
                 - TAKER_REBATE
                 - REFERRAL_REWARD
@@ -96,6 +99,10 @@ paths:
           schema:
             type: integer
             minimum: 0
+          description: >-
+            Lower-bound timestamp (epoch seconds) for the activity window. Omit
+            or pass `0` for the default window (most recent ~3 years); pass a
+            positive epoch (e.g. `1`) to retrieve full history.
         - in: query
           name: end
           schema:
@@ -183,6 +190,9 @@ components:
             - REDEEM
             - REWARD
             - CONVERSION
+            - DEPOSIT
+            - WITHDRAWAL
+            - YIELD
             - MAKER_REBATE
             - TAKER_REBATE
             - REFERRAL_REWARD

docs/api-reference/geoblock.md

@@ -56,6 +56,7 @@ The following countries are restricted from placing orders on Polymarket. Countr
 | BE           | Belgium                              | Blocked                |
 | BY           | Belarus                              | Blocked                |
 | BI           | Burundi                              | Blocked                |
+| BR           | Brazil                               | Blocked                |
 | CF           | Central African Republic             | Blocked                |
 | CD           | Congo (Kinshasa)                     | Blocked                |
 | CU           | Cuba                                 | Blocked                |

docs/api-reference/wss/user.md

@@ -549,7 +549,7 @@ operations:
                   - RETRYING
                   - FAILED
                 required: true
-              - name: matchtime
+              - name: match_time
                 type: string
                 required: false
               - name: last_update
@@ -684,7 +684,7 @@ operations:
                 - RETRYING
                 - FAILED
               x-parser-schema-id: <anonymous-schema-42>
-            matchtime:
+            match_time:
               type: string
               x-parser-schema-id: <anonymous-schema-43>
             last_update:
@@ -780,7 +780,7 @@ operations:
             "price": "0.57",
             "fee_rate_bps": "0",
             "status": "MATCHED",
-            "matchtime": "1672290701",
+            "match_time": "1672290701",
             "last_update": "1672290701",
             "outcome": "YES",
             "owner": "9180014b-33c8-9240-a14b-bdca11c0a465",

docs/builders/overview.md

@@ -85,6 +85,13 @@ A **builder** is a person, group, or organization that routes orders from users
   </Step>
 </Steps>
 
+<Note>
+  Bridging user funds in or out via the Bridge API? Also pass your code via the
+  optional `X-Builder-Code` header on [`/deposit`](/trading/bridge/deposit) and
+  [`/withdraw`](/trading/bridge/withdraw) so bridge traffic is attributed to your
+  integration.
+</Note>
+
 ## SDKs and Libraries
 
 <CardGroup cols={2}>

docs/changelog/changelog.md

@@ -6,6 +6,10 @@
 
 > Welcome to the Polymarket Changelog. Here you will find any important changes to Polymarket, including but not limited to CLOB, API, UI and Mobile Applications.
 
+<Update label="Jun 25, 2026" description="Bridge API: optional X-Builder-Code header">
+  * **New optional header**: `POST /deposit` and `POST /withdraw` now accept an `X-Builder-Code` header (bytes32 hex) for builder attribution. Without it, requests still succeed but return a `missing_builder_code` warning; a malformed code returns `400`. See [Deposit](/trading/bridge/deposit) and [Withdraw](/trading/bridge/withdraw).
+</Update>
+
 <Update label="Jun 15, 2026" description="CLOB DELETE /orders maximum batch size reduced to 1000">
   * **`DELETE /orders` limit**: The maximum number of order IDs per cancel request is now `1000`. Split larger cancellation batches across multiple requests.
 </Update>

docs/dev-tooling/python.md

@@ -1102,6 +1102,10 @@ Secure clients expose the API credentials created for the authenticated session.
 
 ## Changelog
 
+### `0.1.0b10`
+
+* Preserve `group_item_title` on market responses so grouped market titles remain available after normalization.
+
 ### `0.1.0b9`
 
 * RFQ quoter sessions now emit typed `RfqTradeEvent` events for confirmed Combos fills.

docs/dev-tooling/typescript.md

@@ -1103,6 +1103,10 @@ Secure clients expose the API credentials created for the authenticated session.
 
 ## Changelog
 
+### `0.1.0-beta.9`
+
+* Added `PriceHistoryInterval` and `SearchSort` exports, preserved `groupItemTitle` on normalized markets, and published `expectPrivateKey` from `@polymarket/types`.
+
 ### `0.1.0-beta.8`
 
 * RFQ quoter sessions now emit typed `trade` events for confirmed Combos fills.

docs/developers/CLOB/geoblock.md

@@ -56,6 +56,7 @@ The following countries are restricted from placing orders on Polymarket. Countr
 | BE           | Belgium                              | Blocked                |
 | BY           | Belarus                              | Blocked                |
 | BI           | Burundi                              | Blocked                |
+| BR           | Brazil                               | Blocked                |
 | CF           | Central African Republic             | Blocked                |
 | CD           | Congo (Kinshasa)                     | Blocked                |
 | CU           | Cuba                                 | Blocked                |

docs/developers/builders/builder-intro.md

@@ -85,6 +85,13 @@ A **builder** is a person, group, or organization that routes orders from users
   </Step>
 </Steps>
 
+<Note>
+  Bridging user funds in or out via the Bridge API? Also pass your code via the
+  optional `X-Builder-Code` header on [`/deposit`](/trading/bridge/deposit) and
+  [`/withdraw`](/trading/bridge/withdraw) so bridge traffic is attributed to your
+  integration.
+</Note>
+
 ## SDKs and Libraries
 
 <CardGroup cols={2}>

docs/developers/builders/builder-profile.md

@@ -85,6 +85,13 @@ A **builder** is a person, group, or organization that routes orders from users
   </Step>
 </Steps>
 
+<Note>
+  Bridging user funds in or out via the Bridge API? Also pass your code via the
+  optional `X-Builder-Code` header on [`/deposit`](/trading/bridge/deposit) and
+  [`/withdraw`](/trading/bridge/withdraw) so bridge traffic is attributed to your
+  integration.
+</Note>
+
 ## SDKs and Libraries
 
 <CardGroup cols={2}>

docs/developers/builders/examples.md

@@ -85,6 +85,13 @@ A **builder** is a person, group, or organization that routes orders from users
   </Step>
 </Steps>
 
+<Note>
+  Bridging user funds in or out via the Bridge API? Also pass your code via the
+  optional `X-Builder-Code` header on [`/deposit`](/trading/bridge/deposit) and
+  [`/withdraw`](/trading/bridge/withdraw) so bridge traffic is attributed to your
+  integration.
+</Note>
+
 ## SDKs and Libraries
 
 <CardGroup cols={2}>

docs/developers/misc-endpoints/bridge-overview.md

@@ -19,9 +19,20 @@ Polymarket uses **pUSD** (Polymarket USD) on Polygon as collateral for all tradi
 
 Generate unique bridge addresses linked to your Polymarket wallet. See the [Bridge API Reference](/api-reference/introduction) for full request and response schemas.
 
+<Tip>
+  **Builders: attach your code.** If you route user funds through this endpoint,
+  pass your builder code via the optional `X-Builder-Code` header (bytes32 hex;
+  `0x` + 64 hex chars). It lets our bridge provider attribute traffic to your
+  app, so stuck or delayed transfers can be traced and prioritized. The header is
+  optional. Requests without it still succeed but return a `missing_builder_code`
+  warning, and a malformed code returns `400`. Get your code at [Settings →
+  Builder](https://polymarket.com/settings?tab=builder).
+</Tip>
+
 ```bash theme={null}
 curl -X POST https://bridge.polymarket.com/deposit \
   -H "Content-Type: application/json" \
+  -H "X-Builder-Code: <YOUR_BUILDER_CODE>" \
   -d '{"address": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"}'
 ```
 

docs/market-data/websocket/user-channel.md

@@ -64,7 +64,7 @@ Emitted when:
     }
   ],
   "market": "0xbd31dc8a20211944f6b70f31557f1001557b59905b7738480ca09bd4532f84af",
-  "matchtime": "1672290701",
+  "match_time": "1672290701",
   "outcome": "YES",
   "owner": "9180014b-33c8-9240-a14b-bdca11c0a465",
   "price": "0.57",

docs/market-makers/combos.md

@@ -70,6 +70,11 @@ This guide shows market makers how to handle Combo RFQs. You will open a quoting
 session, respond to incoming requests, cancel submitted quotes when needed,
 confirm fills through Last Look, and monitor execution updates.
 
+<Note>
+  For development updates on market making for Combos, join the [Combos market
+  maker Telegram group](https://t.me/+eyMtdtKasWZjYTMx).
+</Note>
+
 ## Start Quoting
 
 Start by preparing an authenticated quoting session with the RFQ system. You
@@ -1602,9 +1607,26 @@ request cancellation.
 
 ### Last Look
 
-Last Look is a separate confirmation step for makers that have it enabled. If a
-selected quote requires confirmation, run a final risk check before the
-confirmation deadline and either confirm or decline the quote.
+Last Look is a separate final review step for makers that have it enabled. If a
+selected quote requires Last Look, run a final risk check before the deadline and
+accept or reject the fill.
+
+Last Look is offered to makers with approximately \$2,500 in Combo notional
+volume and an established line of communication with Polymarket. This keeps the
+program reliable and helps Polymarket resolve system issues quickly.
+
+To request access, complete the [Last Look request
+form](https://forms.gle/dk5A1DRw8EN5uP9z5).
+
+<Warning>
+  Makers are expected to accept most selected quotes. We track acceptance rates,
+  and makers who reject more than 15% of selected quotes over a one-hour lookback
+  window may be paused from quoting for a few minutes.
+</Warning>
+
+Once access is enabled, your quoting system will immediately be asked to review
+selected fills. Make sure it is ready to evaluate and answer them before approval
+is activated.
 
 <Tabs>
   <Tab title="TypeScript">

docs/polymarket-learn/FAQ/geoblocking.md

@@ -56,6 +56,7 @@ The following countries are restricted from placing orders on Polymarket. Countr
 | BE           | Belgium                              | Blocked                |
 | BY           | Belarus                              | Blocked                |
 | BI           | Burundi                              | Blocked                |
+| BR           | Brazil                               | Blocked                |
 | CF           | Central African Republic             | Blocked                |
 | CD           | Congo (Kinshasa)                     | Blocked                |
 | CU           | Cuba                                 | Blocked                |

docs/polymarket-learn/deposits/large-cross-chain-deposits.md

@@ -19,9 +19,20 @@ Polymarket uses **pUSD** (Polymarket USD) on Polygon as collateral for all tradi
 
 Generate unique bridge addresses linked to your Polymarket wallet. See the [Bridge API Reference](/api-reference/introduction) for full request and response schemas.
 
+<Tip>
+  **Builders: attach your code.** If you route user funds through this endpoint,
+  pass your builder code via the optional `X-Builder-Code` header (bytes32 hex;
+  `0x` + 64 hex chars). It lets our bridge provider attribute traffic to your
+  app, so stuck or delayed transfers can be traced and prioritized. The header is
+  optional. Requests without it still succeed but return a `missing_builder_code`
+  warning, and a malformed code returns `400`. Get your code at [Settings →
+  Builder](https://polymarket.com/settings?tab=builder).
+</Tip>
+
 ```bash theme={null}
 curl -X POST https://bridge.polymarket.com/deposit \
   -H "Content-Type: application/json" \
+  -H "X-Builder-Code: <YOUR_BUILDER_CODE>" \
   -d '{"address": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"}'
 ```
 

docs/trading/bridge/deposit.md

@@ -19,9 +19,20 @@ Polymarket uses **pUSD** (Polymarket USD) on Polygon as collateral for all tradi
 
 Generate unique bridge addresses linked to your Polymarket wallet. See the [Bridge API Reference](/api-reference/introduction) for full request and response schemas.
 
+<Tip>
+  **Builders: attach your code.** If you route user funds through this endpoint,
+  pass your builder code via the optional `X-Builder-Code` header (bytes32 hex;
+  `0x` + 64 hex chars). It lets our bridge provider attribute traffic to your
+  app, so stuck or delayed transfers can be traced and prioritized. The header is
+  optional. Requests without it still succeed but return a `missing_builder_code`
+  warning, and a malformed code returns `400`. Get your code at [Settings →
+  Builder](https://polymarket.com/settings?tab=builder).
+</Tip>
+
 ```bash theme={null}
 curl -X POST https://bridge.polymarket.com/deposit \
   -H "Content-Type: application/json" \
+  -H "X-Builder-Code: <YOUR_BUILDER_CODE>" \
   -d '{"address": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"}'
 ```
 

docs/trading/bridge/withdraw.md

@@ -42,9 +42,20 @@ Withdraw pUSD from your Polymarket wallet to any supported chain and token. Fund
 
 Generate bridge addresses configured for your withdrawal destination. See the [Bridge API Reference](/api-reference/introduction) for full request and response schemas.
 
+<Tip>
+  **Builders: attach your code.** If you route user funds through this endpoint,
+  pass your builder code via the optional `X-Builder-Code` header (bytes32 hex;
+  `0x` + 64 hex chars). It lets our bridge provider attribute traffic to your
+  app, so stuck or delayed transfers can be traced and prioritized. The header is
+  optional. Requests without it still succeed but return a `missing_builder_code`
+  warning, and a malformed code returns `400`. Get your code at [Settings →
+  Builder](https://polymarket.com/settings?tab=builder).
+</Tip>
+
 ```bash theme={null}
 curl -X POST https://bridge.polymarket.com/withdraw \
   -H "Content-Type: application/json" \
+  -H "X-Builder-Code: <YOUR_BUILDER_CODE>" \
   -d '{
     "address": "0x9156dd10bea4c8d7e2d591b633d1694b1d764756",
     "toChainId": "1",

docs/trading/taker-rebates.md

@@ -172,6 +172,11 @@ Your tier shows on your Polymarket profile and on the leaderboards. As you climb
     table above. Geopolitical and world events markets are free to trade and
     earn no Weighted Volume.
   </Accordion>
+
+  <Accordion title="Are third-party integrations using omnibus wallets eligible">
+    No. Third-party integrations using omnibus wallets are not eligible for the
+    Taker Rebate Program.
+  </Accordion>
 </AccordionGroup>
 
 ***