docs: sync with docs.polymarket.com - 2026-05-08

docs/api-reference/authentication.md

@@ -266,14 +266,15 @@ The `POLY_SIGNATURE` for L2 is an HMAC-SHA256 signature created using the user's
 
     const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
     const signer = createWalletClient({ account, transport: http() });
+    const depositWalletAddress = process.env.DEPOSIT_WALLET_ADDRESS!;
 
     const client = new ClobClient({
       host: "https://clob.polymarket.com",
       chain: 137,
       signer,
       creds: apiCreds, // Generated from L1 auth, API credentials enable L2 methods
-      signatureType: 1, // signatureType explained below
+      signatureType: 3, // POLY_1271, explained below
-      funderAddress, // funder explained below
+      funderAddress: depositWalletAddress, // deposit wallet funder
     });
 
     // Now you can trade!
@@ -295,8 +296,8 @@ The `POLY_SIGNATURE` for L2 is an HMAC-SHA256 signature created using the user's
         chain_id=137,
         key=os.getenv("PRIVATE_KEY"),
         creds=api_creds,  # Generated from L1 auth, API credentials enable L2 methods
-        signature_type=1,  # signatureType explained below
+        signature_type=3,  # POLY_1271, explained below
-        funder=os.getenv("FUNDER_ADDRESS") # funder explained below
+        funder=os.getenv("DEPOSIT_WALLET_ADDRESS")
     )
 
     # Now you can trade!
@@ -312,10 +313,12 @@ The `POLY_SIGNATURE` for L2 is an HMAC-SHA256 signature created using the user's
     use polymarket_client_sdk_v2::clob::types::{Side, SignatureType};
     use polymarket_client_sdk_v2::types::dec;
 
+    let deposit_wallet = std::env::var("DEPOSIT_WALLET_ADDRESS")?.parse()?;
+
     let client = Client::new("https://clob.polymarket.com", Config::default())?
         .authentication_builder(&signer)
-        .signature_type(SignatureType::Proxy) // signatureType explained below
+        .funder(deposit_wallet)
-        // Funder auto-derived via CREATE2 for Proxy/GnosisSafe
+        .signature_type(SignatureType::Poly1271)
         .authenticate()
         .await?;
 
@@ -343,17 +346,18 @@ The `POLY_SIGNATURE` for L2 is an HMAC-SHA256 signature created using the user's
 
 When initializing the L2 client, you must specify your wallet **signatureType** and the **funder** address which holds the funds:
 
-| Signature Type | Value | Description                                                                                                                                                                                  |
+| Signature Type | Value | Description                                                                                                                |
-| -------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| -------------- | ----- | -------------------------------------------------------------------------------------------------------------------------- |
-| EOA            | `0`   | Standard Ethereum wallet (MetaMask). Funder is the EOA address and will need POL to pay gas on transactions.                                                                                 |
+| EOA            | `0`   | Standard Ethereum wallet (MetaMask). Funder is the EOA address and will need POL to pay gas on transactions.               |
-| POLY\_PROXY    | `1`   | A custom proxy wallet only used with users who logged in via Magic Link email/Google. Using this requires the user to have exported their PK from Polymarket.com and imported into your app. |
+| POLY\_PROXY    | `1`   | Existing Polymarket proxy wallet flow, commonly used by users who logged in via Magic Link email/Google.                   |
-| GNOSIS\_SAFE   | `2`   | Gnosis Safe multisig proxy wallet (most common). Use this for any new or returning user who does not fit the other 2 types.                                                                  |
+| GNOSIS\_SAFE   | `2`   | Existing Gnosis Safe wallet flow. Existing Safe users can continue using this type.                                        |
+| POLY\_1271     | `3`   | Deposit wallet flow for new API users. The funder is the deposit wallet address and orders are validated through ERC-1271. |
 
 <Tip>
-  The wallet address displayed to the user on Polymarket.com is the proxy wallet
+  New API users should use deposit wallets with `POLY_1271`. Existing Safe and
-  and should be used as the funder. These can be deterministically derived or
+  Proxy users are unaffected and can keep using their current funder address and
-  you can deploy them on behalf of the user. These proxy wallets are
+  signature type. See the [Deposit Wallet Guide](/trading/deposit-wallets) for
-  automatically deployed for the user on their first login to Polymarket.com.
+  setup details.
 </Tip>
 
 ***

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

@@ -106,4 +106,4 @@ components:
       pattern: ^0x[a-fA-F0-9]{40}$
       example: '0x56687bf447db6ffa42ffe2204a05edaa20f55839'
 
-````
+````

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

@@ -132,4 +132,4 @@ components:
       pattern: ^0x[a-fA-F0-9]{40}$
       example: '0x56687bf447db6ffa42ffe2204a05edaa20f55839'
 
-````
+````

docs/api-reference/bridge/get-a-quote.md

@@ -221,4 +221,4 @@ components:
           description: Impact cost of the transaction
           example: 0
 
-````
+````

docs/api-reference/bridge/get-supported-assets.md

@@ -96,4 +96,4 @@ components:
           description: Token decimals
           example: 6
 
-````
+````

docs/api-reference/bridge/get-transaction-status.md

@@ -151,4 +151,4 @@ components:
             when status is DEPOSIT_DETECTED)
           example: 1757531217339
 
-````
+````

docs/api-reference/builders/get-aggregated-builder-leaderboard.md

@@ -113,4 +113,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/builders/get-daily-builder-volume-time-series.md

@@ -102,4 +102,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/clients-sdks.md

@@ -77,7 +77,9 @@ Each repository includes working examples in the `/examples` directory.
 
 ## Relayer SDK
 
-For [gasless transactions](/trading/gasless) using proxy wallets, the relayer client handles submitting transactions through Polymarket's relayer:
+For [gasless transactions](/trading/gasless), the relayer client handles deposit
+wallet creation and signed wallet batches for new API users. Existing Safe and
+Proxy wallet flows remain supported.
 
 | Language   | Package                              | Repository                                                                                                 |
 | ---------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------- |

docs/api-reference/comments/get-comments-by-comment-id.md

@@ -209,4 +209,4 @@ components:
           type: string
           nullable: true
 
-````
+````

docs/api-reference/comments/get-comments-by-user-address.md

@@ -234,4 +234,4 @@ components:
           type: string
           nullable: true
 
-````
+````

docs/api-reference/comments/list-comments.md

@@ -248,4 +248,4 @@ components:
           type: string
           nullable: true
 
-````
+````

docs/api-reference/core/get-closed-positions-for-a-user.md

@@ -191,4 +191,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/core/get-current-positions-for-a-user.md

@@ -218,4 +218,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/core/get-positions-for-a-market.md

@@ -190,4 +190,4 @@ components:
         outcomeIndex:
           type: integer
 
-````
+````

docs/api-reference/core/get-top-holders-for-markets.md

@@ -137,4 +137,4 @@ components:
       pattern: ^0x[a-fA-F0-9]{40}$
       example: '0x56687bf447db6ffa42ffe2204a05edaa20f55839'
 
-````
+````

docs/api-reference/core/get-total-value-of-a-users-positions.md

@@ -94,4 +94,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/core/get-trader-leaderboard-rankings.md

@@ -158,4 +158,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/core/get-trades-for-a-user-or-markets.md

@@ -190,4 +190,4 @@ components:
       required:
         - error
 
-````
+````

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

@@ -229,4 +229,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/data-api-status/data-api-health-check.md

@@ -1 +1 @@
-null
+null

docs/api-reference/data/get-midpoint-price.md

@@ -102,4 +102,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/data/get-server-time.md

@@ -78,4 +78,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/events/get-event-by-id.md

@@ -1210,4 +1210,4 @@ components:
           type: number
           nullable: true
 
-````
+````

docs/api-reference/events/get-event-by-slug.md

@@ -1210,4 +1210,4 @@ components:
           type: number
           nullable: true
 
-````
+````

docs/api-reference/events/get-event-tags.md

@@ -105,4 +105,4 @@ components:
           type: boolean
           nullable: true
 
-````
+````

docs/api-reference/events/list-events-keyset-pagination.md

@@ -1468,4 +1468,4 @@ components:
           type: number
           nullable: true
 
-````
+````

docs/api-reference/events/list-events.md

@@ -1320,4 +1320,4 @@ components:
           type: number
           nullable: true
 
-````
+````

docs/api-reference/gamma-status/gamma-api-health-check.md

@@ -1 +1 @@
-null
+null

docs/api-reference/market-data/get-fee-rate-by-path-parameter.md

@@ -112,4 +112,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/market-data/get-fee-rate.md

@@ -115,4 +115,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/market-data/get-last-trade-price.md

@@ -111,4 +111,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/market-data/get-last-trade-prices-query-parameters.md

@@ -131,4 +131,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/market-data/get-last-trade-prices-request-body.md

@@ -148,4 +148,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/market-data/get-market-price.md

@@ -130,4 +130,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/market-data/get-market-prices-query-parameters.md

@@ -127,4 +127,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/market-data/get-market-prices-request-body.md

@@ -142,4 +142,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/market-data/get-midpoint-prices-query-parameters.md

@@ -101,4 +101,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/market-data/get-midpoint-prices-request-body.md

@@ -120,4 +120,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/market-data/get-order-book.md

@@ -190,4 +190,4 @@ components:
           description: Order size
           example: '100'
 
-````
+````

docs/api-reference/market-data/get-order-books-request-body.md

@@ -190,4 +190,4 @@ components:
           description: Order size
           example: '100'
 
-````
+````

docs/api-reference/market-data/get-spread.md

@@ -100,4 +100,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/market-data/get-spreads.md

@@ -118,4 +118,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/market-data/get-tick-size-by-path-parameter.md

@@ -112,4 +112,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/market-data/get-tick-size.md

@@ -116,4 +116,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/markets/get-batch-prices-history.md

@@ -135,4 +135,4 @@ components:
           type: number
           format: float
 
-````
+````

docs/api-reference/markets/get-market-by-id.md

@@ -1206,4 +1206,4 @@ components:
           type: string
           nullable: true
 
-````
+````

docs/api-reference/markets/get-market-by-slug.md

@@ -1206,4 +1206,4 @@ components:
           type: string
           nullable: true
 
-````
+````

docs/api-reference/markets/get-market-tags-by-id.md

@@ -105,4 +105,4 @@ components:
           type: boolean
           nullable: true
 
-````
+````

docs/api-reference/markets/get-prices-history.md

@@ -134,4 +134,4 @@ components:
           type: number
           format: float
 
-````
+````

docs/api-reference/markets/get-sampling-markets.md

@@ -180,4 +180,4 @@ components:
         winner:
           type: boolean
 
-````
+````

docs/api-reference/markets/get-sampling-simplified-markets.md

@@ -127,4 +127,4 @@ components:
         winner:
           type: boolean
 
-````
+````

docs/api-reference/markets/get-simplified-markets.md

@@ -127,4 +127,4 @@ components:
         winner:
           type: boolean
 
-````
+````

docs/api-reference/markets/list-markets-keyset-pagination.md

@@ -1422,4 +1422,4 @@ components:
           type: string
           nullable: true
 
-````
+````

docs/api-reference/markets/list-markets.md

@@ -1333,4 +1333,4 @@ components:
           type: string
           nullable: true
 
-````
+````

docs/api-reference/misc/download-an-accounting-snapshot-zip-of-csvs.md

@@ -74,4 +74,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/misc/get-live-volume-for-an-event.md

@@ -91,4 +91,4 @@ components:
       pattern: ^0x[a-fA-F0-9]{64}$
       example: '0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917'
 
-````
+````

docs/api-reference/misc/get-open-interest.md

@@ -84,4 +84,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/misc/get-total-markets-a-user-has-traded.md

@@ -85,4 +85,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/orderbook/get-multiple-order-books-summaries-by-request.md

@@ -1 +1 @@
-null
+null

docs/api-reference/orderbook/get-order-book-summary.md

@@ -1 +1 @@
-null
+null

docs/api-reference/pricing/get-market-price.md

@@ -1 +1 @@
-null
+null

docs/api-reference/pricing/get-midpoint-price.md

@@ -1 +1 @@
-null
+null

docs/api-reference/pricing/get-multiple-market-prices-by-request.md

@@ -1 +1 @@
-null
+null

docs/api-reference/pricing/get-multiple-market-prices.md

@@ -1 +1 @@
-null
+null

docs/api-reference/pricing/get-price-history-for-a-traded-token.md

@@ -1 +1 @@
-null
+null

docs/api-reference/profiles/get-public-profile-by-wallet-address.md

@@ -151,4 +151,4 @@ components:
           type: boolean
           description: Whether the user is a moderator
 
-````
+````

docs/api-reference/rebates/get-current-rebated-fees-for-a-maker.md

@@ -155,4 +155,4 @@ components:
           type: string
           description: Error message
 
-````
+````

docs/api-reference/relayer-api-keys/get-all-relayer-api-keys.md

@@ -136,4 +136,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/relayer/check-if-a-safe-is-deployed.md

@@ -103,4 +103,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/relayer/get-a-transaction-by-id.md

@@ -205,4 +205,4 @@ components:
       pattern: ^0x[a-fA-F0-9]{40}$
       example: '0x6e0c80c90ea6c15917308F820Eac91Ce2724B5b5'
 
-````
+````

docs/api-reference/relayer/get-current-nonce-for-a-user.md

@@ -118,4 +118,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/relayer/get-recent-transactions-for-a-user.md

@@ -266,4 +266,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/relayer/get-relayer-address-and-nonce.md

@@ -123,4 +123,4 @@ components:
       required:
         - error
 
-````
+````

docs/api-reference/relayer/submit-a-transaction.md

@@ -293,4 +293,4 @@ components:
           description: Refund receiver address
           example: '0x0000000000000000000000000000000000000000'
 
-````
+````

docs/api-reference/rewards/get-current-active-rewards-configurations.md

@@ -224,4 +224,4 @@ components:
         - start_date
         - rate_per_day
 
-````
+````

docs/api-reference/rewards/get-earnings-for-user-by-date.md

@@ -255,4 +255,4 @@ components:
       name: POLY_TIMESTAMP
       description: Unix timestamp of the request
 
-````
+````

docs/api-reference/rewards/get-multiple-markets-with-rewards.md

@@ -404,4 +404,4 @@ components:
         - start_date
         - rate_per_day
 
-````
+````

docs/api-reference/rewards/get-raw-rewards-for-a-specific-market.md

@@ -284,4 +284,4 @@ components:
         - start_date
         - rate_per_day
 
-````
+````

docs/api-reference/rewards/get-reward-percentages-for-user.md

@@ -172,4 +172,4 @@ components:
       name: POLY_TIMESTAMP
       description: Unix timestamp of the request
 
-````
+````

docs/api-reference/rewards/get-total-earnings-for-user-by-date.md

@@ -217,4 +217,4 @@ components:
       name: POLY_TIMESTAMP
       description: Unix timestamp of the request
 
-````
+````

docs/api-reference/rewards/get-user-earnings-and-markets-configuration.md

@@ -494,4 +494,4 @@ components:
       name: POLY_TIMESTAMP
       description: Unix timestamp of the request
 
-````
+````

docs/api-reference/search/search-markets-events-and-profiles.md

@@ -1364,4 +1364,4 @@ components:
           type: number
           nullable: true
 
-````
+````

docs/api-reference/series/get-series-by-id.md

@@ -1206,4 +1206,4 @@ components:
           type: number
           nullable: true
 
-````
+````

docs/api-reference/series/list-series.md

@@ -1256,4 +1256,4 @@ components:
           type: number
           nullable: true
 
-````
+````

docs/api-reference/sports/get-sports-metadata-information.md

@@ -87,4 +87,4 @@ components:
             Series identifier linking the sport to a specific tournament or
             season series
 
-````
+````

docs/api-reference/sports/get-valid-sports-market-types.md

@@ -62,4 +62,4 @@ components:
           items:
             type: string
 
-````
+````

docs/api-reference/sports/list-teams.md

@@ -134,4 +134,4 @@ components:
           format: date-time
           nullable: true
 
-````
+````

docs/api-reference/spreads/get-bid-ask-spreads.md

@@ -1 +1 @@
-null
+null

docs/api-reference/tags/get-related-tags-relationships-by-tag-id.md

@@ -91,4 +91,4 @@ components:
           type: integer
           nullable: true
 
-````
+````

docs/api-reference/tags/get-related-tags-relationships-by-tag-slug.md

@@ -91,4 +91,4 @@ components:
           type: integer
           nullable: true
 
-````
+````

docs/api-reference/tags/get-tag-by-id.md

@@ -106,4 +106,4 @@ components:
           type: boolean
           nullable: true
 
-````
+````

docs/api-reference/tags/get-tag-by-slug.md

@@ -106,4 +106,4 @@ components:
           type: boolean
           nullable: true
 
-````
+````

docs/api-reference/tags/get-tags-related-to-a-tag-id.md

@@ -114,4 +114,4 @@ components:
           type: boolean
           nullable: true
 
-````
+````

docs/api-reference/tags/get-tags-related-to-a-tag-slug.md

@@ -114,4 +114,4 @@ components:
           type: boolean
           nullable: true
 
-````
+````

docs/api-reference/tags/list-tags.md

@@ -130,4 +130,4 @@ components:
           type: boolean
           nullable: true
 
-````
+````

docs/api-reference/trade/cancel-all-orders.md

@@ -167,4 +167,4 @@ components:
       name: POLY_TIMESTAMP
       description: Unix timestamp of the request
 
-````
+````

docs/api-reference/trade/cancel-multiple-orders.md

@@ -207,4 +207,4 @@ components:
       name: POLY_TIMESTAMP
       description: Unix timestamp of the request
 
-````
+````

docs/api-reference/trade/cancel-orders-for-a-market.md

@@ -202,4 +202,4 @@ components:
       name: POLY_TIMESTAMP
       description: Unix timestamp of the request
 
-````
+````

docs/api-reference/trade/cancel-single-order.md

@@ -191,4 +191,4 @@ components:
       name: POLY_TIMESTAMP
       description: Unix timestamp of the request
 
-````
+````