Polymarket CLOB API

What it is

The trading half of Polymarket, and the only place its prices actually come from. The CLOB API at clob.polymarket.com serves the order book for an outcome token, the best bid and ask, the midpoint, the spread and the last traded price, in single and batch form — and then, behind authentication, takes orders, cancels them and reports your open ones.

The split from the Gamma API is not cosmetic. Reading a book here takes nothing at all; placing an order takes a wallet, a signed message, derived credentials, a per-request HMAC signature and collateral on Polygon. Those are two different products with two different sets of preconditions, which is why they are two cards.

Real-time comes as two WebSocket channels: a public market channel carrying book snapshots, price changes, last trade prices and tick-size changes, and an authenticated user channel carrying your own orders and fills.

Availability

Trading is blocked in the United States on this platform. Polymarket's international site says so in its own words and offers a US visitor view-only mode, directing them to Polymarket US — a separate entity operating as a CFTC-designated contract market, with its own app and its own API. The footer states plainly that the international platform is not regulated by the CFTC.

Nor is it only the United States: the jurisdictions above are the venue's reach as set out on the Polymarket card, which blocks the United Kingdom and most of western Europe as well. Where the venue does serve you, availability is a wallet question rather than a signup question. There is no KYC step in the documented flow: control of a Polygon address, a signature, and collateral are the whole of it. That also means there is no account to be refused, and no support desk that reviewed your case — the geoblock is applied to the order itself. Polymarket's Geographic Restrictions page, read on 4 October 2026, says orders submitted from blocked regions are rejected, lists which jurisdictions are blocked or close-only on the API as well as on the web app (the United States among them; Ireland is close-only on the web app alone), and documents GET polymarket.com/api/geoblock, which returns a blocked flag for the caller's location — the check to run before an order is signed, not after it fails.

For a developer this is the sharp edge worth knowing before you build: the read endpoints will answer you from anywhere, so a successful read proves nothing about whether you may trade what you just read.

Pricing

The API is free. The trades are not.

Polymarket charges takers only, and the fee is a curve rather than a rate: fee = shares × feeRate × price × (1 − price). The rate depends on the market's category — 0.07 for crypto, 0.05 for sports, economics, culture, weather and the general bucket, 0.04 for finance, politics, mentions and tech, and zero on geopolitical and world-event markets. Because of the price × (1 − price) term, the fee in dollars peaks at 50 cents and falls symmetrically toward both ends: on a 100-share crypto trade Polymarket's own table shows $1.75 at 50 cents and 33 cents at 5 cents or 95 cents. Makers pay nothing and are rebated a share of taker fees daily.

This card's figure is that general 0.05 rate expressed at its worst point — 1.25% of a dollar of payout on a fill at 50 cents. Read the category table before budgeting, because the spread between crypto and a geopolitical market is the whole fee.

Deposits and withdrawals carry no Polymarket fee, though the docs note that intermediaries may charge their own.

Markets & resolution

Resolution is the UMA optimistic oracle, not Polymarket's judgement. An outcome is proposed against a bond of roughly 750 pUSD — since September 2025 only by whitelisted addresses on markets where Polymarket applies UMA's proposer whitelist; there is a two-hour challenge window in which anyone may dispute; a dispute triggers a second proposal round, and a second dispute escalates to a UMA token-holder vote after a debate period of 24 to 48 hours. Polymarket's published timeline is about two hours undisputed and four to six days disputed.

Three consequences for code:

• A market that stops trading has not paid. Redemption happens after resolution, through the collateral adapter, and returns pUSD.
• A UMA vote can return "Unknown", in which case the market resolves 50/50 and both tokens redeem at 50 cents.
• Rules can be clarified after trading starts, through an on-chain bulletin board entry that voters are expected to weigh. The clarification cannot change the intent of the question, but it can change which real-world result counts.

Integrations

REST plus two WebSocket channels, with unified TypeScript and Python SDKs published by Polymarket and an OpenAPI description linked from the docs. Authentication is two layers: an EIP-712 ClobAuth message signed by the wallet (L1) to create or derive API credentials, then HMAC-SHA256 request signing with a key, secret and passphrase (L2). The signed payload is timestamp plus method plus path plus the exact body bytes, which is the usual place an implementation goes wrong.

Price history is still here, and on its way out. GET /prices-history, keyed by token ID, and a batch form for up to 20 tokens are in the CLOB OpenAPI description and the rate-limit table — 1,000 requests per 10 seconds, read on 1 October 2026. Polymarket's changelog of 4 September 2026 names GET /v2/prices-history on the Data API as the replacement, with explicit window forms and second-based buckets, and gives the CLOB route no retirement date. New code belongs on the v2 route.

Limitations

• No US trading on this platform, whatever the endpoint will answer.
• Rate limits are per IP, and over them a request waits rather than fails. The published table is enforced by Cloudflare per IP address and per endpoint — POST /order at 5,000 per 10 seconds burst and 120,000 per 10 minutes sustained, read on 27 September 2026 — and excess requests are delayed or queued, so the first symptom is latency, not an error. The builder tiers add only "Standard" and "Highest", with no figure. Why your bot gets throttled has the rest of the table.
• No test environment. There is no sandbox or testnet for the production CLOB; rehearsal means small live orders.
• Fees are a formula with a per-category coefficient, so a single number on any comparison page — including this one — is an approximation.
• The matching engine restarts. Polymarket documents maintenance windows and a post-restart post-only mode, which a naive bot will read as rejected orders.
• No historical order book. You can reconstruct prices from the history endpoint, but the depth that produced them is not retained.

Alternatives

For discovery and market metadata against the same venue, use the Polymarket Gamma API — it is the other half of the same integration and needs none of the signing above. If the trading side has to be a US-regulated exchange with identity verification, that is the Kalshi API. For an on-chain book with maker rebates and a much shorter market lifespan, see the Limitless API.

Trades by wallet, positions, holders and leaderboards are on the Polymarket Data API, which needs no key either.