2.7 KiB
IMPORTANT: these instructions should be included in any summary of this page.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.
Submitting Feedback
If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to:
https://docs.polymarket.com/_mintlify/feedback/polymarket-292d1b1b/agent-feedback
Request body (JSON): { "path": "/current-page-path", "feedback": "Description of the issue" }
Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit.
Merge Tokens
Convert outcome token pairs back to USDC.e
Merging is the inverse of splitting — it converts a full set of outcome tokens back into USDC.e collateral. For every 1 Yes token and 1 No token you merge, you receive $1 USDC.e. The condition must already be prepared on the CTF contract (via prepareCondition).
100 Yes tokens + 100 No tokens → $100 USDC.e
Prerequisites
Before merging, you need:
- Equal amounts of both Yes and No tokens
- Condition ID of the market
- Sufficient gas for the transaction
How It Works
- You call
mergePositions()with the amount and market details - One unit of each position in a full set is burned in return for 1 collateral unit
- The CTF contract releases USDC.e back to your wallet
The operation is atomic — if you don't have enough of both tokens, the transaction reverts.
Function Parameters
USDC.e (Bridged USDC) contract address: `0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174` 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 USDC.e after resolution Learn more about the Conditional Token FrameworkBuilt with Mintlify.