Cluster · Handbook hub
Polymarket US API for bots — what exists in 2026
If you are a US person building a bot, start with Polymarket US docs — not the International CLOB tutorials that dominate GitHub search results.
Surfaces to know (always re-check live docs)
- api.polymarket.us — REST for markets and trading
- gateway.polymarket.us — WebSocket / streaming paths
- Fees — Θ·C·p·(1−p); the published US schedule lists taker Θ as 0.06 from July 1, 2026
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 July 2026 fees
- 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.
Part of the Polymarket trading bots handbook.
Engineering Desk · Updated 2026-07-08