Surfaces to know (always re-check live docs)
- api.polymarket.us — REST for markets and trading
- gateway.polymarket.us — WebSocket / streaming paths
- Fees — use the updated US fee guide; standard trades, combos and some products have different schedules.
Hostnames and paths change. If a tutorial never mentions polymarket.us, assume it is International-first until you prove otherwise. See the Venue Access Desk guide.
Recommended build order
- Confirm path — residency and product, not vibes
- Authenticate and pull markets read-only — no order loop yet
- Subscribe to market data — understand latency and disconnect behavior
- Paper or tiny size — see risk controls
- Put fee math in the loop — not in a spreadsheet you forget; see US fee guide
- Understand the book — order book basics for bots
What “hello world” tutorials skip
- Reconnect and clock skew
- Partial fills and cancel races
- Fee drag at mid-price
- Kill switches when the book looks wrong
Join the Bot for Polymarket waitlist for product updates.
Fee references and product status updated October 7, 2026: Polymarket US fee schedule.
Part of the Polymarket trading bots handbook.