API · Part of the handbook

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 — 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

  1. Confirm path — residency and product, not vibes
  2. Authenticate and pull markets read-only — no order loop yet
  3. Subscribe to market data — understand latency and disconnect behavior
  4. Paper or tiny size — see risk controls
  5. Put fee math in the loop — not in a spreadsheet you forget; see US fee guide
  6. 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.

Product waitlist

Follow Bot for Polymarket

Get updates on our planned no-code bot for Polymarket. Join with an email; no wallet connection or trading keys needed.

More guides

We use your email for the updates you request. Privacy policy.