Opening checkout

Prediction markets14 min read

Polymarket API (2026): US Access, Docs and Geoblock Check

US traders get API keys at polymarket.us/developer after ID checks. GET polymarket.com/api/geoblock shows if the international API blocks you (US: close-only).

By QuantVPS Team

Published
Updated
Reviewed by
Sarah, Trading Analyst

The Polymarket US developer portal, at polymarket.us/developer, is where you create API keys for the Polymarket US API. Only Polymarket US account holders who have passed identity verification in the Polymarket US app can get keys. The international Polymarket API is a separate product with its own docs, and its geoblock check is covered below.

Polymarket US is a dedicated platform regulated by the CFTC, so verified U.S. users can now trade prediction markets through an API. It offers REST and WebSocket endpoints for real-time market data, automated trading bots and AI integration. A Polymarket VPS keeps a bot online around the clock. Key features include:

  • Real-time data streaming via WebSockets, with up to 100 markets per subscription.
  • Central Limit Order Book (CLOB) for detailed market depth and order flow analysis.
  • Tools for building bots with Python and TypeScript SDKs.
  • Regulatory compliance with secure Ed25519 API key authentication.

Polymarket API docs:

U.S. traders can now deploy advanced trading strategies, leveraging low-latency infrastructure and legal clarity. This update removes barriers for developers, opening new opportunities in prediction markets. To start, see how to set up a Polymarket trading bot or compare Polymarket vs Kalshi.

Keep your platform running while you're away.

What the Polymarket API Offers

Polymarket homepage, October 2026

The Polymarket US Retail API is split into an authenticated API for trading and a public API for market data, plus 2 WebSocket endpoints. Its main areas are Markets, Events, Orders, Portfolio and Account, with Series, Sports and Search on the public side. These endpoints enable a variety of functions, from retrieving market data to executing trades and managing portfolios.

Real-Time CLOB Data Access

The API provides direct access to Polymarket's Central Limit Order Book (CLOB), offering a detailed view of market depth, best bid and offer (BBO) prices, and settlement details. Unlike automated market makers, the CLOB model reveals all pending orders, making it easier to calculate slippage and optimize trades. The Retail API allows 25 requests per second in general (checked on 7 Nov 2026), so streaming is the better way to follow prices. Through the /v1/ws/markets endpoint, you can subscribe to real-time updates for up to 100 markets per subscription.

For traders using quantitative strategies, this level of access allows you to track order flow, identify liquidity changes, and respond to market shifts in milliseconds.

Building Automated Trading Bots

With real-time data at your fingertips, the API is well-suited for developing automated trading bots. It supports MARKET orders (executed immediately at current prices) and LIMIT orders (executed only at a specified price). These features enable both simple event-driven trades and more complex market-making strategies.

SDKs for Python 3.10+ and TypeScript streamline tasks like Ed25519 authentication and error handling. The TypeScript SDK needs Node.js 18+.

To begin, you'll need to generate API keys via the developer portal after completing identity verification through the iOS app. Keep in mind that the secret key is displayed only once, so storing it securely is crucial. Once authenticated, your bot can place orders, cancel them (individually or in bulk), and preview the potential impact of orders before execution.

Connecting AI and Quantitative Models

The API's WebSocket data can integrate with machine learning frameworks, allowing AI models to process live updates, spot pricing irregularities, and execute trades in real time. You can also filter, paginate, and sort market queries to tailor the data for your specific needs.

For institutional traders, market makers and partners such as independent software vendors (ISVs), Polymarket US offers direct exchange access over REST, gRPC and FIX, covered in its trader guide. However, the Retail API already provides individual developers and smaller trading teams with everything needed to implement advanced strategies, from arbitrage to trend-following algorithms. By combining the API's data feed with stable, low-latency infrastructure, you can run a bot around the clock without interruptions. This setup represents a significant step forward for U.S. developers working in prediction markets.

Polymarket US API vs the International Polymarket API

Polymarket runs two separate APIs: the Polymarket US API for verified users of its CFTC-regulated U.S. exchange, and the international Polymarket API for the crypto-based platform at polymarket.com. They use different accounts, keys, endpoints and docs, so a bot built for one does not work on the other.

Feature Polymarket US API International Polymarket API
Platform CFTC-regulated exchange (DCM and DCO), trades in U.S. dollars Crypto-based platform on Polygon, settles in pUSD (backed by USDC)
Who can trade Polymarket US account holders who pass identity verification Users outside restricted regions; the U.S. is close-only
Docs docs.polymarket.us docs.polymarket.com
REST base URLs https://api.polymarket.us (authenticated) and https://gateway.polymarket.us (public) Gamma, CLOB, Data API and Relayer (see the table below)
Authentication API key with Ed25519-signed request headers L1 wallet signature, then L2 HMAC API credentials
Funding In the app: debit card, bank transfer (ACH), Apple Pay, PayPal, Venmo, USDC (iPhone, where available) or wire pUSD in your polymarket.com account wallet
WebSockets wss://api.polymarket.us/v1/ws/markets and /v1/ws/private wss://ws-subscriptions-clob.polymarket.com/ws/market and /ws/user

Checked on docs.polymarket.com and docs.polymarket.us on 10 Oct 2026.

How the Polymarket Geoblock Check Works

Polymarket's geoblock endpoint tells you whether the international platform will accept orders from where you are. Send a plain GET request to https://polymarket.com/api/geoblock. It sits on polymarket.com, not on the API servers, and needs no key.

The JSON response has four fields:

Field What it tells you
blocked true if orders from this location will be rejected
ip The IP address Polymarket detected
country Two-letter ISO country code, such as US
region Region or state code, such as NY
import requests

geo = requests.get("https://polymarket.com/api/geoblock", timeout=10).json()
if geo["blocked"]:
    print("Orders blocked in", geo["country"], geo["region"])
else:
    print("Orders allowed from", geo["country"])

Orders from blocked regions are rejected, and some countries are close-only: you can close existing positions but not open new ones. The United States is close-only on the international website and API, which is why U.S. traders use Polymarket US, where eligibility is checked through identity verification when you open the account (checked on docs.polymarket.com on 7 Nov 2026).

Polymarket decides eligibility by your physical location. Check that you're allowed to trade where you are.

The Polymarket APIs at a Glance

The international Polymarket platform splits its API into four main REST services and several WebSocket feeds, while Polymarket US has its own two-part API. Public market data over REST needs no key on either platform; trading always does.

API Base URL Auth needed What it returns
Gamma API https://gamma-api.polymarket.com None Events, markets and the metadata needed to trade them
CLOB API https://clob.polymarket.com None to read; L2 API credentials plus a wallet-signed order to trade Prices and order books; placing and managing orders
Data API v2 https://data-api.polymarket.com/v2 None Positions, trades, activity, holders, open interest and leaderboards
Relayer API https://relayer-v2.polymarket.com Relayer API key Submits wallet transactions without the account paying gas
CLOB WebSocket wss://ws-subscriptions-clob.polymarket.com/ws/market and /ws/user None for market; API credentials for user Live books and prices; your own order and trade updates
Polymarket US public API https://gateway.polymarket.us None Markets, events, series, sports data and search
Polymarket US authenticated API https://api.polymarket.us Ed25519-signed API key Orders, portfolio and account balances, plus its 2 WebSockets

Polymarket set Data API v1 to retire on 2 Nov 2026, so use the /v2 routes. Checked on docs.polymarket.com and docs.polymarket.us on 7 Nov 2026.

How to Get a Polymarket API Key

How you get a Polymarket API key depends on the platform. Polymarket US keys come from the developer portal, while international CLOB credentials are created from a signature by your wallet.

Polymarket US API keys

  1. Download the Polymarket US app and create an account.
  2. Complete identity verification. The app shows a confirmation once you are approved.
  3. Go to the developer portal at polymarket.us/developer and sign in with the same method you used in the app (Apple, Google or email).
  4. Create a key. You get a Key ID and a Secret Key, and the secret is shown only once, so store it safely.

Each request then carries three headers: X-PM-Access-Key (your Key ID), X-PM-Timestamp (the time in milliseconds) and X-PM-Signature, an Ed25519 signature of the timestamp, method and path. Timestamps must be within 30 seconds of server time, so keep the clock synced. The official Python and TypeScript SDKs sign requests for you.

International CLOB API keys (L1 and L2)

The international CLOB uses two layers of authentication. For L1, your wallet signs an EIP-712 message to prove control, which creates or derives an API key, secret and passphrase. For L2, each private request is signed with that secret using HMAC-SHA256 and sent with five POLY_ headers.

Placing an order uses L2 to authenticate the request and a wallet signature to authorize the order itself. The official SDKs handle both steps. Gasless wallet actions also need a Relayer API key, created under Settings in your polymarket.com account.

Polymarket API Rate Limits

Polymarket US limits its Retail API to 25 requests per second, while the international APIs set limits per endpoint over 10-second windows. Going over a Polymarket US limit returns 429 Too Many Requests; the international limits throttle (delay) requests instead of rejecting them. All limits below were checked on 7 Nov 2026.

Locations

Trade beside your market. 8 datacenters, 3 continents.

Pick the location closest to what you trade, not to where you live.

Compare locations
A dot-matrix world map pins every QuantVPS location (Chicago, New York, London, Dublin, Amsterdam, Frankfurt, Tokyo, Singapore). Typical routes: Chicago to CME 0.52 ms, New York to NYSE 0–2 ms, London to FX 0–10 ms.

Polymarket US Retail API

Endpoint Limit
General, shared across endpoints 25 requests per second
POST /v1/combos and POST /v1/rfqs 1 request per second, shared
POST /v1/rfqs/quotes 100 requests per second
DELETE /v1/rfqs/{rfqId}/quotes/{quoteId} 100 requests per second
GET /v1/rfqs, /v1/rfqs/quotes, /v1/rfqs/trades and /v1/rfqs/user-id 1 request per second each

Limits count per source IP, so several API keys on one IP share the same counters. An order reject that says "Order Processing Max Delay Exceeded" (previously "Global Rate Limit Exceeded") comes from a 5-second latency stopgap, not a real rate limit, so you don't need to slow down for it.

International Gamma API

Endpoint Limit
General 4,000 requests per 10s
/events 500 requests per 10s
/markets 300 requests per 10s
/markets and /events listing 900 requests per 10s
/public-search 350 requests per 10s
/comments and /tags 200 requests per 10s each

International CLOB API

Endpoint Limit
General 9,000 requests per 10s
/book, /price and /midpoint 1,500 requests per 10s each
/books, /prices and /midpoints 500 requests per 10s each
/prices-history 1,000 requests per 10s
API key endpoints 100 requests per 10s
POST /order and DELETE /order 5,000 per 10s burst, 120,000 per 10 min sustained
POST /orders 2,000 per 10s burst, 21,000 per 10 min sustained
DELETE /cancel-all 250 per 10s burst, 6,000 per 10 min sustained

Order and cancel requests also count against separate per-signer limits on the international CLOB.

International Data API v2 and Relayer

Endpoint Limit
Data API, all /v2 routes 800 requests per 10s
/v2/trades 300 requests per 10s
/v2/positions, /v2/activity and /v2/prices-history 200 requests per 10s each
Relayer /submit 25 requests per minute

Real-Time Data over WebSocket

Both Polymarket platforms stream live data over WebSocket, with one channel for public market data and one for your own orders. Streaming is the best way to stay inside the REST rate limits.

Channel URL Auth What it streams
International market channel wss://ws-subscriptions-clob.polymarket.com/ws/market None Order book snapshots, price changes, last trade prices and market updates
International user channel wss://ws-subscriptions-clob.polymarket.com/ws/user CLOB API credentials Your order changes and trade updates
Polymarket US markets wss://api.polymarket.us/v1/ws/markets API key Full order book and stats, lightweight prices and trades, up to 100 markets per subscription
Polymarket US private wss://api.polymarket.us/v1/ws/private API key Order, position and account balance updates

On the international channels, send the text PING every 10 seconds to keep the connection open. On Polymarket US, the server sends heartbeat messages, and the handshake carries the same three signed headers as a REST request. After a disconnect, take a fresh snapshot before you trust the local order book. Checked on docs.polymarket.com and docs.polymarket.us on 10 Oct 2026.

How to Run a Polymarket Bot in the U.S.

To run a Polymarket bot in the U.S., use the Polymarket US API with your own verified Polymarket US account. You need to pass identity verification in the Polymarket US app, then create Ed25519 API keys in the developer portal. U.S. users can only close positions through the international API, not open new ones.

For the build steps, from reading market data to paper testing, see how to build a Polymarket bot.

Where to Deploy Your Trading Infrastructure

Choose a server location only after you know which Polymarket platform your account can use, since the U.S. and international APIs are separate services. Our guide to where Polymarket's servers are covers the locations. A Polymarket VPS keeps a bot online around the clock.

Trading Opportunities in Prediction Markets

API access on Polymarket US has opened up new doors for U.S. traders in prediction markets. Unlike the highly efficient futures exchanges, prediction markets often leave room for mispricings, creating opportunities for algorithmic traders to step in. This regulatory change allows U.S. traders to deploy advanced, real-time strategies that were previously out of reach due to limited access.

Spotting Market Inefficiencies

Prediction markets present unique advantages for identifying inefficiencies. Through the Central Limit Order Book (CLOB) API, traders gain access to real-time order book data, including midpoints, spreads, and price history. Our guide on how to backtest a Polymarket strategy shows how to replay price history with the spread and fees. This data can reveal outcomes that are mispriced compared to actual probabilities. For instance, if breaking news alters the likelihood of a political event but the market hasn’t caught up, an automated bot can act faster than manual traders to capitalize on the gap.

Another tool, on the international platform only, is public wallet tracking. Its Data API provides programmatic access to user positions, activity, and leaderboard rankings. This allows traders to monitor "smart money": high-volume or historically successful traders. International markets tagged as "Negative Risk" can also offer numerical or hedging advantages. Together, these insights pave the way for arbitrage opportunities and strategies that enhance liquidity.

Developing Arbitrage and Liquidity Tools

Cross-venue arbitrage becomes a practical strategy when comparing Polymarket’s real-time prices with external sources like sportsbooks, financial exchanges, or live news feeds. The API’s WebSocket streams provide the speed needed to execute these strategies effectively. Liquidity detection is just as important. On the international platform, Data API routes like /v2/oi (open interest) and /v2/live-volume help traders identify markets with enough depth to handle larger trades without causing significant price slippage.

Market-making strategies also come into play here. The international platform runs Maker Rebates and Liquidity Rewards programs, and Polymarket US pays a maker rebate in its fee schedule plus liquidity rewards, so traders can earn while adding depth. On Polymarket US, the book and bbo (Best Bid Offer) endpoints let you analyze the order book before committing capital.

Order flow

Built for scalpers. Heatmaps on dedicated resources.

Order-flow heatmaps and DOM ladders run on dedicated CPU, memory and NVMe, so your charts keep responding during volatility.

See the dedicated hardware
Order flow through a news release: resting bids and offers paint in as a heatmap beside the DOM ladder, then a burst of buys takes the offer wall. Illustrative; prices are decorative.

Event-Driven Trading Strategies

Event-driven strategies build on arbitrage insights by focusing on immediate market reactions to real-world events. With WebSocket endpoints streaming real-time data, bots can respond to breaking news faster than retail traders using traditional web or mobile platforms. The CLOB API supports sub-second reactions, which is critical when an event - like a sports game outcome - becomes clear before the market fully adjusts. Automated stop-loss and take-profit mechanisms further help manage positions in rapidly changing market conditions.

Does Polymarket US Have an API?

Yes. Polymarket US has a regulated API for verified U.S. users, a major shift for U.S. traders in prediction markets. Instead of relying on manual trading through apps or inefficient workarounds, developers now have direct API access. This opens the door for automated strategies that were previously out of reach for domestic users. Combined with the advanced features mentioned earlier, this change allows traders to implement more efficient and responsive strategies.

Main Benefits of API Access

Real-time execution: With dedicated WebSocket streams, traders receive real-time updates on up to 100 markets per subscription, enabling responses to market changes in under a second. This real-time infrastructure is essential for reacting quickly to breaking news or fast-moving events.

Comprehensive order management: The Orders API covers creating, previewing, modifying, canceling (individually or in bulk) and querying orders. To simplify the process, official SDKs for Python 3.10+ and TypeScript (Node 18+) handle Ed25519 request signing, so developers can focus on building their strategies.

Regulatory compliance: The domestic API complies fully with U.S. regulations, offering a clear and secure framework for automated trading.

Next Steps for Traders and Developers

To take full advantage of these new tools, U.S. traders should follow these steps:

  1. Complete identity verification: Download the Polymarket US iOS app, go through the KYC process, and generate API keys via the developer portal. Be sure to save the private key immediately, as it will only be displayed once. Use the same authentication method (Apple, Google, or email) across both the app and portal to avoid access issues.
  2. Fund your account: Deposit in the Polymarket US app by debit card, bank transfer (ACH), Apple Pay, PayPal, Venmo, USDC (iPhone, where available) or wire transfer. Deposits must come from accounts in your own name.
  3. Prioritize WebSocket connections: Instead of relying on REST polling, use the /v1/ws/markets and /v1/ws/private endpoints for real-time data. This approach also helps you stay within the Retail API limit of 25 requests per second (checked on 7 Nov 2026). For higher limits, email support@polymarket.us with your use case; institutional traders who need FIX or gRPC access register through Polymarket's institutional portal, described in its trader guide.

FAQs

Do I need a U.S. Polymarket account to use the API?

Yes, you'll need to log in using a Polymarket US account to create API keys for programmatic trading. This step is essential for accessing the API, when automating trades or integrating it with other tools.

How do I create and secure my Ed25519 API keys?

To set up and protect your Ed25519 API keys for Polymarket, start by creating an account and completing identity verification using the Polymarket US iOS app. Once verified, generate your keys through the developer portal. Keep in mind, the secret key will only appear once during this process, so make sure to store it in a safe place.

Can I use the international Polymarket API from the U.S.?

Not to open new positions. Polymarket's geoblock list makes the United States close-only on the international website and API, so U.S. users can only close existing positions there. U.S. traders use the Polymarket US API with a verified account instead.

Disclaimer: QuantVPS does not represent, guarantee, support, or endorse any third-party brands, products, or services mentioned in this article. All brand references are for informational purposes only. This information does not constitute a recommendation to trade futures or any other financial instruments. All trading decisions are made at your own discretion. Please be aware that futures trading involves significant risk of loss, and past performance does not guarantee future results. Read our full Brand Non-Endorsement Disclaimer.

Risk Disclosure: QuantVPS does not provide financial, investment, or trading advice. Trading involves substantial risk of loss and is not suitable for every investor. Past performance is not indicative of future results. You should consult a qualified financial advisor before making any trading decisions. Read our full Trading Disclaimer.