Polymarket Documentation

What is Polymarket?

How to Sign-Up

How to add cash to your balanace on Polymarket.

How to Deposit

Making Your First Trade

How to buy and deposit USDC to your Polymarket account using Coinbase.

Deposit with Coinbase

Use MoonPay to deposit cash using your Visa, Mastercard, or bank account.

Deposit Using Your Card

How to deposit USDC on the Ethereum Network to your Polymarket account.

Deposit USDC on Ethereum

Large Cross Chain Deposits

How to withdraw your cash balance from Polymarket.

How to Withdraw

Markets are created by the markets team with input from users and the community.

How Are Markets Created?

The prices probabilities displayed on Polymarket are the midpoint of the bid-ask spread in the orderbook.

How Are Prices Calculated?

Markets are resolved by the UMA Optimistic Oracle, a smart-contract based optimistic oracle.

How Are Prediction Markets Resolved?

How Are Markets Clarified?

How Are Markets Disputed?

What are limit orders and how to make them.

Limit Orders

Market Orders

Learn how to earn rewards merely by placing trades on Polymarket

Liquidity Rewards

Trading Fees

Does Polymarket Have Trading Limits?

Understanding the Order Book will help you become an advanced trader.

Using the Order Book

Adding market embeds to your Substack or website.

How To Use Embeds

How is Polymarket better than traditional / legacy polling?

Polymarket vs. Polling

If you deposited the wrong cryptocurrency on Ethereum or Polygon, use these tools to recover those funds.

Recover Missing Deposit

Can I Sell Early?

Does Polymarket Have a Token?

Does Polymarket have an API?

Polymarket offers technical support through our website chat feature, and through Discord.

How Do I Contact Support?

How Do I Export My Key?

Yes. Polymarket is non-custodial, so you're in control of your funds.

Is My Money Safe?

No, Polymarket is not the house. All trades happen peer-to-peer (p2p).

Is Polymarket The House?

Why Polymarket uses crypto and blockchain technology to create the world’s largest Prediction market.

Why Crypto?

How people collectively forecast the future.

What is a Prediction Market?

Developer Quickstart

Glossary

Rate limits are the same for all users, nobody has priority or increased limits

API Rate Limits

Your First Order

Cancelling Orders

CLOB Introduction

Detailed instructions for creating, placing, and managing orders using Polymarket's CLOB API.

Orders Overview

Place Single Order

Instructions for placing multiple orders(Batch)

Place Multiple Orders (Batching)

Get Order

Get Active Orders

Check if an order is eligble or scoring for Rewards purposes

Check Order Reward Scoring

Multiple endpoints to cancel a single order, multiple orders, all orders or all orders from a single market.

Cancel Orders(s)

Onchain Order Info

Trades Overview

Get Trades

Alternative endpoint to the GAMMA Get-Trades. Allows users to get trades from all markets and all users. Ordered by timestamp in descending order(most recent trade first).

Get Trades (Data-API)

Get Single Market

Get Markets

Get Sampling Markets

Get Simplified Markets

Get Sampling Simplified Markets

Fetches historical price data for a specified market token.


Historical Timeseries Data

Get Book

Get order book summaries for a set of markets with a single request.

Get Books

Get Price

Get the prices for a group of markets (best bid or best ask) with one request.

Get Price(s)

Get Midpoint(s)

Get the spread from one or multiple markets

Get Spread(s)

Overview and general information about the Polymarket Websocket

WSS Overview

WSS Quickstart

WSS Authentication

User Channel

Market Channel

Gamma Structure

Retrieves a list of markets with various filtering and sorting options.

Fetches a list of events with various filtering and sorting options.

Get Events

Fetches current positions for a given user address, optionally filtered by market or event and other parameters.

Get User Positions (Data-API)

Returns trades and activity history for a specified wallet, optionally filtered by market, type, time, and side.

Get User On-Chain Activity (Data-API)

Fetches the top holders of a specified market token.

Get Market Holders (Data-API)

Get the value of a users' holdings across all markets.

Get Holdings Value (Data-API)

Subgraph

Resolution

Polymarket provides incentives aimed at catalyzing the supply and demand side of the marketplace. Specifically there is a public liquidity rewards program as well as one-ff public pnl/volume competitions.

Overview

Splitting USDC

Merging Tokens

Reedeeming Tokens

Deployment and Additional Information

Welcome to the Polymarket Changelog. Here you will find any important changes to Polymarket, including but not limited to CLOB, API, UI and Mobile Applications.

Developer Quickstart

Central Limit Order Book

Order Manipulation

Trades

Markets

Pricing and Books

Websocket

Gamma Markets API

Miscellaneous Endpoints

Subgraph

Resolution

Rewards

Conditional Token Frameworks

Proxy Wallets

Negative Risk

Status