What Is Polymarket’s CLOB? Central Limit Order Book + How to Get Started

Polymarket’s Central Limit Order Book (CLOB) is a trading system that directly matches buy and sell orders based on price and quantity, ensuring transparent price discovery. Unlike traditional automated market makers, Polymarket’s hybrid model uses off-chain order matching for speed and on-chain settlement on the Polygon blockchain for security. Here’s what you need to know:

• How It Works: Orders are categorized as bids (buy) and asks (sell), matched off-chain, and settled on-chain using smart contracts. This ensures you maintain control of your assets.
• Key Features: Non-custodial trading, low fees, fast execution, and price transparency. All trades are based on market demand and supply.
• Market Structure: Binary outcomes (YES/NO) priced between $0.00 and $1.00, reflecting probabilities of events.
• Order Types: Supports limit orders (e.g., GTC, GTD) and market orders (e.g., FOK, FAK), with customizable expiration and slippage protection.
• Getting Started: Authenticate via EIP-712 signatures and API keys, fund your wallet with USDC.e, and use Polymarket’s SDK or REST API to place trades.
• Low-Latency Hosting: For automated trading, consider using dedicated VPS services like QuantVPS to reduce latency and improve performance.

Polymarket’s CLOB combines the speed of centralized systems with blockchain security, offering a reliable platform for binary market trading.

Technical Mechanics of Polymarket's CLOB

Order Matching and Settlement

Polymarket's Central Limit Order Book (CLOB) relies on a two-step process that blends speed and security. Here's how it works: when you place an order, a centralized operator handles the initial matching offchain. This involves comparing your order with others, verifying your signature, ensuring you have the necessary balance, and checking compliance with tick size rules before proceeding.

Once a match is found, the transaction moves to the Polygon blockchain for settlement. At this stage, the Exchange contract verifies all required signatures and completes an atomic transfer. Essentially, your USDC.e is swapped for outcome tokens in a single, all-or-nothing transaction. This ensures that neither party is left with an incomplete trade. The operator's actions are fully authorized by your signature, maintaining trust and security throughout the process.

This hybrid model combines the quick execution you'd expect from centralized exchanges with the security of blockchain-based settlement. If connectivity issues arise, you can cancel your orders directly onchain.

Binary Market Structure (YES/NO)

Polymarket operates using a binary framework, where every event revolves around two outcomes: YES and NO. Together, 1 YES share and 1 NO share always equal $1.00. This structure is the foundation for price discovery and liquidity. For example, if you place a buy order for YES at $0.60, it pairs with someone else's buy order for NO at $0.40. Combined, these orders meet the $1.00 threshold required to mint a complete set of outcome tokens.

Prices, which range from $0.00 to $1.00, represent the market's implied probability. A YES share priced at $0.75 indicates a 75% likelihood of the event happening. Once the event concludes, winning shares are valued at $1.00, while losing shares become worthless.

Order Types: Limit and Market Orders

Polymarket treats all orders as limit orders, even those referred to as market orders. Market orders are essentially limit orders set to execute immediately.

When placing a limit order - whether it's Good Till Cancelled (GTC) or Good Till Date (GTD) - you define the maximum price you're willing to pay (or the minimum price you're willing to accept). These orders stay active until they are matched, canceled, or expire.

Market orders, such as Fill Or Kill (FOK) or Fill And Kill (FAK), focus on immediate execution. The "price" field in these orders acts as slippage protection, setting a maximum or minimum acceptable price. For instance, if you submit a buy order at $0.55, and it matches with a sell order at $0.52, you'll pay the lower price of $0.52.

Order Type	Behavior	Use Case
GTC (Good Till Cancelled)	Stays on the book until filled or manually canceled	Ideal for market-making strategies
GTD (Good Till Date)	Expires at a specified Unix timestamp	Useful for time-sensitive trades
FOK (Fill Or Kill)	Must be fully executed immediately or canceled	Prevents partial fills and slippage
FAK (Fill And Kill)	Executes available liquidity immediately; cancels the rest	Balances speed and partial execution

Orders must follow the market's tick size, which could be 0.01, 0.001, 0.0001, or 0.1. The matching engine rejects orders that don't adhere to these increments or set an expiration within 10 seconds. This approach ensures a fast and secure trading experience within Polymarket's hybrid system.

How to Get Started with Polymarket's CLOB

Setting Up API Authentication

Polymarket's CLOB offers a fast and secure trading experience, but before diving in, you need to set up authentication. The process involves two layers of security:

1. EIP-712 Message Signing (L1): Use your wallet's private key to sign an EIP-712 message.
2. API Key Authentication (L2): Secure your API requests using your apiKey, secret, and passphrase with HMAC-SHA256 signing.

When initiating your trading session, you'll need to specify a signature type:

• 0 for standard wallets like MetaMask (EOA).
• 1 for Magic Link or Google login users (POLY_PROXY).
• 2 for Gnosis Safe users, which is the default for most Polymarket.com accounts.

Additionally, you must determine your funder address, which is the wallet holding your funds. For standard wallets, this is simply your wallet address. If you're using a proxy, you can find the funder address in your Polymarket profile settings.

Important Reminder: Never embed private keys or API secrets directly in your code. Instead, store them securely in .env files and make sure these files are excluded from version control by adding them to .gitignore. If you lose your API credentials, you can only recover them if you've saved the original nonce used during their creation. Otherwise, you'll need to generate new credentials with a fresh nonce.

Once authentication is set up, you can connect using Polymarket's official SDKs or REST API.

Connecting via SDK or REST API

Polymarket provides open-source SDKs in several programming languages, including TypeScript (@polymarket/clob-client), Python (py-clob-client), and Rust (polymarket-client-sdk). These SDKs simplify the authentication process, making them the preferred option for most users. Here's how to get started:

1. Install the SDK package for your chosen language.
2. Initialize the client using your private key.
3. Use the createOrDeriveApiKey() method to generate L2 credentials automatically.
4. Reinitialize the client with the complete credential set to start trading.

For those who prefer using the REST API, you’ll need to manually construct HTTP headers for each request. These headers include:

• POLY_ADDRESS: Your Polygon signer address.
• POLY_SIGNATURE: The HMAC-SHA256 signature.
• POLY_TIMESTAMP: The current Unix timestamp.
• POLY_API_KEY and POLY_PASSPHRASE: Your API credentials.

Keep in mind that public endpoints like the orderbook and market prices don’t require authentication.

Note for EOA and MetaMask Users: Before placing your first trade, you must manually set token allowances for USDC and Conditional Tokens. If you're using an email or Magic wallet, these allowances are automatically configured for you.

Once connected, you're all set to place your first trade.

Placing Your First Order

Before trading, ensure your funder address is approved for USDC.e and conditional tokens. Use the getBalanceAllowance() method to check token allowances and getTickSize() to confirm the market's tick size.

The SDK streamlines the process with its createAndPostOrder method, which takes care of signing and submitting your order in one step. When placing an order, you’ll need to specify:

• The tokenID for the outcome you're trading.
• The price, ensuring it aligns with the market's tick size.
• The size, which is the number of shares you're buying or selling.
• Whether the order is a buy or sell.

For multi-outcome markets, set negRisk to true.

Be aware that prices not matching the market's precision - for example, using 0.01 when the market requires 0.001 - will be rejected. If you're running automated trading bots, send a heartbeat every 5 seconds to prevent orders from being canceled. Additionally, you can use batch requests to place up to 15 orders or query up to 500 tokens in a single API call, which is a great way to boost efficiency for high-frequency trading strategies.

Using QuantVPS for Polymarket Trading

Why Low-Latency VPS Hosting Matters

When it comes to Polymarket trading, low latency is non-negotiable. QuantVPS steps in with hosting solutions that cater specifically to this need, ensuring you don’t miss a single opportunity.

Trading on Polymarket's Central Limit Order Book (CLOB) is all about speed. Every millisecond can decide whether your order gets filled or you miss out entirely. WebSocket feeds provide real-time market data with a latency of about 100ms, while REST API polling lags behind, adding approximately 1 second of delay. For automated trading bots and market-making algorithms, this difference can significantly impact profitability.

"WebSocket feeds ensure low-latency access (~100ms) to crucial data for market-making algorithms." - Jung-Hua Liu

Relying on a home internet connection can introduce unpredictable latency spikes and downtime, which are unacceptable in fast-paced trading environments. A dedicated VPS solves this by delivering consistent ultra-low latency (0–1ms to major exchange infrastructure), 100% uptime, and unlimited bandwidth. This level of reliability is essential for keeping your system's heartbeat steady, avoiding order cancellations, and handling rapid tick size changes that could lead to rejections. QuantVPS has tailored its plans to address these specific challenges.

QuantVPS Plans for Polymarket Traders

QuantVPS offers a range of plans designed to tackle latency issues and fit different trading setups:

• VPS Lite: Priced at $59.99 per month (or $41.99 monthly with an annual plan), this option provides 4 cores, 8GB RAM, and 70GB NVMe storage. It's ideal for running a single trading bot.
• VPS Pro: For $99.99 per month (or $69.99 monthly with an annual plan), this plan offers 6 cores, 16GB RAM, and 150GB NVMe storage. It supports multiple bots or more complex strategies and allows for up to two monitors.
• VPS Ultra: At $189.99 per month (or $132.99 monthly with an annual plan), this plan includes 24 cores, 64GB RAM, and 500GB NVMe storage. It’s built for high-frequency traders operating across multiple markets and supports up to four monitors.
• Dedicated Server: Designed for institutional-grade operations, this plan costs $299.99 per month (or $209.99 monthly with an annual plan). It features 16+ dedicated cores, 128GB RAM, and 2TB+ NVMe storage, making it perfect for running multiple WebSocket connections and handling batch order submissions.

QuantVPS Plan Comparison

Plan	CPU Cores	RAM	Storage	Network	Monitors	Monthly	Annual
VPS Lite	4	8GB	70GB NVMe	1Gbps+	None	$59.99	$41.99/mo
VPS Pro	6	16GB	150GB NVMe	1Gbps+	Up to 2	$99.99	$69.99/mo
VPS Ultra	24	64GB	500GB NVMe	1Gbps+	Up to 4	$189.99	$132.99/mo
Dedicated	16+	128GB	2TB+ NVMe	10Gbps+	Up to 6	$299.99	$209.99/mo

Each plan comes packed with features, including Windows Server 2022, full root access, DDoS protection, automatic backups, and unmetered bandwidth. The high-speed network ensures your bots can handle real-time WebSocket streams and batch API requests without delay, while NVMe storage provides the speed needed to log high-frequency trade data efficiently.

Managing and Monitoring Your Orders

Reading the Order Book

Getting familiar with the order book is essential if you want to make smart trading decisions. The order book shows Bids (buy orders at the highest prices) and Asks (sell orders at the lowest prices). The difference between them, known as the spread, gives you an idea of market liquidity.

Prices in the order book represent implied probabilities. For instance, a price of $0.25 suggests a 25% chance of the outcome. On Polymarket, the midpoint - the average of the best bid and best ask - is usually displayed. However, if the spread is wider than $0.10, the interface will show the last traded price instead.

"Prices aren't set by Polymarket - they emerge from supply and demand as users trade with each other." – Polymarket Documentation

Before placing large orders, it’s a good idea to check the depth of the order book. Use the calculateMarketPrice endpoint to estimate and minimize slippage. Real-time updates through WebSocket occur about every 100 milliseconds, while REST API endpoints typically have a delay of around 1 second.

Always confirm the current tick_size before placing orders. If the tick size changes - like when prices go above $0.96 or drop below $0.04 - and you use the wrong increment, your order will be rejected.

Once you’ve reviewed the market depth, you’ll be better prepared to manage your orders effectively.

Canceling and Updating Orders

After understanding market behavior, the next step is managing your orders. Keep in mind that the Central Limit Order Book doesn’t allow direct updates to existing orders. If you need to change an order, you’ll have to cancel the unfilled one and submit a new order with your updated price or size.

You can cancel orders using API endpoints such as cancelOrder, cancelOrders, cancelAll, or cancelMarketOrders. Alternatively, you can cancel them on-chain via the Exchange contract, but doing so will incur standard Polygon gas fees. Off-chain cancellations through APIs are processed instantly and don’t involve gas fees.

To stay on top of your orders, use the getOrder endpoint for detailed progress updates. You can also use the getNotifications endpoint to get alerts about fills or cancellations, with records available for 48 hours. For automated trading, consider implementing a heartbeat mechanism. Sending a heartbeat every 5 seconds prevents automatic cancellations. If no heartbeat is received within 10 seconds (plus a 5-second buffer), all open orders will be canceled to ensure safety.

Order Status	Description
live	Order is resting on the book
matched	Order matched immediately
delayed	Market orders in sports markets incur a 3-second delay
unmatched	Marketable order placed on the book after the delay expires without a match

Conclusion

Key Takeaways

Polymarket's Central Limit Order Book (CLOB) offers a blend of off-chain order matching and on-chain settlement on the Polygon network. This setup combines the speed of centralized exchanges with the added security of non-custodial trading, ensuring you maintain full control over your assets throughout the process.

Getting started is straightforward. The official TypeScript, Python, or Rust SDKs simplify authentication and order placement. Just make sure your wallet is funded with USDC.e and, if you're using an EOA wallet, have some POL tokens available for gas fees.

For traders using automated strategies or news-driven Polymarket bots, low-latency infrastructure is a critical component. Polymarket supports this with WebSocket feeds that provide updates in about 100 milliseconds, while REST API endpoints offer updates with a slight delay of around one second. For hosting, QuantVPS caters to algorithmic trading needs with ultra-low latency and a 100% uptime guarantee. Plans begin with the VPS Lite option at $59.99 per month for smaller workloads and go up to Dedicated Servers at $299.99 per month for more advanced operations. These tools ensure seamless order management and real-time monitoring, making it easier to execute your trading strategies effectively.

Whether you're new to binary market trading or trading sports markets or developing complex algorithms, Polymarket's CLOB offers transparent price discovery, flexible order types, and the reliability of non-custodial security. Use these features to refine and enhance your trading approach on Polymarket.

FAQs

Is Polymarket’s CLOB custodial?

Polymarket’s Central Limit Order Book (CLOB) operates as a non-custodial hybrid system, blending off-chain order matching with on-chain settlement. This setup allows users to retain full control over their funds while enabling orders to be canceled independently. The result is a trading experience that prioritizes both security and efficiency, ensuring users' assets remain in their own hands.

Why can my order be rejected for tick size?

When placing an order, it might be rejected due to "tick size" issues if the price you set doesn't match the platform's minimum price increment. This rule is in place to make sure all orders adhere to the market's valid pricing levels. To avoid this, double-check that your order price aligns with the required increments before submitting it.

Do I need a VPS to run a trading bot?

No, you don’t need a VPS to run a trading bot on Polymarket. You can use a local machine or any server with internet access. That said, opting for a VPS might offer more consistent uptime and reliability for uninterrupted operation.