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:
- Polymarket US: https://docs.polymarket.us/api-reference/introduction
- International Polymarket: https://docs.polymarket.com/getting-started/api
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

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.
Read next
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
- Download the Polymarket US app and create an account.
- Complete identity verification. The app shows a confirmation once you are approved.
- 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).
- 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 locationsFrom $29.99/mo · Windows or Linux
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 hardwareFrom $29.99/mo · Windows or Linux
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:
- 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.
- 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.
-
Prioritize WebSocket connections: Instead of relying on REST polling, use the
/v1/ws/marketsand/v1/ws/privateendpoints 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.









