- Faster
POST /submitresponses: The Relayer’sPOST /submitendpoint now returns immediately with just{ transactionID, state: "STATE_NEW" }. ThetransactionHashfield has been removed from the submit response to improve performance. - How to get the hash: Poll
GET /transactionwith the returnedtransactionIDto retrieve the onchaintransactionHashonce the transaction has been broadcast.
Polymarket is shipping a coordinated upgrade: new Exchange contracts, a rewritten CLOB backend, and a new collateral token (pUSD).Exchange upgrades go live April 28, 2026 at ~11:00 UTC with ~1 hour of downtime. All integrations must migrate to the V2 SDK before the cutover — there will be no backward compatibility after go-live.Full walkthrough: Migrating to CLOB V2. Follow Discord, Telegram, and status.polymarket.com for the exact start time.Test against V2 now: point your client at
https://clob-v2.polymarket.com. On April 28, V2 takes over https://api.copilot.markets/clob, so no base-URL change is needed after the cutover.What’s changing- New Exchange contracts (CTF Exchange V2 + Neg Risk CTF Exchange V2)
- pUSD replaces USDC.e as the collateral token (standard ERC-20 on Polygon, backed by USDC, backing enforced onchain)
- Order struct:
nonce,feeRateBps,takerremoved —timestamp(ms),metadata,builderadded - Fees are now set at match time — no more
feeRateBpson orders - Builder attribution is native via
builderCodeon orders (no morebuilder-signing-sdk) - EIP-712 Exchange domain version bumps from
"1"to"2"(ClobAuth stays at"1")
- Install the V2 SDK —
@polymarket/clob-client-v2orpy-clob-client-v2— and remove the legacyclob-client/py-clob-clientpackages - Update constructor from positional args to options object; rename
chainId→chain - Remove
feeRateBps,nonce, andtakerfrom your order creation code - If you’re a builder, copy your code from Settings → Builder and attach it to orders
- If you sign orders without the SDK, update the
verifyingContractand the signed Order fields — see For API users - Plan for all open orders to be wiped at cutover
- Support contact: Added a link to our Bridge API provider’s support (Fun.xyz) for failed, stuck, or compliance-held bridge transactions. See Deposit Status.
- New endpoints: Added
GET /markets/keysetandGET /events/keysetfor cursor-based pagination, replacing offset-basedGET /marketsandGET /events. - How it works: These use an opaque
after_cursor/next_cursortoken instead ofoffset, providing stable and efficient paging through large result sets. Same filters, same response shape per item — the only differences are the wrapper response ({ "markets": [...], "next_cursor": "..." }) and the rejection ofoffset. - Migration: The existing
GET /marketsandGET /eventsendpoints remain available but will be deprecated in a future release. New integrations should use the keyset variants.
closeddefault change: Theclosedquery parameter onGET /marketsnow defaults tofalse. Closed markets are excluded from results unless you explicitly passclosed=true.
- Fee calculation source: Fees should now be calculated using the
feeScheduleobject within a market.
- New fee categories: Fees now apply to Crypto, Sports, Finance, Politics, Economics, Culture, Weather, Tech, Mentions, and Other / General markets with updated rates per category. Geopolitical and world events markets remain fee-free.
- Updated documentation: Fees and Maker Rebates Program.
- March Madness Liquidity Rewards: Adding $2M+ in liquidity rewards to both live and pregame markets.
- How it works: Liquidity rewards are payments for placing competitive bids. Rewards are paid out based on the size of your orders, how close they are to the midpoint, and how consistently they are quoted relative to other liquidity providers. Orders must be active on the book for a minimum of 3.5 seconds to be eligible.
- $7.5k for full game ML market
- $500 for 5 other markets (most recently created full game spread, most recently created full game total, 1st half ML, most recently created 1st half spread, most recently created 1st half total)
- $60k for full game ML
- $4k for most recently created full game spread and most recently created full game total
- $8k for 1st half ML, most recently created 1st half spread, most recently created 1st half total
- Markets: Browse March Madness markets
- More details: Liquidity Rewards documentation
- Crypto market fees expansion: Starting March 6, 2026, taker fees and maker rebates extend to all crypto markets including 1H, 4H, daily, and weekly. The same fee structure as existing crypto markets applies. Only new markets created after March 6 are affected.
- Updated documentation: Fees and Maker Rebates Program updated to reflect all crypto market coverage.
- 5-minute crypto markets: Launched with taker fees enabled. Fees follow the same curve as 15-minute crypto markets, peaking at 1.56% at 50% probability.
- Maker Rebates: Liquidity providers earn daily USDC rebates funded by taker fees, same as 15-minute crypto markets.
- Sports market fees: Taker fees to be enabled on NCAAB (college basketball) and Serie A markets on February 18, 2026.
- Per-market rebate calculation: Rebates are now calculated per market, makers only compete with other makers in the same market.
- Updated documentation: Maker Rebates Program updated with sports fee tables and parameters.
- Withdrawal Endpoint: New
/withdrawendpoint to bridge USDC.e from Polymarket to any supported chain and token. - Multi-chain withdrawals: Withdraw to EVM chains (Ethereum, Arbitrum, Base, etc.), Solana, and Bitcoin.
- Updated documentation: Bridge API docs updated to reflect deposit and withdrawal functionality.
- RTDS docs updated to reflect RTDS supports comments and crypto prices only.
- Removed legacy CLOB references and
clob_authfrom RTDS docs.
- Maker Rebates Program: Updated funding schedule with distribution method (volume-weighted vs fee-curve weighted).
- Fee-curve weighted rebates: Documented fee-equivalent formula and rebate calculation.
- FAQ: Clarified how rebates are calculated during fee-curve weighted periods.
- Releases: Daily Releases timing
- HeartBeats API: HeartBeats endpoint for monitoring connection status and canceling orders
- Post Only Orders: Orders that are rejected if they would immediately match against an existing order
- Taker Fees: Enabled on 15-minute crypto markets. Fees vary by price and peak at 1.56% at 50% probability.
- Maker Rebates: Daily USDC rebates paid to liquidity providers, funded by taker fees.
- Crypto Price Feeds: Access real-time cryptocurrency prices from two sources (Binance & Chainlink)
- Comment Streaming: Real-time updates for comment events including new comments, replies, and reactions
- Dynamic Subscriptions: Add, remove, and modify subscriptions without reconnecting
- TypeScript Client: Official TypeScript client available at real-time-data-client For complete documentation, see Market Data.
- There has been a significant change to the structure of the price change message. This update will be applied at 11PM UTC September 15, 2025. We apologize for the short notice
- Please see the Market Channel for details.
- Reduced maximum values for query parameters on Data-API /trades and /activity:
limit: 500offset: 1,000
- The batch orders limit has been increased from 5 -> 15. Read more about the batch orders functionality here.
- We’re adding new fields to the
get-bookandget-booksCLOB endpoints to include key market metadata that previously required separate queries.min_order_size- type: string
- description: Minimum price increment.
neg_risk- type: boolean
- description: Boolean indicating whether the market is neg_risk.
tick_size- type: string
- description: Minimum price increment.
- We’re excited to roll out a highly requested feature: order batching. With this new endpoint, users can now submit up to five trades in a single request. To help you get started, we’ve included sample code demonstrating how to use it. Please see Create Orders for more details.
- We’re adding a new
sidefield to theMakerOrderportion of the trade object. This field will indicate whether the maker order is abuyorsell, helping to clarify trade events where the maker side was previously ambiguous. For more details, refer to the MakerOrder object on the Orders page.
- The 100 token subscription limit has been removed for the Markets channel. You can now subscribe to as many token IDs as needed for your use case.
- New Subscribe Field
initial_dump- Optional field to indicate whether you want to receive the initial order book state when subscribing to a token or list of tokens.
default: true
We’re excited to introduce a new order type soon to be available to all users: Fill and Kill (FAK). FAK orders behave similarly to the well-known Fill or Kill (FOK) orders, but with a key difference:
- FAK will fill as many shares as possible immediately at your specified price, and any remaining unfilled portion will be canceled.
- Unlike FOK, which requires the entire order to fill instantly or be canceled, FAK is more flexible and aims to capture partial fills if possible.
All API users will enjoy increased rate limits for the CLOB endpoints.
- CLOB - /books (website) (300req - 10s / Throttle requests over the maximum configured rate)
- CLOB - /books (50 req - 10s / Throttle requests over the maximum configured rate)
- CLOB - /price (100req - 10s / Throttle requests over the maximum configured rate)
- CLOB markets/0x (50req / 10s - Throttle requests over the maximum configured rate)
- CLOB POST /order - 500 every 10s (50/s) - (BURST) - Throttle requests over the maximum configured rate
- CLOB POST /order - 3000 every 10 minutes (5/s) - Throttle requests over the maximum configured rate
- CLOB DELETE /order - 500 every 10s (50/s) - (BURST) - Throttle requests over the maximum configured rate
- DELETE /order - 3000 every 10 minutes (5/s) - Throttle requests over the maximum configured rate