Transaction Lifecycle

This page walks through the full life of a prediction market position on Swaps, from market discovery to withdrawal.

​

1. Discover a market

Find markets and the details needed to trade them:

• Search Markets — query by keywords or tags.
• Get Trending Markets — high-volume markets by 24h activity.
• Get Markets / Get Event — full market details.

From the market details, capture the CLOB tokenID of the outcome, the tickSize, and the negRisk flag — every order needs them. Use Get Market Price for current bid/ask.

​

2. Place an order

Choose an integration pattern:

• Chain abstracted — one getAction call that swaps any token on any chain from the user’s existing wallet and places the order.
• Direct — createOrFetchPolymarketUser, fund the deposit wallet with pUSD on Polygon, then placeOrder with an EIP-712 signature (signing guide).

​

3. Track the workflow

Every order returns a txId. Poll GET /workflows/getStatus with it to follow execution — the response reports the workflow status (pending, success, failed), the operation (e.g. placeOrder), and operation data including the order result. Monitor open positions with Get Current Positions and activity with Get Activity.

​

4. Manage the position

• Sell Position — exit before resolution with a market order (FOK/FAK).
• Redeem Position — claim winnings from a resolved market (or burn worthless outcome tokens).
• Merge Position — combine complementary YES/NO holdings back into collateral.

Every sell and redeem request is signed with EIP-712 — see the signing guide. Proceeds default to the caller’s EOA; set dstWalletAddress and/or dstToken to deliver them anywhere else.

​

5. Withdraw

Move collateral out of the deposit wallet with Withdraw — funds go to any wallet, optionally swapped into a different token or chain, authorized by an EIP-712 signature. Withdrawals are workflows too — track them with the same GET /workflows/getStatus endpoint.