name: using-polymarket-adapter description: How to use the Polymarket adapter in Wayfinder Paths for market discovery (Gamma), orderbooks/prices/history (CLOB), user positions/activity (Data API), and execution (buy/sell + redeem) using pUSD collateral on Polygon (including deposit / withdraw preparation flows). metadata: tags: wayfinder, polymarket, predictions, gamma, clob, data-api, pusd, polygon, orderbook, timeseries, execution, redemption, v2
When to use
Use this skill when you are:
- Discovering Polymarket markets/events, or doing fuzzy search by text
- Pulling orderbooks/prices and historic time series for analysis
- Computing “movers” (dark-horse → trending) across a set of markets
- Placing predictions (buy), cashing out (sell), or redeeming resolved positions
- Preparing or unwinding collateral: Polygon assets / supported bridge deposits ↔ pUSD (the V2 trading collateral)
How to use
wayfinder_paths/adapters/polymarket_adapter/README.md- Adapter overview + end-to-end cycle- rules/high-value-reads.md - Market discovery, IDs, time series, analysis patterns
- rules/deposit-wallet.md - V2 derived deposit wallet pattern (per-user smart contract, funding from owner EOA, withdraw via relayer)
- rules/deposits-withdrawals.md - Preparing pUSD collateral and unwinding back to USDC/USDC.e
- rules/execution-opportunities.md - Approvals + trading flows (buy/sell/cancel/orders)
- rules/gotchas.md - Common pitfalls (pUSD vs USDC/USDC.e, outcomes, tradability filters, rate limits)