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",