docs: sync Polymarket docs updates 2026-07-10

Updated 21 files:
- trading/orders: overview, create
- developers/CLOB/orders: orders, create-order, create-order-batch, get-order, get-active-order, check-scoring, onchain-order-info
- developers/CLOB/status
- market-makers: trading, maker-rebates, combos
- trading/fees, market-makers maker-rebates-program, trading/fees
- dev-tooling: python, typescript
- api-reference/core: get-trades-for-a-user-or-markets, get-user-activity
- changelog/changelog

docs/developers/CLOB/orders/check-scoring.md

@@ -33,9 +33,10 @@ The underlying order primitive is structured, hashed, and signed using the [EIP-
 * **GTC** and **GTD** are limit order types — they rest on the book at your specified price.
 
 <Note>
-  **GTD expiration**: There is a security threshold of one minute. If you need
-  the order to expire in 90 seconds, the correct expiration value is `now + 1
-      minute + 30 seconds`.
+  **GTD expiration**: Orders expire one minute before their stated expiration
+  as a security threshold, and the expiration must be at least three minutes
+  in the future. For a 5-minute effective lifetime, the correct expiration
+  value is `now + 1 minute + 5 minutes`.
 </Note>
 
 ### Post-Only Orders

docs/developers/CLOB/orders/create-order-batch.md

@@ -208,7 +208,7 @@ GTD orders auto-expire at a specified time. Useful for quoting around known even
       .size(dec!(10))
       .side(Side::Buy)
       .order_type(OrderType::GTD)
-      .expiration(Utc::now() + TimeDelta::hours(1))
+      .expiration(Utc::now() + TimeDelta::minutes(1) + TimeDelta::hours(1))
       .build()
       .await?;
   let signed = client.sign(&signer, order).await?;
@@ -217,9 +217,11 @@ GTD orders auto-expire at a specified time. Useful for quoting around known even
 </CodeGroup>
 
 <Note>
-  There is a security threshold of one minute on GTD expiration. To set an
-  effective lifetime of N seconds, use `now + 60 + N`. For example, for a
-  30-second effective lifetime, set the expiration to `now + 60 + 30`.
+  GTD orders expire one minute before their stated expiration as a security
+  threshold. To set an effective lifetime of N seconds, use `now + 60 + N`.
+  In addition, the expiration must be at least three minutes in the future —
+  orders expiring sooner are rejected — so the minimum effective lifetime is
+  about two minutes.
 </Note>
 
 ***

docs/developers/CLOB/orders/create-order.md

@@ -208,7 +208,7 @@ GTD orders auto-expire at a specified time. Useful for quoting around known even
       .size(dec!(10))
       .side(Side::Buy)
       .order_type(OrderType::GTD)
-      .expiration(Utc::now() + TimeDelta::hours(1))
+      .expiration(Utc::now() + TimeDelta::minutes(1) + TimeDelta::hours(1))
       .build()
       .await?;
   let signed = client.sign(&signer, order).await?;
@@ -217,9 +217,11 @@ GTD orders auto-expire at a specified time. Useful for quoting around known even
 </CodeGroup>
 
 <Note>
-  There is a security threshold of one minute on GTD expiration. To set an
-  effective lifetime of N seconds, use `now + 60 + N`. For example, for a
-  30-second effective lifetime, set the expiration to `now + 60 + 30`.
+  GTD orders expire one minute before their stated expiration as a security
+  threshold. To set an effective lifetime of N seconds, use `now + 60 + N`.
+  In addition, the expiration must be at least three minutes in the future —
+  orders expiring sooner are rejected — so the minimum effective lifetime is
+  about two minutes.
 </Note>
 
 ***

docs/developers/CLOB/orders/get-active-order.md

@@ -33,9 +33,10 @@ The underlying order primitive is structured, hashed, and signed using the [EIP-
 * **GTC** and **GTD** are limit order types — they rest on the book at your specified price.
 
 <Note>
-  **GTD expiration**: There is a security threshold of one minute. If you need
-  the order to expire in 90 seconds, the correct expiration value is `now + 1
-      minute + 30 seconds`.
+  **GTD expiration**: Orders expire one minute before their stated expiration
+  as a security threshold, and the expiration must be at least three minutes
+  in the future. For a 5-minute effective lifetime, the correct expiration
+  value is `now + 1 minute + 5 minutes`.
 </Note>
 
 ### Post-Only Orders

docs/developers/CLOB/orders/get-order.md

@@ -33,9 +33,10 @@ The underlying order primitive is structured, hashed, and signed using the [EIP-
 * **GTC** and **GTD** are limit order types — they rest on the book at your specified price.
 
 <Note>
-  **GTD expiration**: There is a security threshold of one minute. If you need
-  the order to expire in 90 seconds, the correct expiration value is `now + 1
-      minute + 30 seconds`.
+  **GTD expiration**: Orders expire one minute before their stated expiration
+  as a security threshold, and the expiration must be at least three minutes
+  in the future. For a 5-minute effective lifetime, the correct expiration
+  value is `now + 1 minute + 5 minutes`.
 </Note>
 
 ### Post-Only Orders

docs/developers/CLOB/orders/onchain-order-info.md

@@ -33,9 +33,10 @@ The underlying order primitive is structured, hashed, and signed using the [EIP-
 * **GTC** and **GTD** are limit order types — they rest on the book at your specified price.
 
 <Note>
-  **GTD expiration**: There is a security threshold of one minute. If you need
-  the order to expire in 90 seconds, the correct expiration value is `now + 1
-      minute + 30 seconds`.
+  **GTD expiration**: Orders expire one minute before their stated expiration
+  as a security threshold, and the expiration must be at least three minutes
+  in the future. For a 5-minute effective lifetime, the correct expiration
+  value is `now + 1 minute + 5 minutes`.
 </Note>
 
 ### Post-Only Orders

docs/developers/CLOB/orders/orders.md

@@ -33,9 +33,10 @@ The underlying order primitive is structured, hashed, and signed using the [EIP-
 * **GTC** and **GTD** are limit order types — they rest on the book at your specified price.
 
 <Note>
-  **GTD expiration**: There is a security threshold of one minute. If you need
-  the order to expire in 90 seconds, the correct expiration value is `now + 1
-      minute + 30 seconds`.
+  **GTD expiration**: Orders expire one minute before their stated expiration
+  as a security threshold, and the expiration must be at least three minutes
+  in the future. For a 5-minute effective lifetime, the correct expiration
+  value is `now + 1 minute + 5 minutes`.
 </Note>
 
 ### Post-Only Orders