Update Polymarket documentation - 2026-06-12: Added 70 missing doc pages across CLOB, builders, developers, quickstart, and trading sections

docs/developers/CTF/split.md

@@ -0,0 +1,76 @@
+> ## 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.
+
+# Split Tokens
+
+> Convert pUSD into outcome token pairs
+
+**Splitting** converts pUSD collateral into a full (position) set of outcome tokens. For every \$1 pUSD you split, you receive 1 Yes token and 1 No token.
+
+```
+$100 pUSD → 100 Yes tokens + 100 No tokens
+```
+
+## Prerequisites
+
+Before splitting, ensure you have:
+
+1. **pUSD balance** on Polygon
+2. **pUSD approval** for the CTF collateral adapter to spend your tokens
+3. **Condition ID** of the market — the condition must already be prepared on the CTF contract (via `prepareCondition`)
+
+<Note>
+  Polymarket uses thin collateral adapter contracts for pUSD-native CTF actions.
+  Approve the adapter once, then route split, merge, and redeem actions through
+  it. The adapter handles the CTF collateral plumbing so user-facing flows stay
+  in pUSD.
+</Note>
+
+<Note>
+  If the partition is trivial, invalid, or refers to more slots than the
+  condition is prepared with, the transaction will revert.
+</Note>
+
+## How It Works
+
+1. You approve the CTF collateral adapter to spend your pUSD
+2. You call the adapter's split flow with the amount and market details
+3. The adapter calls the underlying CTF contract and mints both outcome tokens
+
+The operation is atomic — if any step fails, the entire transaction reverts.
+
+## Function Parameters
+
+<ResponseField name="collateralToken" type="IERC20">
+  pUSD (Polymarket USD) contract address: `0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB`
+</ResponseField>
+
+<ResponseField name="parentCollectionId" type="bytes32">
+  Always `0x0000...0000` (32 zero bytes) for Polymarket markets
+</ResponseField>
+
+<ResponseField name="conditionId" type="bytes32">
+  The market's condition ID, available from the Markets API
+</ResponseField>
+
+<ResponseField name="partition" type="uint[]">
+  Array of index sets: `[1, 2]` for binary markets (Yes = 1, No = 2)
+</ResponseField>
+
+<ResponseField name="amount" type="uint256">
+  The amount of collateral or stake to split. Also the number of full sets to
+  receive.
+</ResponseField>
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Merge Tokens" icon="merge" href="/trading/ctf/merge">
+    Convert token pairs back to pUSD
+  </Card>
+
+  <Card title="Trade on Orderbook" icon="chart-line" href="/trading/orders/create">
+    Place orders using your newly split tokens
+  </Card>
+</CardGroup>