PolyTerminal
Language en
Open Terminal

Basics guide

Polymarket pUSD and Protocol V2 Explained

What pUSD is, how you get it, what the CLOB V2 upgrade changed and how Protocol V2 positions relate to Conditional Tokens, explained for traders.

  • By PolyTerminal Team
  • Checked against the docs
  • Updated
  • 9 min read
On this page

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 systemContract that holds the balancesMarket logicOutcome identifier
Polymarket Protocol V2PositionManagerBinaryModule, NegRiskModule or CombinatorialModulePosition ID
CTF (Conditional Tokens)Conditional TokensThe standard CTF logic or the Neg Risk AdapterCTF 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

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
RuleValueOfficial sourceChecked
What pUSD isthe collateral token for all trading on Polymarketdocs.polymarket.com/concepts/pusd
CLOB V2 go-live dateApril 28, 2026docs.polymarket.com/v2-migration
Existing CTF holdings under Protocol V2are not converteddocs.polymarket.com/migrate/polymarket-v2/overview
What Polymarket app and website users need to do for Protocol V2no technical migration is required beyond completing any approval prompts that appeardocs.polymarket.com/migrate/polymarket-v2/overview
Token standard and network of pUSDan ERC-20 token on Polygon that USDC backsdocs.polymarket.com/concepts/pusd
How the backing of pUSD worksno algorithmic peg and no fractional reservedocs.polymarket.com/concepts/pusd
Value that backs a complete Yes and No set1 pUSDdocs.polymarket.com/concepts/positions-tokens
External listing of pUSDno plans at present to list it on outside exchangesdocs.polymarket.com/concepts/pusd
Perps collateralpUSDdocs.polymarket.com/perps/concepts
Polymarket's stated reason for pUSDsettlement in native USDCdocs.polymarket.com/concepts/pusd
How polymarket.com users get pUSDwraps your funds automatically after a one-time approvaldocs.polymarket.com/v2-migration
What the bridge does with a depositassets from other chains are converted to pUSD on Polygon automaticallydocs.polymarket.com/trading/bridge/deposit
Source assets accepted for a depositnative USDC or bridged USDC.edocs.polymarket.com/trading/bridge/deposit
How API-only traders get pUSDwrap USDC.e into pUSD through the Collateral Onramp contractdocs.polymarket.com/v2-migration
Exchanges and direct pUSD depositssome exchanges no longer accept pUSD deposits directlydocs.polymarket.com/trading/bridge/withdraw
Polymarket fee to deposit or withdrawno feedocs.polymarket.com/trading/fees
Polymarket fee on withdrawalsdoes not charge withdrawal feesdocs.polymarket.com/trading/bridge/withdraw
Wrapping while an asset is pausedfails if the admin has paused USDC.edocs.polymarket.com/concepts/pusd
Unwrapping while an asset is pauseduses the same pause gatedocs.polymarket.com/concepts/pusd
Which asset the Collateral Onramp wrapsmust be USDC.edocs.polymarket.com/concepts/pusd
What the Deposit page says about native USDC and USDC.enative USDC and bridged USDC.e are both wrapped into pUSD by the Collateral Onrampdocs.polymarket.com/trading/bridge/deposit
What the Withdraw page says about unwrappingis unwrapped to USDC by the Collateral Offramp and then swapped into native USDCdocs.polymarket.com/trading/bridge/withdraw
Date from which new account wallets are Deposit WalletsMay 4, 2026docs.polymarket.com/trading/wallets-auth
Which accounts use deposit wallets, as Polymarket 101 words ituse deposit walletsdocs.polymarket.com/polymarket-101
Status of Safe and Proxy walletsstay supported for people and integrations that already use themdocs.polymarket.com/polymarket-101
Which position systems pUSD serveswork with both position systemsdocs.polymarket.com/resources/contracts
What the CLOB V2 upgrade consisted ofnew exchange contracts, a rebuilt CLOB backend and pUSD as the new collateral tokendocs.polymarket.com/changelog/predictions
Time of day of the CLOB V2 cutoverabout 11:00 UTCdocs.polymarket.com/v2-migration
Trading pause during the CLOB V2 cutoverabout 1 hourdocs.polymarket.com/v2-migration
Open orders at the CLOB V2 cutoverwere wipeddocs.polymarket.com/v2-migration
When fees are set under CLOB V2by the protocol at match timedocs.polymarket.com/v2-migration
Builder attribution under CLOB V2an optional builder code field on the orderdocs.polymarket.com/v2-migration
Starting point assumed by the Protocol V2 migration pagesalready use pUSD and the CTF Exchange V2 order formatdocs.polymarket.com/migrate/polymarket-v2/api-integrations
What Protocol V2 introducesnew position tokens, plus new contracts for trading, for position operations and for resolutiondocs.polymarket.com/migrate/polymarket-v2/overview
Poly v2 badge on the Contracts pageputs the same Poly v2 badge on the pUSD token and its Onramp and Offramp contracts as on PositionManagerdocs.polymarket.com/resources/contracts
Which system combinatorial positions useuse Protocol V2 rather than the Conditional Tokens Frameworkdocs.polymarket.com/trading/positions/combinatorial
Resolution mechanisms of Protocol V2 marketscan also use other resolution mechanismsdocs.polymarket.com/polymarket-101
How results reach a Protocol V2 marketresults go from reporter modules through an OracleAggregator to the module that owns the conditiondocs.polymarket.com/resources/contracts
Reporter families named in a resolution rowUMA_OO, CHAINLINK or EOAdocs.polymarket.com/api-reference/markets/get-resolution-state
Economic meaning of balances on the two position systemsmean the same thing economically for a traderdocs.polymarket.com/concepts/positions-tokens
CTF token IDs and Position IDsa CTF token ID must not be sent to PositionManager, nor a Position ID to Conditional Tokensdocs.polymarket.com/trading/positions/how-positions-work
Updating an integration and CTF balancesupdating an integration does not convert existing CTF balancesdocs.polymarket.com/migrate/polymarket-v2/contract-integrations
When a CTF holder can migrate to PositionManagerPolymarket has to register the condition or event firstdocs.polymarket.com/resources/contracts
What pUSD changes in daily useday to day, nothing changesdocs.polymarket.com/concepts/pusd
Redemption value of a winning token$1.00 eachdocs.polymarket.com/concepts/resolution
The order book across the two position systemsis shared across markets, while the settlement route depends on which system holds the tokensdocs.polymarket.com/concepts/prices-orderbook
What stays the same for integrations already on pUSDthe collateral, the wallets, the CLOB credentials and the endpoints are unchangeddocs.polymarket.com/migrate/polymarket-v2/overview
How a limit order is sizeda limit order is placed with a price and a number of sharesdocs.polymarket.com/trading/place-orders
How to tell which position system a market usesread the market's version field, because the presence of an ID field does not tell youdocs.polymarket.com/market-data/market-details
What production no longer supports after the CLOB V2 cutoverlegacy V1 SDKs and V1-signed ordersdocs.polymarket.com/v2-migration
CTF permissions and Protocol V2 approvalsexisting CTF permissions do not carry over to V2docs.polymarket.com/migrate/polymarket-v2/api-integrations
The two position systems on PolymarketPosition systemsdocs.polymarket.com/trading/positions/how-positions-work

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.

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.