Two upgrades with similar names are easy to mix up. CLOB V2 changed the exchange, the order backend and the collateral token. Protocol V2 added a second way of holding outcome positions. This guide explains both from Polymarket's own documentation, keeps the developer detail short and says where the pages are silent or disagree. A dated timeline of the changelog entries is a separate post.
What is pUSD?
Polymarket's documentation describes pUSD as the collateral token for all trading on Polymarket. Technically it is an ERC-20 token on Polygon that USDC backs. ERC-20 is a token standard, and the documentation calls pUSD a wrapper that represents a claim on USDC. The smart contract enforces the backing, and the page states there is no algorithmic peg and no fractional reserve. A complete pair of Yes and No tokens in a market is backed by 1 pUSD of value.
pUSD can be transferred like any other ERC-20 token, but it is built to work inside Polymarket: the documentation says there are no plans at present to list it on outside exchanges. Polymarket Perps use the same token, since the Perps collateral is pUSD (see the Perps guide).
Why did Polymarket introduce it?
The documentation gives a short reason: settlement in native USDC, which it describes as a standard that is more capital efficient, more scalable and better aligned with institutions as the platform grows. The collateral before pUSD was USDC.e, the bridged form of USDC, and pUSD replaced it. The pages do not compare the two tokens or say more about the decision.
How do you get pUSD?
It depends on how you use Polymarket.
- On polymarket.com. The frontend wraps your funds automatically after a one-time approval. After that you simply see a balance and trade.
- By depositing. The bridge handles the conversion: assets from other chains are converted to pUSD on Polygon automatically. You can send native USDC or bridged USDC.e.
- Through the contracts. The documentation names two groups that wrap by hand, power users and API-only traders, who wrap USDC.e into pUSD through the Collateral Onramp contract. It does not describe other interfaces.
Going the other way, a withdrawal unwraps pUSD through the Collateral Offramp, and you can also withdraw pUSD itself, though some exchanges no longer accept pUSD deposits directly. On fees, the Fees page says Polymarket charges no fee to deposit or withdraw USDC, and the Withdraw page says it does not charge withdrawal fees; a service you use along the way may charge its own.
Which wallet type does an account use?
The Wallets page says a Deposit Wallet is the default and that all account wallets deployed on or after May 4, 2026 use one, with Proxy and Safe wallets as legacy types. Polymarket 101 words it more narrowly: new API users use deposit wallets, and Safe and Proxy wallets stay supported for people and integrations that already use them. The Contracts page adds that pUSD and Polymarket account wallets work with both position systems, which are covered below.
What did CLOB V2 change?
CLOB V2 is the upgrade that introduced pUSD. Polymarket's changelog describes it as a coordinated upgrade made of new exchange contracts, a rebuilt CLOB backend and pUSD as the new collateral token. It went live on April 28, 2026 at about 11:00 UTC, and trading was paused for about 1 hour. For traders, the visible effects were these:
- Open orders were wiped, so anything resting before the cutover had to be placed again.
- Fees are set by the protocol at match time instead of being part of the signed order. The fees guide covers the rates.
- Builder attribution now runs through an optional builder code field on the order. The migration guide says builder codes enable attribution and revenue sharing for integrators.
What is Protocol V2?
Protocol V2 is a different change from CLOB V2, and its migration pages start from integrations that already use pUSD and the CTF Exchange V2 order format. The documentation says it introduces new position tokens, plus new contracts for trading, for position operations and for resolution. One naming wrinkle: the Contracts page puts the same Poly v2 badge on the pUSD token and its Onramp and Offramp contracts as on PositionManager, while the changelog and the migration guide tie pUSD to the CLOB V2 go-live, which is the reading this guide follows.
The core of Protocol V2 is a second ledger for outcome positions. Markets on the Conditional Tokens Framework (CTF) hold their Yes and No balances in the Conditional Tokens contract. Protocol V2 markets hold them in a contract called PositionManager, which passes each operation to a module: BinaryModule for a plain Yes/No market, NegRiskModule for multi-outcome events and CombinatorialModule for positions built from a set of legs. Combinatorial positions, which combine several existing outcomes into one new Yes and No pair, use Protocol V2 rather than the Conditional Tokens Framework. Orders for V2 positions settle through a separate exchange contract, ExchangeV3, and splits, merges and redemptions go through a contract called the Router.
Protocol V2 also reaches resolution. Polymarket 101 says V2 markets can also use other resolution mechanisms. The Contracts page shows the path: results go from reporter modules through an OracleAggregator to the module that owns the condition, with reporter modules named OO, Chainlink and EOA. The resolution data names a reporter for each resolved condition: UMA_OO, CHAINLINK or EOA. The pages do not expand "OO" or "EOA" or say which markets use which reporter. The resolution guide covers the UMA path in full.
How do the two position systems relate?
| Position system | Contract that holds the balances | Market logic | Outcome identifier |
|---|---|---|---|
| Polymarket Protocol V2 | PositionManager | BinaryModule, NegRiskModule or CombinatorialModule | Position ID |
| CTF (Conditional Tokens) | Conditional Tokens | The standard CTF logic or the Neg Risk Adapter | CTF token ID |
The two position systems on Polymarket. Source: docs.polymarket.com/trading/positions/how-positions-work, checked .
Both systems hold Yes and No outcomes as ERC-1155 tokens (the standard the 101 page names for outcome shares), and the documentation says those balances mean the same thing economically for a trader. Splitting pUSD into a Yes and No pair, merging a pair back and redeeming after resolution exist in both, through different contracts. The How Positions Work page warns that a CTF token ID must not be sent to PositionManager, nor a Position ID to Conditional Tokens; it says market discovery provides the identifiers each workflow needs.
What happens to what you already hold? The overview says existing CTF holdings are not converted, and the contract migration page adds that updating an integration does not convert existing CTF balances. The Contracts page also describes a migration path from CTF positions into PositionManager, but Polymarket has to register the condition or event first, and the pages do not say who can use it or when. For Polymarket app and website users, the overview says no technical migration is required beyond completing any approval prompts that appear.
What changed for traders, and what did not
What changed
- The collateral is pUSD instead of USDC.e, so balances, order costs and payouts are in pUSD.
- Some markets keep their positions on the Protocol V2 ledger, and the Polymarket app may show approval prompts.
What stayed the same
- Polymarket's pUSD page puts it this way: day to day, nothing changes. You still deposit, check a balance, trade and withdraw.
- A winning share still redeems for $1.00 each and a losing share becomes worthless, whichever system holds it.
- The Prices & Orderbook page says the order book is shared across markets, while the settlement route depends on which system holds the tokens.
- For integrations already on pUSD, the overview says the collateral, the wallets, the CLOB credentials and the endpoints are unchanged under Protocol V2.
What to check on a market page
- The resolution rules. They define how the market resolves, and some markets can use mechanisms other than UMA. See the resolution guide.
- The unit. Balances, order costs and payouts are in pUSD, not USDC.e, while a limit order is placed with a price and a number of shares.
- Approval prompts. The overview tells Polymarket app and website users to complete any approval prompts that appear. The pages do not say what those prompts approve.
- The version, if you read data. Market data from the Gamma API carries a version, "v1" for CTF markets and "v2" for Protocol V2 markets. The documentation's advice is to read the market's version field, because the presence of an ID field does not tell you. The pages used for this guide do not say that the Polymarket app displays it.
- Official notices. The changelog and the status page announce changes and incidents; the timeline post lists the dated changelog entries.
For developers
Developers had more to do. For CLOB V2, production no longer supports legacy V1 SDKs and V1-signed orders, and the order structure and signing domain changed; the guide Migrating to CLOB V2 has the details. For Protocol V2, Polymarket publishes migration pages for SDK, API and smart-contract integrations, all reached from the overview. In short, you pick identifiers by the market's version, grant fresh approvals because existing CTF permissions do not carry over to V2, sign V2 orders against the V2 exchange and keep CTF support for CTF markets. This guide stops here on purpose.
FAQ
Is pUSD the same thing as USDC?
No. pUSD is its own token: an ERC-20 on Polygon that Polymarket describes as backed by USDC, with the backing enforced by the smart contract. The documentation calls it a wrapper that represents a claim on USDC, built to work inside Polymarket, with no plans at present to list it on outside exchanges. Which form of USDC sits in the reserve is not stated (see the note above).
Do I have to convert my money to pUSD myself?
Not on polymarket.com, where the frontend handles wrapping after a one-time approval, and not when you deposit through the bridge, which converts automatically. The documentation names two groups that wrap by hand: power users and API-only traders. It does not describe other interfaces.
What happens to my old positions under Protocol V2?
The overview says existing CTF holdings are not converted. The Contracts page describes a migration for registered conditions, but the pages do not say who can use it or when. The documentation says balances on both systems mean the same thing economically for a trader.
When did Protocol V2 start?
The pages used for this guide do not give a date for it. They do date the CLOB V2 upgrade that introduced pUSD, which went live on April 28, 2026. The timeline post lists the dated changelog entries and what stays undated.
Sources and checks
- Polymarket USD
- Migrating to CLOB V2
- Migrate to Polymarket Protocol V2
- Polymarket Protocol V2 SDK Migration
- Polymarket Protocol V2 API Migration
- Polymarket Protocol V2 Contract Migration
- Positions & Tokens
- How Positions Work
- Combinatorial Positions
- Prices & Orderbook
- Onchain Position Data
- Market Details
- Place Orders
- Contracts
- Wallets and Authentication
- Deposit
- Withdraw
- Fees
- Perps concepts
- Polymarket 101
- Predictions changelog
Every rule quoted in this article comes from the registry below. Each row names the official page and the day it was compared with the text.
All 52 rules used in this article
| Rule | Value | Official source | Checked |
|---|---|---|---|
| What pUSD is | the collateral token for all trading on Polymarket | docs.polymarket.com/ | |
| CLOB V2 go-live date | April 28, 2026 | docs.polymarket.com/ | |
| Existing CTF holdings under Protocol V2 | are not converted | docs.polymarket.com/ | |
| What Polymarket app and website users need to do for Protocol V2 | no technical migration is required beyond completing any approval prompts that appear | docs.polymarket.com/ | |
| Token standard and network of pUSD | an ERC-20 token on Polygon that USDC backs | docs.polymarket.com/ | |
| How the backing of pUSD works | no algorithmic peg and no fractional reserve | docs.polymarket.com/ | |
| Value that backs a complete Yes and No set | 1 pUSD | docs.polymarket.com/ | |
| External listing of pUSD | no plans at present to list it on outside exchanges | docs.polymarket.com/ | |
| Perps collateral | pUSD | docs.polymarket.com/ | |
| Polymarket's stated reason for pUSD | settlement in native USDC | docs.polymarket.com/ | |
| How polymarket.com users get pUSD | wraps your funds automatically after a one-time approval | docs.polymarket.com/ | |
| What the bridge does with a deposit | assets from other chains are converted to pUSD on Polygon automatically | docs.polymarket.com/ | |
| Source assets accepted for a deposit | native USDC or bridged USDC.e | docs.polymarket.com/ | |
| How API-only traders get pUSD | wrap USDC.e into pUSD through the Collateral Onramp contract | docs.polymarket.com/ | |
| Exchanges and direct pUSD deposits | some exchanges no longer accept pUSD deposits directly | docs.polymarket.com/ | |
| Polymarket fee to deposit or withdraw | no fee | docs.polymarket.com/ | |
| Polymarket fee on withdrawals | does not charge withdrawal fees | docs.polymarket.com/ | |
| Wrapping while an asset is paused | fails if the admin has paused USDC.e | docs.polymarket.com/ | |
| Unwrapping while an asset is paused | uses the same pause gate | docs.polymarket.com/ | |
| Which asset the Collateral Onramp wraps | must be USDC.e | docs.polymarket.com/ | |
| What the Deposit page says about native USDC and USDC.e | native USDC and bridged USDC.e are both wrapped into pUSD by the Collateral Onramp | docs.polymarket.com/ | |
| What the Withdraw page says about unwrapping | is unwrapped to USDC by the Collateral Offramp and then swapped into native USDC | docs.polymarket.com/ | |
| Date from which new account wallets are Deposit Wallets | May 4, 2026 | docs.polymarket.com/ | |
| Which accounts use deposit wallets, as Polymarket 101 words it | use deposit wallets | docs.polymarket.com/ | |
| Status of Safe and Proxy wallets | stay supported for people and integrations that already use them | docs.polymarket.com/ | |
| Which position systems pUSD serves | work with both position systems | docs.polymarket.com/ | |
| What the CLOB V2 upgrade consisted of | new exchange contracts, a rebuilt CLOB backend and pUSD as the new collateral token | docs.polymarket.com/ | |
| Time of day of the CLOB V2 cutover | about 11:00 UTC | docs.polymarket.com/ | |
| Trading pause during the CLOB V2 cutover | about 1 hour | docs.polymarket.com/ | |
| Open orders at the CLOB V2 cutover | were wiped | docs.polymarket.com/ | |
| When fees are set under CLOB V2 | by the protocol at match time | docs.polymarket.com/ | |
| Builder attribution under CLOB V2 | an optional builder code field on the order | docs.polymarket.com/ | |
| Starting point assumed by the Protocol V2 migration pages | already use pUSD and the CTF Exchange V2 order format | docs.polymarket.com/ | |
| What Protocol V2 introduces | new position tokens, plus new contracts for trading, for position operations and for resolution | docs.polymarket.com/ | |
| Poly v2 badge on the Contracts page | puts the same Poly v2 badge on the pUSD token and its Onramp and Offramp contracts as on PositionManager | docs.polymarket.com/ | |
| Which system combinatorial positions use | use Protocol V2 rather than the Conditional Tokens Framework | docs.polymarket.com/ | |
| Resolution mechanisms of Protocol V2 markets | can also use other resolution mechanisms | docs.polymarket.com/ | |
| How results reach a Protocol V2 market | results go from reporter modules through an OracleAggregator to the module that owns the condition | docs.polymarket.com/ | |
| Reporter families named in a resolution row | UMA_OO, CHAINLINK or EOA | docs.polymarket.com/ | |
| Economic meaning of balances on the two position systems | mean the same thing economically for a trader | docs.polymarket.com/ | |
| CTF token IDs and Position IDs | a CTF token ID must not be sent to PositionManager, nor a Position ID to Conditional Tokens | docs.polymarket.com/ | |
| Updating an integration and CTF balances | updating an integration does not convert existing CTF balances | docs.polymarket.com/ | |
| When a CTF holder can migrate to PositionManager | Polymarket has to register the condition or event first | docs.polymarket.com/ | |
| What pUSD changes in daily use | day to day, nothing changes | docs.polymarket.com/ | |
| Redemption value of a winning token | $1.00 each | docs.polymarket.com/ | |
| The order book across the two position systems | is shared across markets, while the settlement route depends on which system holds the tokens | docs.polymarket.com/ | |
| What stays the same for integrations already on pUSD | the collateral, the wallets, the CLOB credentials and the endpoints are unchanged | docs.polymarket.com/ | |
| How a limit order is sized | a limit order is placed with a price and a number of shares | docs.polymarket.com/ | |
| How to tell which position system a market uses | read the market's version field, because the presence of an ID field does not tell you | docs.polymarket.com/ | |
| What production no longer supports after the CLOB V2 cutover | legacy V1 SDKs and V1-signed orders | docs.polymarket.com/ | |
| CTF permissions and Protocol V2 approvals | existing CTF permissions do not carry over to V2 | docs.polymarket.com/ | |
| The two position systems on Polymarket | Position systems | docs.polymarket.com/ |
Keep reading
Basics · 9 min
How Polymarket Works: Markets, Prices, Shares
A trader's 101 of Polymarket: events and markets, Yes and No shares, prices as probabilities, pUSD collateral, the order book, resolution and redemption.
Basics · 10 min
How Polymarket Markets Resolve: UMA Process
How a Polymarket market resolves through the UMA oracle: the rules that decide it, proposals and bonds, disputes, the vote, and what winners redeem.
Basics · 8 min
Polymarket Fees Explained
Polymarket prediction market fees explained: the taker fee formula, rates by category, why fees peak at 50 cents, maker rebates, builder fees and 2026 changes.
Oct 19, 2026 · 5 min
Polymarket CLOB V2 and pUSD: A Dated Timeline
A dated timeline of Polymarket's CLOB V2 and pUSD upgrade, what the official docs say about Protocol V2, and what they leave undated.
PolyTerminal is an independent interface for Polymarket and is not operated or endorsed by Polymarket. Orders placed through PolyTerminal carry PolyTerminal’s Polymarket builder code, and PolyTerminal may charge a builder fee on top of Polymarket’s own fees. This page is educational and is not investment advice. Rules were compared with the official documentation on Oct 19, 2026; check the source before you act on a number.