# Polymarket Documentation: English API Reference Predictions ## Predictions - [Overview](https://docs.polymarket.com/api-reference/predictions/overview.md): Explore the APIs available for building with Polymarket Predictions. - [Rate Limits](https://docs.polymarket.com/api-reference/rate-limits.md): Cloudflare IP-based request limits for Polymarket APIs - [CLOB Trading Rate Limits](https://docs.polymarket.com/api-reference/trading-rate-limits.md): Per-signer token-bucket limits for CLOB order and cancellation requests - [Get rate limit tier](https://docs.polymarket.com/api-reference/account/get-rate-limit-tier.md): Returns the [trading rate limit tier](/api-reference/trading-rate-limits) currently assigned to your signer. The tier returned is the one for the signer address of the API credentials used. - [Geographic Restrictions](https://docs.polymarket.com/api-reference/geoblock.md): Check geographic restrictions before placing orders on the Polymarket API - [Get data freshness](https://docs.polymarket.com/api-reference/service/get-data-freshness.md): How fresh the data behind this API is. - [Data API v2](https://docs.polymarket.com/api-reference/data-api/overview.md): Read wallet portfolios, trade and activity feeds, market state, and ranked leaderboards through one consistent response contract. ### Events - [List events (keyset pagination)](https://docs.polymarket.com/api-reference/events/list-events-keyset-pagination.md): Returns events using cursor-based (keyset) pagination for stable, efficient paging through large result sets. Use `next_cursor` from each response as `after_cursor` in the next request. The `offset` parameter is explicitly rejected; use `after_cursor` instead. - [List events](https://docs.polymarket.com/api-reference/events/list-events.md) - [Get event by id](https://docs.polymarket.com/api-reference/events/get-event-by-id.md) - [Get event by slug](https://docs.polymarket.com/api-reference/events/get-event-by-slug.md) - [Get event tags](https://docs.polymarket.com/api-reference/events/get-event-tags.md) ### Markets - [List markets (keyset pagination)](https://docs.polymarket.com/api-reference/markets/list-markets-keyset-pagination.md): Returns markets using cursor-based (keyset) pagination for stable, efficient paging through large result sets. Use `next_cursor` from each response as `after_cursor` in the next request. The `offset` parameter is explicitly rejected; use `after_cursor` instead. - [List markets](https://docs.polymarket.com/api-reference/markets/list-markets.md) - [Get market by id](https://docs.polymarket.com/api-reference/markets/get-market-by-id.md) - [Get market by slug](https://docs.polymarket.com/api-reference/markets/get-market-by-slug.md) - [Get market tags by id](https://docs.polymarket.com/api-reference/markets/get-market-tags-by-id.md) - [Get market by token](https://docs.polymarket.com/api-reference/markets/get-market-by-token.md): Returns the parent market for a given token ID. Useful when you have a token ID and need to resolve its parent market without knowing the condition ID in advance. - [List a market's top holders](https://docs.polymarket.com/api-reference/markets/list-a-markets-top-holders.md): Top holders of a market, netted per user and grouped by outcome token. - [Get open interest](https://docs.polymarket.com/api-reference/markets/get-open-interest.md): Priced gross open interest per market. - [Get live volume for an event](https://docs.polymarket.com/api-reference/markets/get-live-volume-for-an-event.md): Cumulative one-side (taker) volume per market. - [Get resolution state](https://docs.polymarket.com/api-reference/markets/get-resolution-state.md): Complete resolution state by one selector family. - [Look up tokens](https://docs.polymarket.com/api-reference/markets/look-up-tokens.md): Resolves token ids, or the tokens of conditions, to their condition, module, outcome, market, event and neg-risk question index in one call. Exactly one selector per request. - [Get simplified markets](https://docs.polymarket.com/api-reference/markets/get-simplified-markets.md) - [Get sampling markets](https://docs.polymarket.com/api-reference/markets/get-sampling-markets.md) - [Get sampling simplified markets](https://docs.polymarket.com/api-reference/markets/get-sampling-simplified-markets.md) ### Orderbook & Pricing - [Get order book](https://docs.polymarket.com/api-reference/market-data/get-order-book.md): Retrieves the order book summary for a specific token ID. Includes bids, asks, market details, and last trade price. - [Get order books (request body)](https://docs.polymarket.com/api-reference/market-data/get-order-books-request-body.md): Retrieves order book summaries for multiple token IDs using a request body. - [Get market price](https://docs.polymarket.com/api-reference/market-data/get-market-price.md): Retrieves the best market price for a specific token ID and side (bid or ask). Returns the best bid price for BUY side or best ask price for SELL side. - [Get market prices (query parameters)](https://docs.polymarket.com/api-reference/market-data/get-market-prices-query-parameters.md): Retrieves market prices for multiple token IDs and sides using query parameters. - [Get market prices (request body)](https://docs.polymarket.com/api-reference/market-data/get-market-prices-request-body.md): Retrieves market prices for multiple token IDs and sides using a request body. Each request must include both token_id and side. - [Get midpoint price](https://docs.polymarket.com/api-reference/data/get-midpoint-price.md): Retrieves the midpoint price for a specific token ID. The midpoint is calculated as the average of the best bid and best ask prices. - [Get midpoint prices (query parameters)](https://docs.polymarket.com/api-reference/market-data/get-midpoint-prices-query-parameters.md): Retrieves midpoint prices for multiple token IDs using query parameters. The midpoint is calculated as the average of the best bid and best ask prices. - [Get midpoint prices (request body)](https://docs.polymarket.com/api-reference/market-data/get-midpoint-prices-request-body.md): Retrieves midpoint prices for multiple token IDs using a request body. The midpoint is calculated as the average of the best bid and best ask prices. - [Get spread](https://docs.polymarket.com/api-reference/market-data/get-spread.md): Retrieves the spread for a specific token ID. The spread is the difference between the best ask and best bid prices. - [Get spreads](https://docs.polymarket.com/api-reference/market-data/get-spreads.md): Retrieves spreads for multiple token IDs. The spread is the difference between the best ask and best bid prices. - [Get last trade price](https://docs.polymarket.com/api-reference/market-data/get-last-trade-price.md): Retrieves the last trade price and side for a specific token ID. Returns default values of "0.5" for price and empty string for side if no trades found. - [Get last trade prices (query parameters)](https://docs.polymarket.com/api-reference/market-data/get-last-trade-prices-query-parameters.md): Retrieves last trade prices for multiple token IDs using query parameters. Maximum 500 token IDs can be requested per call. - [Get last trade prices (request body)](https://docs.polymarket.com/api-reference/market-data/get-last-trade-prices-request-body.md): Retrieves last trade prices for multiple token IDs using a request body. Maximum 500 token IDs can be requested per call. - [Get prices history](https://docs.polymarket.com/api-reference/markets/get-prices-history.md): Retrieve historical price data for a market. - [Get a token's price history](https://docs.polymarket.com/api-reference/markets/get-a-tokens-price-history.md): The price-history series for one outcome token, or a single point-in-time observation. - [Get batch prices history](https://docs.polymarket.com/api-reference/markets/get-batch-prices-history.md): Retrieve historical price data for multiple markets in a single request. - [Get fee rate](https://docs.polymarket.com/api-reference/market-data/get-fee-rate.md): Retrieves the base fee rate for a specific token ID. The fee rate can be provided either as a query parameter or as a path parameter. - [Get fee rate by path parameter](https://docs.polymarket.com/api-reference/market-data/get-fee-rate-by-path-parameter.md): Retrieves the base fee rate for a specific token ID using the token ID as a path parameter. - [Get tick size](https://docs.polymarket.com/api-reference/market-data/get-tick-size.md): Retrieves the minimum tick size (price increment) for a specific token ID. The tick size can be provided either as a query parameter or as a path parameter. - [Get tick size by path parameter](https://docs.polymarket.com/api-reference/market-data/get-tick-size-by-path-parameter.md): Retrieves the minimum tick size (price increment) for a specific token ID using the token ID as a path parameter. - [Get CLOB market info](https://docs.polymarket.com/api-reference/markets/get-clob-market-info.md): Returns all CLOB-level parameters for a market in a single call — tokens, tick size, base fees, rewards, RFQ status, and fee details. - [Get server time](https://docs.polymarket.com/api-reference/data/get-server-time.md): Returns the current Unix timestamp of the server. This can be used to synchronize client time with server time. ### Orders - [Post a new order](https://docs.polymarket.com/api-reference/trade/post-a-new-order.md): Creates a new order in the order book. When placing an order as a session signer, use the deposit wallet as both `maker` and `signer`, with the POLY_1271 signature wrapped in a session-signer envelope. - [Cancel single order](https://docs.polymarket.com/api-reference/trade/cancel-single-order.md): Cancels a single order by its ID. Works even in cancel-only mode. - [Get single order by ID](https://docs.polymarket.com/api-reference/trade/get-single-order-by-id.md): Retrieves a specific order by its ID (order hash) for the authenticated user, including canceled or fully matched orders. Builder-authenticated clients can also use this endpoint to retrieve orders attributed to their builder account. - [Post multiple orders](https://docs.polymarket.com/api-reference/trade/post-multiple-orders.md): Creates multiple new orders in the order book. Orders are processed in parallel. Maximum 15 orders per request. - [Get user orders](https://docs.polymarket.com/api-reference/trade/get-user-orders.md): Retrieves live orders for the authenticated user. Returns paginated results. When filtering by asset_id, also include the market condition ID in market. From December 14, 2026, asset-only requests return HTTP 400 (asset_id requires market). Unfiltered and market-only queries remain supported. Filter… - [Get wallet open orders](https://docs.polymarket.com/api-reference/trade/get-wallet-open-orders.md): Lists every live order on the caller's deposit wallet, regardless of which signer or API key placed it. Authenticate with L2 headers or `POLY_READONLY_API_KEY` and `POLY_ADDRESS`. `POLY_ADDRESS` must be the wallet owner or one of its non-revoked session signers. - [Cancel multiple orders](https://docs.polymarket.com/api-reference/trade/cancel-multiple-orders.md): Cancels multiple orders by their IDs. Maximum 1000 orders per request. Duplicate order IDs in the request are automatically ignored. Works even in cancel-only mode. - [Cancel all orders](https://docs.polymarket.com/api-reference/trade/cancel-all-orders.md): Cancels all open orders for the authenticated user. Works even in cancel-only mode. - [Cancel wallet orders](https://docs.polymarket.com/api-reference/trade/cancel-wallet-orders.md): Cancels orders on the deposit wallet across all API keys, including orders from expired session signers. Also served at `/v1/gateway/cancel-wallet-orders`. - [Cancel orders for a market](https://docs.polymarket.com/api-reference/trade/cancel-orders-for-a-market.md): Cancels all open orders for the authenticated user in a specific market (condition) and asset. Works even in cancel-only mode. - [Get order scoring status](https://docs.polymarket.com/api-reference/trade/get-order-scoring-status.md): Checks if a specific order is currently scoring for rewards. - [Send heartbeat](https://docs.polymarket.com/api-reference/trade/send-heartbeat.md): Sends one legacy order heartbeat for the authenticated API key. The first accepted send enables timeout cancellation for all open orders owned by that API key, across markets and processes. Keep sending accepted heartbeats every 5 seconds. No scheduler or disarm operation is provided; stopping sends… ### Trades - [List trades](https://docs.polymarket.com/api-reference/feeds/list-trades.md): Keyset-paginated trade feed in the standard `{ data, pagination }` envelope. - [Get trades](https://docs.polymarket.com/api-reference/trade/get-trades.md): Retrieves trades for the authenticated user. Returns paginated results. Requires readonly or level 2 API key authentication. - [Get builder trades](https://docs.polymarket.com/api-reference/trade/get-builder-trades.md): Retrieves trades attributed to a builder code. ### Rebates - [Get current rebated fees for a maker](https://docs.polymarket.com/api-reference/rebates/get-current-rebated-fees-for-a-maker.md): Returns the current rebated fees for a maker address on a given date. Returns null when the maker has no rebated-fee rows. ### Rewards - [Get current active rewards configurations](https://docs.polymarket.com/api-reference/rewards/get-current-active-rewards-configurations.md): Returns all current active rewards configurations grouped by market. - [Get raw rewards for a specific market](https://docs.polymarket.com/api-reference/rewards/get-raw-rewards-for-a-specific-market.md): Returns an array of present and future rewards configured on a market. - [Get multiple markets with rewards](https://docs.polymarket.com/api-reference/rewards/get-multiple-markets-with-rewards.md): Returns a list of active markets with their reward configurations. Supports text search, tag filtering, numeric filters, and sorting. - [Get earnings for user by date](https://docs.polymarket.com/api-reference/rewards/get-earnings-for-user-by-date.md): Returns an array of user earnings per market for a provided day. - [Get total earnings for user by date](https://docs.polymarket.com/api-reference/rewards/get-total-earnings-for-user-by-date.md): Returns the summed total rewards earnings for a user on a provided day, grouped by asset address. - [Get reward percentages for user](https://docs.polymarket.com/api-reference/rewards/get-reward-percentages-for-user.md): Returns the real-time percentages of rewards that a user is earning per market. - [Get user earnings and markets configuration](https://docs.polymarket.com/api-reference/rewards/get-user-earnings-and-markets-configuration.md): Returns an array of current rewards including user earnings and live percentages per market for a provided day. ### Profile - [Get public profile by wallet address](https://docs.polymarket.com/api-reference/profiles/get-public-profile-by-wallet-address.md) - [Get a user's profile stats](https://docs.polymarket.com/api-reference/wallet/get-a-users-profile-stats.md): The profile card for one wallet in a single call. - [List positions for a user or market](https://docs.polymarket.com/api-reference/wallet/list-positions-for-a-user-or-market.md): A keyset page of positions in the standard `{ data, pagination }` envelope. One route serves a user's open book, their closed book (`status=CLOSED`), and a market's holders (market anchor). - [Get portfolio value](https://docs.polymarket.com/api-reference/wallet/get-portfolio-value.md): The user's portfolio value: single-market holdings marked to market plus unresolved combo positions at cost basis. - [Get a user's PnL series](https://docs.polymarket.com/api-reference/wallet/get-a-users-pnl-series.md): Complete cumulative native-PnL atoms and compositions. - [Get a user's trading volume](https://docs.polymarket.com/api-reference/wallet/get-a-users-trading-volume.md): One wallet's trading volume over a window, in both units side by side. - [List account activity](https://docs.polymarket.com/api-reference/feeds/list-account-activity.md): Keyset-paginated activity feed (trades, splits, merges, redeems, …) in the standard `{ data, pagination }` envelope. - [Get wallet approvals](https://docs.polymarket.com/api-reference/wallet/get-wallet-approvals.md): Polygon token/operator approval state for one wallet. ### Boards - [Get the trader leaderboard](https://docs.polymarket.com/api-reference/boards/get-the-trader-leaderboard.md): The ranked board of realized PnL, combos included. - [List the biggest wins](https://docs.polymarket.com/api-reference/boards/list-the-biggest-wins.md): The biggest single winning positions. - [Get the builders leaderboard](https://docs.polymarket.com/api-reference/boards/get-the-builders-leaderboard.md): The ranked board of builders by volume. - [Get builder volume over time](https://docs.polymarket.com/api-reference/boards/get-builder-volume-over-time.md): The per-builder volume time series. ### Search - [Search markets, events, and profiles](https://docs.polymarket.com/api-reference/search/search-markets-events-and-profiles.md) ### Tags - [List tags](https://docs.polymarket.com/api-reference/tags/list-tags.md) - [Get tag by id](https://docs.polymarket.com/api-reference/tags/get-tag-by-id.md) - [Get tag by slug](https://docs.polymarket.com/api-reference/tags/get-tag-by-slug.md) - [Get related tags (relationships) by tag id](https://docs.polymarket.com/api-reference/tags/get-related-tags-relationships-by-tag-id.md) - [Get related tags (relationships) by tag slug](https://docs.polymarket.com/api-reference/tags/get-related-tags-relationships-by-tag-slug.md) - [Get tags related to a tag id](https://docs.polymarket.com/api-reference/tags/get-tags-related-to-a-tag-id.md) - [Get tags related to a tag slug](https://docs.polymarket.com/api-reference/tags/get-tags-related-to-a-tag-slug.md) ### Series - [List series](https://docs.polymarket.com/api-reference/series/list-series.md) - [Get series by id](https://docs.polymarket.com/api-reference/series/get-series-by-id.md) ### Comments - [List comments](https://docs.polymarket.com/api-reference/comments/list-comments.md) - [Get comments by comment id](https://docs.polymarket.com/api-reference/comments/get-comments-by-comment-id.md) - [Get comments by user address](https://docs.polymarket.com/api-reference/comments/get-comments-by-user-address.md) ### Sports - [Get sports metadata information](https://docs.polymarket.com/api-reference/sports/get-sports-metadata-information.md) - [Get valid sports market types](https://docs.polymarket.com/api-reference/sports/get-valid-sports-market-types.md) - [List teams](https://docs.polymarket.com/api-reference/sports/list-teams.md) ### Relayer - [Submit a transaction](https://docs.polymarket.com/api-reference/relayer/submit-a-transaction.md): Submit a transaction request to the Relayer. Authenticated using Builder API Keys or Relayer API Keys. - [Get a transaction by ID](https://docs.polymarket.com/api-reference/relayer/get-a-transaction-by-id.md): Gets a transaction submitted to the Relayer. Takes in a required transaction ID as a query parameter. - [Get recent transactions for a user](https://docs.polymarket.com/api-reference/relayer/get-recent-transactions-for-a-user.md): Gets the most recent transactions submitted to the Relayer, owned by a specific user. Authenticated using Builder API Keys or Relayer API Keys. - [Get current nonce for a user](https://docs.polymarket.com/api-reference/relayer/get-current-nonce-for-a-user.md): Gets the current Proxy or Safe nonce for a user. Takes in the user's signer address and the type of nonce to retrieve. - [Get relayer address and nonce](https://docs.polymarket.com/api-reference/relayer/get-relayer-address-and-nonce.md): Fetches the relayer address and nonce for a specific user. Takes in the user's signer address and the type of nonce to retrieve. - [Check if a wallet is deployed](https://docs.polymarket.com/api-reference/relayer/check-if-a-wallet-is-deployed.md): Returns whether the wallet at the given address is deployed onchain. - [Get all relayer API keys](https://docs.polymarket.com/api-reference/relayer-api-keys/get-all-relayer-api-keys.md): Returns all relayer API keys for the authenticated address. Auth allowed: Gamma auth or Relayer API key auth (`RELAYER_API_KEY` + `RELAYER_API_KEY_ADDRESS`). ### Combos - [Get combo markets](https://docs.polymarket.com/api-reference/combo-markets/get-combo-markets.md): Returns active markets that can be used as combo legs, ordered by volume descending. This endpoint is public and does not require CLOB authentication. - [Submit a quote](https://docs.polymarket.com/api-reference/maker/submit-a-quote.md): Submit a signed maker quote for an active RFQ. Requires CLOB L2 authentication for the maker role. - [Cancel a quote](https://docs.polymarket.com/api-reference/maker/cancel-a-quote.md): Cancel an active maker quote before it is selected. Requires CLOB L2 authentication for the maker role. `signer_address` and `maker_address` must match the authenticated identity. - [Confirm or decline last look](https://docs.polymarket.com/api-reference/maker/confirm-or-decline-last-look.md): Respond to a last-look confirmation request for a selected quote. Requires CLOB L2 authentication for the maker role. `decision` must be `CONFIRM` or `DECLINE`. - [List combo positions](https://docs.polymarket.com/api-reference/wallet/list-combo-positions.md): Combo positions for a user, in the standard `{ data, pagination }` envelope. - [List combo activity](https://docs.polymarket.com/api-reference/feeds/list-combo-activity.md): Keyset-paginated combo lifecycle + redemption feed for a user, in the standard `{ data, pagination }` envelope. - [Quoter Gateway](https://docs.polymarket.com/api-reference/wss/rfq.md): Authenticated WebSocket for combinatorial RFQ quoters — receive requests, submit quotes, confirm last look, and track execution. ### WebSocket - [Market Channel](https://docs.polymarket.com/api-reference/wss/market.md): Public WebSocket for real-time orderbook, price, and market lifecycle updates. - [User Channel](https://docs.polymarket.com/api-reference/wss/user.md): Authenticated WebSocket for real-time order and trade updates. - [Sports Channel](https://docs.polymarket.com/api-reference/wss/sports.md): Public WebSocket for real-time sports match results. ### PolyBolt WebSocket - [PolyBolt WebSocket](https://docs.polymarket.com/api-reference/live-data/overview.md): Stream crypto, equity and TWAP reference prices over one WebSocket connection. - [Live Data Channel](https://docs.polymarket.com/api-reference/wss/polybolt.md): PolyBolt WebSocket message reference for crypto, equity and TWAP reference prices. #### Websockets - [Live Data Channel](https://docs.polymarket.com/api-reference/websockets/live-data-channel.md): Send JSON text frames tagged with op. The server answers every op with an ack or an error ack (never a close, except for policy breaches, close 4008, and an expired Access Token, close 1008) and pushes envelopes for subscribed channels. Limits per connection: 64 active (channel, filter) subscription… ### Bridge - [Get supported assets](https://docs.polymarket.com/api-reference/bridge/get-supported-assets.md) - [Create bridge addresses](https://docs.polymarket.com/api-reference/bridge/create-bridge-addresses.md) - [Get a quote](https://docs.polymarket.com/api-reference/bridge/get-a-quote.md) - [Get transaction status](https://docs.polymarket.com/api-reference/bridge/get-transaction-status.md): Returns the deposits and withdrawals seen at a bridge address, newest first. Responses are cursor-paginated: each request returns one page plus a `nextCursor`. To read the full history, pass each `nextCursor` back as `cursor` until it comes back null. To track only recent activity, keep requesting t… - [Create withdrawal addresses](https://docs.polymarket.com/api-reference/bridge/create-withdrawal-addresses.md) ## OpenAPI Specs - [clob-openapi](/api-spec/clob-openapi.yaml) - [openapi](https://data-api.polymarket.com/v2/openapi.json) - [gamma-openapi](/api-spec/gamma-openapi.yaml) - [relayer-openapi](/api-spec/relayer-openapi.yaml) - [combos-rfq-openapi](/api-spec/combos-rfq-openapi.yaml) - [bridge-openapi](/api-spec/bridge-openapi.yaml) ## AsyncAPI Specs - [asyncapi-rfq](/asyncapi-rfq.json) - [asyncapi](/asyncapi.json) - [asyncapi](https://ws-live-v2.polymarket.com/asyncapi.json) - [asyncapi-user](/asyncapi-user.json) - [asyncapi-sports](/asyncapi-sports.json)