DocsPricingContact Us
Log inStart free trial

Polymarket API reference

All 159 endpoints Polymarket publishes, one page each. Every page lists the rate limit for that specific route, whether it needs credentials, and a request you can run. Polymarket's own docs publish the limits on a separate page from the endpoints.

This covers Polymarket's API. For the PolyTest API, see the PolyTest endpoints.

Gamma API (42)

https://gamma-api.polymarket.com. Market and event discovery. Public, no auth.

GET/statusGamma API Health check4,000 req / 10s
GET/teamsList teams4,000 req / 10s
GET/teams/{id}Get team by id4,000 req / 10s
GET/tagsList tags200 req / 10s
GET/tags/{id}Get tag by id200 req / 10s
GET/tags/slug/{slug}Get tag by slug200 req / 10s
GET/tags/{id}/related-tagsGet related tags (relationships) by tag id200 req / 10s
GET/tags/slug/{slug}/related-tagsGet related tags (relationships) by tag slug200 req / 10s
GET/tags/{id}/related-tags/tagsGet tags related to a tag id200 req / 10s
GET/tags/slug/{slug}/related-tags/tagsGet tags related to a tag slug200 req / 10s
GET/eventsList events500 req / 10s
GET/events/paginationList events (paginated)500 req / 10s
GET/events/resultsList sport events results500 req / 10s
GET/events/{id}Get event by id500 req / 10s
GET/events/{id}/tweet-countGet event tweet count500 req / 10s
GET/events/{id}/comments/countGet event comment count500 req / 10s
GET/events/{id}/tagsGet event tags500 req / 10s
GET/events/slug/{slug}Get event by slug500 req / 10s
GET/events/creatorsList event creators500 req / 10s
GET/events/creators/{id}Get event creator by id500 req / 10s
GET/marketsList markets300 req / 10s
GET/markets/{id}Get market by id300 req / 10s
GET/markets/{id}/descriptionGet market description by id300 req / 10s
GET/markets/{id}/tagsGet market tags by id300 req / 10s
GET/markets/slug/{slug}Get market by slug300 req / 10s
POST/markets/informationQuery markets by information filters300 req / 10s
POST/markets/abridgedQuery abridged markets by information filters300 req / 10s
GET/markets/keysetList markets (keyset pagination)300 req / 10s
GET/events/keysetList events (keyset pagination)500 req / 10s
GET/seriesList series4,000 req / 10s
GET/series/{id}Get series by id4,000 req / 10s
GET/series/{id}/comments/countGet series comment count4,000 req / 10s
GET/series-summary/{id}Get series summary by id4,000 req / 10s
GET/series-summary/slug/{slug}Get series summary by slug4,000 req / 10s
GET/commentsList comments200 req / 10s
GET/comments/{id}Get comments by comment id200 req / 10s
GET/comments/user_address/{user_address}Get comments by user address200 req / 10s
GET/public-profileGet public profile by wallet address4,000 req / 10s
GET/profiles/user_address/{user_address}Get public profile by user address4,000 req / 10s
GET/sportsGet sports metadata information4,000 req / 10s
GET/sports/market-typesGet valid sports market types4,000 req / 10s
GET/public-searchSearch markets, events, and profiles350 req / 10s

CLOB API (66)

https://clob.polymarket.com. Order book, prices and trading. Reads are public; orders need L2 credentials.

POST/orderPost a new order5,000 req / 10s
DELETE/orderCancel single order5,000 req / 10s
POST/ordersPost multiple orders2,000 req / 10s
DELETE/ordersCancel multiple orders2,000 req / 10s
GET/data/ordersGet user orders500 req / 10s
GET/data/order/{orderID}Get single order by ID9,000 req / 10s
DELETE/cancel-allCancel all orders250 req / 10s
DELETE/cancel-market-ordersCancel orders for a market1,500 req / 10s
GET/timeGet server time9,000 req / 10s
GET/midpointGet midpoint price1,500 req / 10s
GET/midpointsGet midpoint prices (query parameters)500 req / 10s
POST/midpointsGet midpoint prices (request body)500 req / 10s
GET/spreadGet spread9,000 req / 10s
POST/spreadsGet spreads9,000 req / 10s
GET/last-trade-priceGet last trade price9,000 req / 10s
GET/last-trades-pricesGet last trade prices (query parameters)9,000 req / 10s
POST/last-trades-pricesGet last trade prices (request body)9,000 req / 10s
GET/fee-rateGet fee rate9,000 req / 10s
GET/fee-rate/{token_id}Get fee rate by path parameter9,000 req / 10s
GET/tick-sizeGet tick size9,000 req / 10s
GET/tick-size/{token_id}Get tick size by path parameter9,000 req / 10s
GET/neg-riskGet negative risk flag9,000 req / 10s
GET/neg-risk/{token_id}Get negative risk flag by path parameter9,000 req / 10s
GET/priceGet market price1,500 req / 10s
GET/pricesGet market prices (query parameters)500 req / 10s
POST/pricesGet market prices (request body)500 req / 10s
GET/bookGet order book1,500 req / 10s
GET/booksGet order books (query parameters)500 req / 10s
POST/booksGet order books (request body)500 req / 10s
GET/simplified-marketsGet simplified markets9,000 req / 10s
GET/sampling-marketsGet sampling markets9,000 req / 10s
GET/sampling-simplified-marketsGet sampling simplified markets9,000 req / 10s
GET/clob-markets/{condition_id}Get CLOB market info9,000 req / 10s
GET/markets-by-token/{token_id}Get market by token9,000 req / 10s
POST/markets/live-activityGet live activity markets by condition IDs9,000 req / 10s
GET/markets/live-activity/{condition_id}Get live activity market by condition ID9,000 req / 10s
GET/prices-historyGet prices history1,000 req / 10s
POST/batch-prices-historyGet batch prices history9,000 req / 10s
POST/auth/api-keyCreate API key9,000 req / 10s
DELETE/auth/api-keyDelete API key9,000 req / 10s
GET/auth/api-keysGet API keys9,000 req / 10s
GET/auth/derive-api-keyDerive API key9,000 req / 10s
GET/balance-allowanceGet balance and allowance9,000 req / 10s
PUT/balance-allowanceUpdate balance and allowance9,000 req / 10s
GET/balance-allowance/updateUpdate balance and allowance9,000 req / 10s
GET/auth/ban-status/closed-onlyGet closed-only mode status9,000 req / 10s
GET/auth/builder-api-keyGet builder API keys9,000 req / 10s
POST/auth/builder-api-keyCreate builder API key9,000 req / 10s
DELETE/auth/builder-api-keyRevoke builder API key9,000 req / 10s
GET/notificationsGet notifications125 req / 10s
DELETE/notificationsMark notifications as read125 req / 10s
GET/rewards/userGet earnings for user by date9,000 req / 10s
GET/rewards/user/totalGet total earnings for user by date9,000 req / 10s
GET/rewards/user/percentagesGet reward percentages for user9,000 req / 10s
GET/rewards/user/marketsGet user earnings and markets configuration9,000 req / 10s
GET/rewards/markets/currentGet current active rewards configurations9,000 req / 10s
GET/rewards/markets/{condition_id}Get raw rewards for a specific market9,000 req / 10s
GET/rewards/markets/multiGet multiple markets with rewards9,000 req / 10s
GET/rebates/currentGet current rebated fees for a maker9,000 req / 10s
POST/heartbeatsSend heartbeat9,000 req / 10s
POST/v1/heartbeatsSend heartbeat (v1)9,000 req / 10s
GET/order-scoringGet order scoring status9,000 req / 10s
GET/orders-scoringGet scoring status for multiple orders9,000 req / 10s
POST/orders-scoringGet scoring status for multiple orders (POST)9,000 req / 10s
GET/data/tradesGet trades500 req / 10s
GET/builder/tradesGet builder trades9,000 req / 10s

Data API v2 (20)

https://data-api.polymarket.com. Positions, activity, trades and analytics. Released 4 September 2026; new fields land here only.

GET/v2/activityList account activity200 req / 10s
GET/v2/activity/combosList combo activity200 req / 10s
GET/v2/approvalsGet wallet approvals800 req / 10s
GET/v2/biggest-winnersList the biggest wins800 req / 10s
GET/v2/builders/leaderboardGet the builders leaderboard800 req / 10s
GET/v2/builders/volumeGet builder volume over time800 req / 10s
GET/v2/holdersList a market's top holders800 req / 10s
GET/v2/leaderboardGet the trader leaderboard800 req / 10s
GET/v2/live-volumeGet live volume for an event800 req / 10s
GET/v2/oiGet open interest800 req / 10s
GET/v2/positionsList positions for a user or market200 req / 10s
GET/v2/positions/combosList combo positions200 req / 10s
GET/v2/prices-historyGet a token's price history200 req / 10s
GET/v2/resolutionsGet resolution state800 req / 10s
GET/v2/statusGet data freshness100 req / 10s
GET/v2/tradesList trades300 req / 10s
GET/v2/user-pnlGet a user's PnL series800 req / 10s
GET/v2/user-statsGet a user's profile stats800 req / 10s
GET/v2/user-volumeGet a user's trading volume800 req / 10s
GET/v2/valueGet portfolio value800 req / 10s

Data API v1 (19)

https://data-api.polymarket.com. Frozen since 4 September 2026. Still serves, but new work should target v2.

GET/Data API Health check1,000 req / 10s
GET/v1/accounting/snapshotDownload an accounting snapshot (ZIP of CSVs)1,000 req / 10s
GET/positionsGet current positions for a user150 req / 10s
GET/tradesGet trades for a user or markets200 req / 10s
GET/activityGet user activity1,000 req / 10s
GET/v1/activity/combosGet user combo activity1,000 req / 10s
GET/v1/positions/combosGet user combo positions1,000 req / 10s
GET/holdersGet top holders for markets1,000 req / 10s
GET/tradedGet total markets a user has traded1,000 req / 10s
GET/revisionsGet moderated revisions for a question1,000 req / 10s
GET/valueGet total value of a user's positions1,000 req / 10s
GET/oiGet open interest1,000 req / 10s
GET/live-volumeGet live volume for an event1,000 req / 10s
GET/closed-positionsGet closed positions for a user150 req / 10s
GET/otherGet "Other" size for an augmented neg risk event and user1,000 req / 10s
GET/v1/market-positionsGet positions for a market1,000 req / 10s
GET/v1/builders/leaderboardGet aggregated builder leaderboard1,000 req / 10s
GET/v1/builders/volumeGet daily builder volume time-series1,000 req / 10s
GET/v1/leaderboardGet trader leaderboard rankings1,000 req / 10s

Relayer API (7)

https://relayer-v2.polymarket.com. Gasless wallet transactions.

POST/submitSubmit a transaction25 req / 1 min
GET/transactionGet a transaction by ID
GET/transactionsGet recent transactions for a user
GET/nonceGet current nonce for a user
GET/relay-payloadGet relayer address and nonce
GET/deployedCheck if a wallet is deployed
GET/relayer/api/keysGet all relayer API keys

Bridge API (5)

https://bridge.polymarket.com. Deposits and withdrawals.

GET/supported-assetsGet supported assets50 req / 10s
POST/quoteGet a quote50 req / 10s
POST/depositCreate bridge addresses50 req / 10s
POST/withdrawCreate withdrawal addresses50 req / 10s
GET/status/{address}Get transaction status50 req / 10s

From Polymarket's published OpenAPI specs and rate-limit tables, synced 2026-10-04.