Files
GLaDOS a1d6a46f74 docs: refresh all documentation - fill 98 empty files and update changelog
Date: 2026-06-19

Changes:
- Fixed 98 empty .md files that had failed to scrape
- Updated changelog with latest entries (Jun 15, 2026: CLOB DELETE /orders limit reduced to 1000)
- Refreshed FAQ, Polymarket Learn, Developers, and other sections

Notable updates:
- Jun 15, 2026: CLOB DELETE /orders maximum batch size reduced to 1000
- Jun 1, 2026: Increased CLOB order rate limits
- May 18, 2026: builderCode added to builders endpoints
- May 14, 2026: GET /markets/keyset limit reduced to 100
2026-06-19 14:09:52 +02:00

2.4 KiB

Documentation Index

Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt Use this file to discover all available pages before exploring further.

Merge Tokens

Convert outcome token pairs back to pUSD

Merging is the inverse of splitting — it converts a full set of outcome tokens back into pUSD collateral. For every 1 Yes token and 1 No token you merge, you receive $1 pUSD. The condition must already be prepared on the CTF contract (via prepareCondition).

100 Yes tokens + 100 No tokens → $100 pUSD

Prerequisites

Before merging, you need:

  1. Equal amounts of both Yes and No tokens
  2. Condition ID of the market
  3. Sufficient gas for the transaction
Polymarket uses thin collateral adapter contracts for pUSD-native CTF actions. Approve the adapter once, then route split, merge, and redeem actions through it. For merge flows, the adapter calls the underlying CTF contract, receives the released USDC.e collateral, wraps it into pUSD, and returns pUSD to your wallet automatically.

How It Works

  1. You call the adapter's merge flow with the amount and market details
  2. One unit of each position in a full set is burned in return for 1 collateral unit
  3. The adapter converts the released collateral into pUSD and returns pUSD to your wallet

The operation is atomic — if you don't have enough of both tokens, the transaction reverts.

Function Parameters

pUSD (Polymarket USD) contract address: `0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB` Always `0x0000...0000` (32 zero bytes) for Polymarket markets The market's condition ID, available from the Markets API Array of index sets: `[1, 2]` for binary markets The number of full sets to merge. Also the amount of collateral to receive.

Next Steps

Exchange winning tokens for pUSD after resolution Learn more about the Conditional Token Framework