Cluster · Handbook hub

Polymarket US vs International for bots

Polymarket is not one API. US and International are different access paths — and most “how to build a Polymarket bot” posts quietly assume the International path.

If you route wrong, nothing else in your stack matters. Fee math, signal quality, and your favorite GitHub repo all fail the same way: the surface you built against is not the one you are allowed to use.

Start with residency, not a repo

Before you clone anything, answer one question: which access path are you on? A US person should start from Polymarket US documentation — not from a CLOB tutorial that never mentions KYC or polymarket.us.

US pathInternational path
Docs / hostsapi.polymarket.us, gateway.polymarket.usInternational CLOB tutorials dominate GitHub
KYC / accountUS-specific onboardingDifferent eligibility rules
Fee scheduleUS schedule (Θ moved July 1, 2026)Do not assume US numbers apply
Bot riskUsing International tooling as a US personAssuming US fee tables / docs

Operator checklist (do this in order)

  1. Confirm residency and product path — US vs International is a product constraint, not a preference.
  2. Open the matching docs — if the tutorial never mentions polymarket.us, treat it as International-first until proven otherwise.
  3. Authenticate read-only — list markets before any order loop.
  4. Model fees on that path — see July 2026 US fee note.
  5. Paper or tiny size — never go from “hello world” to full size. See paper mode & risk.

What Telegram and listicles get wrong

“One bot for everyone” is marketing. Access is not universal. A SaaS that only wires International CLOB flows is not a US product. A GitHub repo with stars is not a residency certificate.

When you diligence a tool, use the Trust & Diligence Desk checklist — especially residency support and keys.

How this maps to Bot for Polymarket

Bot for Polymarket is a hosted no-code builder for Polymarket operators. We treat venue access as a first-class product constraint: waitlist updates track path support, not vibes. We do not claim every path is live for every user today — we claim we will not paper over the difference.

Venue Access Desk · Updated 2026-07-08

Join the waitlist

Get product and operator updates. Paper mode and risk limits first. No spam.

More guides