# Polymarket US Documentation ## Docs - [Welcome](https://docs.polymarket.us/getting-started/welcome.md): Polymarket US - [What is Polymarket US?](https://docs.polymarket.us/getting-started/what-is-polymarket-us.md) - [Glossary](https://docs.polymarket.us/getting-started/glossary.md): Glossary of common Polymarket terms - [Quickstart](https://docs.polymarket.us/getting-started/quickstart.md): Make your first API request in minutes. - [Prices & Market Data](https://docs.polymarket.us/concepts/market-data.md): How prices work and how the order book enables trading on Polymarket US. - [Events & Markets](https://docs.polymarket.us/concepts/events-and-markets.md): Understanding how prediction markets are structured on Polymarket US. - [Orders & Trading](https://docs.polymarket.us/concepts/orders.md): How trading works on Polymarket US — the YES/NO model, order types, and how positions work. - [Collateral and Margin](https://docs.polymarket.us/market-structure/collateral-and-margin.md): Learn how collateral and margin work for long and short positions - [Mutually Exclusive Collateral Return](https://docs.polymarket.us/market-structure/mutually-exclusive-collateral-return.md): How portfolio margin optimization works for mutually exclusive event outcomes - [Directional Collateral Return](https://docs.polymarket.us/market-structure/directional-collateral-return.md): How portfolio margin optimization works for directional event outcomes - [General FAQs](https://docs.polymarket.us/faqs/general-faqs.md): Frequently asked questions about trading on Polymarket US - [Market Integrity FAQs](https://docs.polymarket.us/faqs/market-integrity-faqs.md): Frequently asked questions about market integrity rules on Polymarket US - [Sports FAQs](https://docs.polymarket.us/faqs/sports-faqs.md): Frequently asked questions about trading sports Contracts on Polymarket US - [Weather FAQs](https://docs.polymarket.us/faqs/weather-faqs.md): Frequently asked questions about trading Weather Contracts on Polymarket US - [Refer-A-Friend FAQs](https://docs.polymarket.us/faqs/refer-a-friend-faqs.md): Frequently asked questions about Polymarket US' Refer-A-Friend incentive program - [Polymarket US](https://docs.polymarket.us/learn/home.md): Overview of Polymarket US, a CFTC-regulated exchange for trading event contracts - [Create an Account](https://docs.polymarket.us/learn/get-started/signup.md): Learn how to create your Polymarket US account, verify your identity, and complete Know Your Customer (KYC) securely - [Fund Your Account](https://docs.polymarket.us/learn/get-started/fund-account.md): Learn how to fund your Polymarket US account with debit card, bank transfer (ACH), or wire transfer - [Browse Markets](https://docs.polymarket.us/learn/get-started/browse.md): Learn how to browse active market categories on Polymarket - [Place a Trade](https://docs.polymarket.us/learn/get-started/place-order.md): Learn how to place your first trade on Polymarket - [Monitor Your Positions](https://docs.polymarket.us/learn/get-started/portfolio.md): Learn how to view your portfolio and track open positions - [Check Your Balance](https://docs.polymarket.us/learn/get-started/cash.md): Learn how your cash balance works, including deposits, withdrawals, and available funds - [Overview](https://docs.polymarket.us/learn/deposits/deposit-methods/overview.md): Deposit with debit card, bank transfer (ACH), or wire transfer - [Debit Card](https://docs.polymarket.us/learn/deposits/deposit-methods/debit-card.md): Deposit instantly using a debit card - [Bank Transfer (ACH)](https://docs.polymarket.us/learn/deposits/deposit-methods/bank-transfer.md): Deposit using a bank transfer (ACH) via Aeropay - [Wire Transfer](https://docs.polymarket.us/learn/deposits/deposit-methods/wire-transfer.md): Fund your account by wire transfer - [Troubleshooting](https://docs.polymarket.us/learn/deposits/deposit-methods/troubleshooting.md): Resolve common deposit issues and contact support if needed - [Overview](https://docs.polymarket.us/learn/deposits/withdraw-funds/overview.md): Withdraw your cash balance securely and for free - [Withdrawal Rules](https://docs.polymarket.us/learn/deposits/withdraw-funds/rules.md): Withdrawals follow strict rules to meet compliance requirements - [Troubleshooting](https://docs.polymarket.us/learn/deposits/withdraw-funds/troubleshooting.md): Resolve common withdrawal issues and contact support if needed - [Market Creation](https://docs.polymarket.us/learn/markets/how-markets-are-created.md): Learn how Polymarket creates and lists event-based markets across politics, sports, and more - [Market Structure](https://docs.polymarket.us/learn/trading/basics/buying-yes-vs-selling-no.md): Understand how Polymarket US markets use a single instrument per outcome - [Market Rules](https://docs.polymarket.us/learn/advanced/rule-structure.md): Learn the structure of market rules and how each part affects resolution - [Market Clarification](https://docs.polymarket.us/learn/markets/clarifications.md): Learn how Polymarket US uses clarifications to explain market rules - [Market Resolution](https://docs.polymarket.us/learn/markets/market-resolution.md): Learn how Polymarket US determines outcomes for event contracts - [Market Settlement](https://docs.polymarket.us/learn/markets/contract-settlement.md): Learn how Polymarket US and Polymarket Clearing settle and finalize event contracts after resolution - [Liquidity](https://docs.polymarket.us/learn/advanced/liquidity.md): Learn how posted size across price levels affects where your order fills - [Price Impact](https://docs.polymarket.us/learn/advanced/price-impact.md): Learn how order size moves prices and affects your execution - [Order Placement](https://docs.polymarket.us/learn/trading/basics/place-order.md): Learn how to place an order on Polymarket - [Order Types](https://docs.polymarket.us/learn/trading/basics/order-types.md): Learn how marketable limit orders execute and how fills work - [Spreads](https://docs.polymarket.us/learn/trading/basics/spread.md): Learn how the gap between bid and ask affects your execution price - [Fractional Contracts](https://docs.polymarket.us/learn/trading/basics/fractional-shares.md): Learn why Polymarket US only supports whole contracts and does not offer fractional contracts - [Odds Display](https://docs.polymarket.us/learn/trading/prices-and-fees/odds-display.md): Learn how to switch between percent and price display in the app - [Price Slippage](https://docs.polymarket.us/learn/trading/prices-and-fees/price-slippage.md): Learn how price slippage occurs and how to reduce its impact - [Fee Schedule](https://docs.polymarket.us/fees.md): Trading fee schedule, rebates, and examples - [Trading Hours](https://docs.polymarket.us/learn/trading/access-and-limits/trading-hours.md): Learn about Polymarket US trading availability, reporting schedule, and maintenance policy - [Trading Limits](https://docs.polymarket.us/learn/trading/access-and-limits/trading-limits.md): Understand Polymarket US trading limits - [Trading Restrictions](https://docs.polymarket.us/learn/trading/access-and-limits/trading-restrictions.md): Guidelines for trading on Polymarket US under compliance and eligibility rules - [Protect Your Account](https://docs.polymarket.us/learn/account/protect.md): Keep your password, login, and personal access secure - [Why is my account under review?](https://docs.polymarket.us/learn/get-started/account-under-review.md): Understand why your account might be under review and what happens next - [Can I sell early?](https://docs.polymarket.us/learn/trading/basics/sell-early.md): Cash out your positions at any time - [Why can't I withdraw my funds?](https://docs.polymarket.us/learn/faq/withdraw-funds.md) - [Why can't I withdraw my promotional credit?](https://docs.polymarket.us/learn/faq/withdraw-promo.md) - [What is a prediction market?](https://docs.polymarket.us/learn/faq/prediction-market.md) - [How are Polymarket odds determined?](https://docs.polymarket.us/learn/faq/odds.md) - [Is my money safe?](https://docs.polymarket.us/learn/faq/money-safety.md) - [Why does my position look down right after I buy?](https://docs.polymarket.us/learn/faq/whole-contracts.md) - [How does Polymarket compare to polling?](https://docs.polymarket.us/learn/faq/polling.md) - [How does Polymarket drive social good?](https://docs.polymarket.us/learn/faq/social-good.md) - [Does Polymarket have an API?](https://docs.polymarket.us/learn/faq/api.md) - [How do I contact support?](https://docs.polymarket.us/learn/faq/contact-support.md): How to reach Polymarket US support - [Introduction](https://docs.polymarket.us/api-reference/introduction.md): Overview of the Polymarket US API - [Authentication](https://docs.polymarket.us/api-reference/authentication.md): How to get API keys and make authenticated requests. - [Rate Limits](https://docs.polymarket.us/api-reference/rate-limits.md): API rate limits and how to stay within them. - [Orders API Overview](https://docs.polymarket.us/api-reference/orders/overview.md): Create, cancel, and manage orders - [Get Open Orders](https://docs.polymarket.us/api-reference/orders/get-open-orders.md): Get all open orders for the authenticated user - [Get Order](https://docs.polymarket.us/api-reference/orders/get-order.md): Get details for a specific order by its exchange-assigned ID - [Create Order](https://docs.polymarket.us/api-reference/orders/create-order.md): Create a new order to enter into a market - [Cancel All Open Orders](https://docs.polymarket.us/api-reference/orders/cancel-all-open-orders.md): Cancel all open orders, optionally filtered by market slugs - [Cancel Order](https://docs.polymarket.us/api-reference/orders/cancel-order.md): Cancel a specific order by its exchange-assigned ID - [Modify Order](https://docs.polymarket.us/api-reference/orders/modify-order.md): Modify an existing order in the marketplace. Allows changing price, quantity, time in force, and other parameters. - [Preview Order](https://docs.polymarket.us/api-reference/orders/preview-order.md): Preview an order before submission to validate parameters and see expected fills - [Close Position Order](https://docs.polymarket.us/api-reference/orders/close-position-order.md): Create an order to close an existing position in a market. This will sell all contracts held in the specified market. - [Create Multiple Orders](https://docs.polymarket.us/api-reference/orders/create-multiple-orders.md): Create up to 20 orders in a single request. If any entry fails request-shape validation, the whole batch is rejected by the gateway before reaching the exchange. Per-entry exchange outcomes (accept, fill, reject) are delivered on the order stream, not in this response. `createdOrderIds` are returned… - [Cancel Multiple Orders](https://docs.polymarket.us/api-reference/orders/cancel-multiple-orders.md): Cancel up to 20 orders in a single request. If any entry fails request-shape validation, the whole batch is rejected by the gateway before reaching the exchange. The exchange may silently ignore unknown `orderId`s. `canceledOrderIds` is an echo of the request, not a confirmation; observe actual outc… - [Modify Multiple Orders](https://docs.polymarket.us/api-reference/orders/modify-multiple-orders.md): Modify up to 20 existing orders in a single request. Each entry is forwarded to the exchange as a cancel-replace. If any entry fails request-shape validation, the whole batch is rejected by the gateway before reaching the exchange. The exchange may silently ignore unknown `orderId`s. `modifiedOrderI… - [Combos API Overview](https://docs.polymarket.us/api-reference/combos/overview.md): Create and read combo instruments through the Retail API - [Get combos](https://docs.polymarket.us/api-reference/combos/get-combos.md): Returns the combo matching the exact symbol. - [Create combo](https://docs.polymarket.us/api-reference/combos/create-combo.md): Creates or returns the combo instrument for the supplied legs. Each authenticated exchange participant may create up to 1,000 new combo instruments per week across all of its accounts. The quota resets Monday at 00:00 UTC. Returning an existing canonical combo does not consume the quota. - [RFQ API Overview](https://docs.polymarket.us/api-reference/rfqs/overview.md): Create and manage combo RFQs and quotes through the Retail API - [Get RFQs](https://docs.polymarket.us/api-reference/rfqs/get-rfqs.md): Returns RFQs matching the query filters. - [Create RFQ](https://docs.polymarket.us/api-reference/rfqs/create-rfq.md): Creates a combo RFQ. - [Get quotes](https://docs.polymarket.us/api-reference/rfqs/get-quotes.md): Returns quotes matching the query filters. - [Create quote](https://docs.polymarket.us/api-reference/rfqs/create-quote.md): Creates a quote for an RFQ. - [Get RFQ user ID](https://docs.polymarket.us/api-reference/rfqs/get-rfq-user-id.md): Returns the public RFQ user ID for the authenticated participant. - [Delete RFQ](https://docs.polymarket.us/api-reference/rfqs/delete-rfq.md): Closes an open RFQ. - [Delete quote](https://docs.polymarket.us/api-reference/rfqs/delete-quote.md): Deletes a quote so it can no longer be accepted. - [Accept quote](https://docs.polymarket.us/api-reference/rfqs/accept-quote.md): Accepts one side of a quote. - [Confirm quote](https://docs.polymarket.us/api-reference/rfqs/confirm-quote.md): Confirms an accepted quote during last look. - [Portfolio API Overview](https://docs.polymarket.us/api-reference/portfolio/overview.md): View positions, balances, and trading activity - [Get User Positions](https://docs.polymarket.us/api-reference/portfolio/get-user-positions.md): Get user's trading positions across all markets or filtered by specific market - [Get Activities](https://docs.polymarket.us/api-reference/portfolio/get-activities.md): Get activities for a user including trades, position resolutions, and account balance changes - [Get Account Balances](https://docs.polymarket.us/api-reference/account/get-account-balances.md): Get user's current account balances including buying power, asset values, and pending transactions - [Events API Overview](https://docs.polymarket.us/api-reference/events/overview.md): Event data endpoints - [Get Events](https://docs.polymarket.us/api-reference/events/get-events.md): Retrieve all events - [Get Event By Slug](https://docs.polymarket.us/api-reference/events/get-event-by-slug.md): Retrieve an event by its slug - [Get Event By ID](https://docs.polymarket.us/api-reference/events/get-event-by-id.md): Retrieve a specific event by its ID - [Get Event By Partner External ID](https://docs.polymarket.us/api-reference/partners/get-event-by-partner-external-id.md): Resolve a partner external event ID (e.g. OpticOdds fixture ID) to the internal event and its mapped market sides - [Markets API Overview](https://docs.polymarket.us/api-reference/market/overview.md): Query market data and information - [Get Market By ID](https://docs.polymarket.us/api-reference/markets/get-market-by-id.md): Retrieve a specific market by its ID - [Get Market By Slug](https://docs.polymarket.us/api-reference/markets/get-market-by-slug.md): Retrieve a specific market by its slug - [Get Markets](https://docs.polymarket.us/api-reference/markets/get-markets.md): Retrieve all markets - [Get Market BBO](https://docs.polymarket.us/api-reference/markets/get-market-bbo.md): Retrieve current market data (best bid/offer, stats) for a specific market by its slug in a lightweight format - [Get Market Book](https://docs.polymarket.us/api-reference/markets/get-market-book.md): Retrieve current market data (order book, stats) for a specific market by its slug - [Get Market Settlement](https://docs.polymarket.us/api-reference/markets/get-market-settlement.md): Retrieve the settlement price for a specific market by its slug - [Series API Overview](https://docs.polymarket.us/api-reference/series/overview.md): Series data endpoints - [Get Series](https://docs.polymarket.us/api-reference/series/get-series.md): Retrieve all series - [Get Series By ID](https://docs.polymarket.us/api-reference/series/get-series-by-id.md): Retrieve a specific series by its ID - [Sports API Overview](https://docs.polymarket.us/api-reference/sports/overview.md): Sports event data by league and sport - [Get All Leagues](https://docs.polymarket.us/api-reference/sports/get-all-leagues.md): Retrieve leagues with pagination (max 50 per page) - [Get League By Slug](https://docs.polymarket.us/api-reference/sports/get-league-by-slug.md): Retrieve a league by its slug - [Get Events By League Slug](https://docs.polymarket.us/api-reference/sports/get-events-by-league-slug.md): Retrieve events for a league by its slug (e.g., 'nfl', 'nba'). Resolves the league to its active series and returns events. - [Get All Sports](https://docs.polymarket.us/api-reference/sports/get-all-sports.md): Retrieve all sports - [Get Sport By Slug](https://docs.polymarket.us/api-reference/sports/get-sport-by-slug.md): Retrieve a sport by its slug, with all leagues attached - [Get Events By Sport Slug](https://docs.polymarket.us/api-reference/sports/get-events-by-sport-slug.md): Retrieve events for a sport by its slug (e.g., 'football', 'basketball'). Fetches all leagues for the sport, collects their active series, and returns combined events. - [Sports API Overview (Legacy)](https://docs.polymarket.us/api-reference/sports-legacy/overview.md): Legacy v1 sports data endpoints - [Get Sports](https://docs.polymarket.us/api-reference/sports/get-sports.md): Fetch sports data - [Get Sports Teams](https://docs.polymarket.us/api-reference/sports/get-sports-teams.md): Fetch sports teams data for enriching sports events - [Get Sports Teams For Provider](https://docs.polymarket.us/api-reference/sports/get-sports-teams-for-provider.md): Fetch sports teams data for a specific provider - [Get Sports Events](https://docs.polymarket.us/api-reference/sports/get-sports-events.md): Retrieve events sections for a sport series (optional trending, optional live, and sport section). Same structure as home page. - [Tags API Overview](https://docs.polymarket.us/api-reference/tags/overview.md): Query tags and featured tags - [Get Tags](https://docs.polymarket.us/api-reference/tags/get-tags.md): Get ranked tags with optional filtering - [Get Tag By Slug](https://docs.polymarket.us/api-reference/tags/get-tag-by-slug.md): Get a tag by its slug - [Get Tag By ID](https://docs.polymarket.us/api-reference/tags/get-tag-by-id.md): Get a tag by its ID - [Get Events For A Tag](https://docs.polymarket.us/api-reference/tags/get-events-for-a-tag.md): Get events filtered by tag slug, sorted by volume descending by default - [Search API Overview](https://docs.polymarket.us/api-reference/search/overview.md): Search for events and markets - [Search](https://docs.polymarket.us/api-reference/search/search.md): Search for a given query - [Incentives API Overview](https://docs.polymarket.us/api-reference/incentives/overview.md): View incentive programs and your earned rewards - [Get Incentive Programs](https://docs.polymarket.us/api-reference/incentives/get-incentive-programs.md): Get incentive programs for each market. This endpoint is public and requires no authentication. - [Get Your Incentive Earnings](https://docs.polymarket.us/api-reference/incentives/get-your-incentive-earnings.md): Returns rewards earned by the authenticated caller. Each entry sums all payouts for a single (market, date) pair, where date is in Eastern Time. - [WebSocket API Overview](https://docs.polymarket.us/api-reference/websocket/overview.md): Real-time streaming data via WebSocket - [Private WebSocket](https://docs.polymarket.us/api-reference/websocket/private.md): Real-time orders, positions, balances, and RFQ updates - [Markets WebSocket](https://docs.polymarket.us/api-reference/websocket/markets.md): Real-time market data, order book, and trades - [Introduction](https://docs.polymarket.us/api-reference/sdks/introduction.md): Official SDKs for the Polymarket US API - [Quickstart](https://docs.polymarket.us/api-reference/sdks/python/quickstart.md): Get started with the Python SDK - [Events](https://docs.polymarket.us/api-reference/sdks/python/events.md): Retrieve and filter events - [Markets](https://docs.polymarket.us/api-reference/sdks/python/markets.md): Query market data, order books, and prices - [Orders](https://docs.polymarket.us/api-reference/sdks/python/orders.md): Create, cancel, and manage orders - [Portfolio](https://docs.polymarket.us/api-reference/sdks/python/portfolio.md): View positions and trading activity - [Account](https://docs.polymarket.us/api-reference/sdks/python/account.md): View account balances and buying power - [Series](https://docs.polymarket.us/api-reference/sdks/python/series.md): Browse event series - [Sports](https://docs.polymarket.us/api-reference/sdks/python/sports.md): Sports configuration and team data - [Search](https://docs.polymarket.us/api-reference/sdks/python/search.md): Search for events and markets - [WebSocket](https://docs.polymarket.us/api-reference/sdks/python/websocket.md): Real-time streaming data - [Quickstart](https://docs.polymarket.us/api-reference/sdks/typescript/quickstart.md): Get started with the TypeScript SDK - [Events](https://docs.polymarket.us/api-reference/sdks/typescript/events.md): Retrieve and filter events - [Markets](https://docs.polymarket.us/api-reference/sdks/typescript/markets.md): Query market data, order books, and prices - [Orders](https://docs.polymarket.us/api-reference/sdks/typescript/orders.md): Create, cancel, and manage orders - [Portfolio](https://docs.polymarket.us/api-reference/sdks/typescript/portfolio.md): View positions and trading activity - [Account](https://docs.polymarket.us/api-reference/sdks/typescript/account.md): View account balances and buying power - [Series](https://docs.polymarket.us/api-reference/sdks/typescript/series.md): Browse event series - [Sports](https://docs.polymarket.us/api-reference/sdks/typescript/sports.md): Sports configuration and team data - [Search](https://docs.polymarket.us/api-reference/sdks/typescript/search.md): Search for events and markets - [WebSocket](https://docs.polymarket.us/api-reference/sdks/typescript/websocket.md): Real-time streaming data - [Trader Guide Overview](https://docs.polymarket.us/trader-guide/overview.md): Connect to the Polymarket Exchange for direct market access trading - [Onboarding](https://docs.polymarket.us/trader-guide/onboarding.md): Get started with the Polymarket Exchange API - [Registration](https://docs.polymarket.us/trader-guide/authentication.md): Setting up Private Key JWT authentication to access the API - [Quickstart](https://docs.polymarket.us/trader-guide/quickstart.md): Place your first order in 5 minutes - [Environments](https://docs.polymarket.us/trader-guide/environments.md): API endpoints for preprod and production environments - [Rate Limits](https://docs.polymarket.us/trader-guide/rate-limits.md): API rate limits and best practices for integration - [Connection Options](https://docs.polymarket.us/trader-guide/connection-options.md) - [Health Check](https://docs.polymarket.us/trader-guide/health-check.md): Monitor API service status - [Accounts & Identity](https://docs.polymarket.us/trader-guide/accounts-identity.md): Understanding account hierarchy and identity resolution - [Authentication](https://docs.polymarket.us/trader-guide/authentication-troubleshooting.md): Resolving authentication and authorization issues - [Market Data](https://docs.polymarket.us/trader-guide/market-data.md): Accessing market data and order books - [Sports Schema](https://docs.polymarket.us/trader-guide/sports-schema.md): Common instrument fields for safely identifying sports markets - [Combos](https://docs.polymarket.us/trader-guide/combos.md): Quote combo requests distributed through the RFQ API - [Order Management](https://docs.polymarket.us/trader-guide/order-management.md): Best practices and troubleshooting for order operations - [Positions & Risk](https://docs.polymarket.us/trader-guide/positions-risk.md): Position tracking and risk management - [Reporting Data](https://docs.polymarket.us/trader-guide/reporting.md): Historical data, trade searches, and drop copy - [Streaming](https://docs.polymarket.us/trader-guide/streaming-apis.md): Real-time data streaming semantics and best practices - [Error Handling](https://docs.polymarket.us/trader-guide/error-handling.md): Understanding and handling API errors - [Connection Issues](https://docs.polymarket.us/trader-guide/connection-issues.md): Troubleshooting network and connectivity problems - [REST API Overview](https://docs.polymarket.us/institutional/introduction.md): Complete guide to the Polymarket US REST API - [Health API Overview](https://docs.polymarket.us/institutional/health/overview.md): Service health check endpoint - [Health check](https://docs.polymarket.us/api-reference/health/health-check.md): Check service health status. Returns 200 OK when the service is healthy. - [Trading API Overview](https://docs.polymarket.us/institutional/trading/overview.md): Insert, cancel, and manage orders - [Insert order](https://docs.polymarket.us/api-reference/trading/insert-order.md): Inserts an order into the exchange - [Cancel order](https://docs.polymarket.us/api-reference/trading/cancel-order.md): Requests cancellation of a working order - [Cancel order list](https://docs.polymarket.us/api-reference/trading/cancel-order-list.md): Requests cancellation of multiple working orders. Maximum batch size is 20 orders; requests exceeding this limit will be rejected. - [Insert order cross](https://docs.polymarket.us/api-reference/trading/insert-order-cross.md): Creates a new order cross - [Insert order list](https://docs.polymarket.us/api-reference/trading/insert-order-list.md): Inserts multiple orders into the exchange. Maximum batch size is 20 orders; requests exceeding this limit will be rejected. - [Get open orders](https://docs.polymarket.us/api-reference/trading/get-open-orders.md): Returns a snapshot of working orders - [Preview order](https://docs.polymarket.us/api-reference/trading/preview-order.md): Creates an order preview without inserting it - [Cancel replace order](https://docs.polymarket.us/api-reference/trading/cancel-replace-order.md): Requests modification of a working order - [Cancel replace order list](https://docs.polymarket.us/api-reference/trading/cancel-replace-order-list.md): Requests modification of multiple working orders. Maximum batch size is 20 orders; requests exceeding this limit will be rejected. - [Combos API Overview](https://docs.polymarket.us/institutional/combos/overview.md): Create and read combo instruments - [RFQ API Overview](https://docs.polymarket.us/institutional/rfqs/overview.md): Create and manage combo RFQs and quotes - [Report API Overview](https://docs.polymarket.us/institutional/report/overview.md): Search and export orders, trades, and executions - [Download executions CSV](https://docs.polymarket.us/api-reference/report/download-executions-csv.md): Downloads executions as a CSV file stream - [Search executions](https://docs.polymarket.us/api-reference/report/search-executions.md): Searches for exchange executions using the given details to filter - [Download orders CSV](https://docs.polymarket.us/api-reference/report/download-orders-csv.md): Downloads orders as a CSV file stream - [Search orders](https://docs.polymarket.us/api-reference/report/search-orders.md): Searches for exchange orders using the given details to filter - [Download trades CSV](https://docs.polymarket.us/api-reference/report/download-trades-csv.md): Downloads trades as a CSV file stream - [Search trades](https://docs.polymarket.us/api-reference/report/search-trades.md): Searches for exchange trades using the given details to filter - [Get trade stats](https://docs.polymarket.us/api-reference/report/get-trade-stats.md): Gets aggregated trade data for a given period of time - [Positions API Overview](https://docs.polymarket.us/institutional/positions/overview.md): Query account balances and positions - [List account positions](https://docs.polymarket.us/api-reference/positions/list-account-positions.md): Lists all positions within an account - [Get account balance](https://docs.polymarket.us/api-reference/positions/get-account-balance.md): Gets the balance for a currency in an account - [List account balances](https://docs.polymarket.us/api-reference/positions/list-account-balances.md): Lists all currency balances in an account - [Get position ledger](https://docs.polymarket.us/api-reference/positions/get-position-ledger.md): Returns historical position changes for an account. - [Download position ledger as CSV](https://docs.polymarket.us/api-reference/positions/download-position-ledger-as-csv.md): Streams position ledger as CSV. - [Funding Overview](https://docs.polymarket.us/institutional/funding/overview.md): Cash balance changes (deposits, withdrawals, fills, fees, adjustments) - [Get account balance ledger](https://docs.polymarket.us/api-reference/funding/get-account-balance-ledger.md): Returns historical balance changes for an account. - [Download account balance ledger as CSV](https://docs.polymarket.us/api-reference/funding/download-account-balance-ledger-as-csv.md): Streams balance ledger as CSV. - [Order Book API Overview](https://docs.polymarket.us/institutional/orderbook/overview.md): Access L2 order book snapshots and best bid/offer (BBO) data - [Get order book](https://docs.polymarket.us/api-reference/order-book/get-order-book.md): Returns the current aggregated order book for a symbol - [Get best bid/offer](https://docs.polymarket.us/api-reference/order-book/get-best-bidoffer.md): Returns the top of book (best bid and offer) for a symbol - [Reference Data API Overview](https://docs.polymarket.us/institutional/refdata/overview.md): Instruments, symbols, and market metadata - [List instruments](https://docs.polymarket.us/api-reference/referencedata/list-instruments.md): Returns a list of instruments matching the request - [Get instrument metadata](https://docs.polymarket.us/api-reference/referencedata/get-instrument-metadata.md): Returns miscellaneous instrument metadata - [List symbols](https://docs.polymarket.us/api-reference/referencedata/list-symbols.md): Returns a list of symbols on the exchange - [Accounts API Overview](https://docs.polymarket.us/institutional/accounts/overview.md): User and account management for partners - [List accounts](https://docs.polymarket.us/api-reference/accounts/list-accounts.md): Returns the accounts that the user may use to trade - [List users](https://docs.polymarket.us/api-reference/accounts/list-users.md): Returns the users that the caller may trade on behalf of - [Get who am I](https://docs.polymarket.us/api-reference/accounts/get-who-am-i.md): Returns the user information of the caller - [Payments Overview](https://docs.polymarket.us/institutional/payments/overview.md): Funding options for deposits and withdrawals - [Aeropay Integration](https://docs.polymarket.us/institutional/payments/aeropay-guide.md): Bank account linking and ACH transfers - [Checkout Integration](https://docs.polymarket.us/institutional/payments/checkout-guide.md): Card payment processing via Checkout.com - [Funding Management](https://docs.polymarket.us/institutional/payments/funding-management.md): Manage funding sources, accounts, and transactions - [Incentives API Overview](https://docs.polymarket.us/institutional/incentives/overview.md): View incentive programs and your earnings - [Get Incentive Earnings](https://docs.polymarket.us/api-reference/incentives/get-incentive-earnings.md): Get incentive earnings for the authenticated user. Returns reward records grouped by market, date (Eastern Time), and payout status. Dates are bucketed by ET midnight boundaries. - [gRPC API Overview](https://docs.polymarket.us/grpc-api/overview.md): Guide to using gRPC unary (request/response) methods on Polymarket Exchange - [gRPC Streaming Overview](https://docs.polymarket.us/streaming-endpoints/grpc-overview.md): Introduction to real-time data streaming on Polymarket Exchange - [Getting Started with gRPC Streaming](https://docs.polymarket.us/streaming-endpoints/getting-started.md): Quick start guide for setting up gRPC streaming with Python - [Authentication](https://docs.polymarket.us/streaming-endpoints/authentication.md): How to authenticate with the Polymarket Exchange API using Private Key JWT - [Market Data Streaming](https://docs.polymarket.us/streaming-endpoints/market-data-stream.md): Real-time market data streaming via gRPC with Python - [Order Execution Streaming](https://docs.polymarket.us/streaming-endpoints/order-stream.md): Real-time order and execution updates via gRPC with Python - [RFQ Events Streaming](https://docs.polymarket.us/streaming-endpoints/rfq-events-stream.md): Live combo RFQ and quote events through RFQAPI - [DropCopy & Trade Capture Streaming](https://docs.polymarket.us/streaming-endpoints/dropcopy-stream.md): Real-time execution reports and trade capture via gRPC - [Funding Transaction Streaming](https://docs.polymarket.us/streaming-endpoints/funding-stream.md): Real-time funding transaction state changes via gRPC - [Balance Ledger Streaming](https://docs.polymarket.us/streaming-endpoints/balance-ledger-stream.md): Real-time balance ledger entries via gRPC, with replay-from-resume_time - [Protocol Buffer Reference](https://docs.polymarket.us/streaming-endpoints/proto-reference.md): Complete reference for gRPC message definitions and Python code generation - [Error Handling & Best Practices](https://docs.polymarket.us/streaming-endpoints/error-handling.md): Handle errors, implement reconnection strategies, and follow best practices with Python - [FIX API Overview](https://docs.polymarket.us/institutional/fix-api/fix-overview.md) - [REST/gRPC vs FIX](https://docs.polymarket.us/institutional/fix-api/fix-vs-rest.md): Understanding the differences between REST/gRPC and FIX APIs - [FIX Connection Setup](https://docs.polymarket.us/institutional/fix-api/fix-connection-setup.md) - [FIX FAQs](https://docs.polymarket.us/institutional/fix-api/fix-faqs.md) - [FIX Components](https://docs.polymarket.us/institutional/fix-api/fix-component-definitions.md) - [FIX API Reference Data](https://docs.polymarket.us/institutional/fix-api/fix-api-reference-data.md) - [FIX Session Management](https://docs.polymarket.us/institutional/fix-api/fix-session-management.md) - [FIX Data Types](https://docs.polymarket.us/institutional/fix-api/fix-appendix-a-fix-data-types.md) - [FIX Reject Reasons](https://docs.polymarket.us/institutional/fix-api/fix-reject-reasons.md): Error codes and reject messages across FIX sessions - [Order Entry Overview](https://docs.polymarket.us/institutional/fix-api/fix-order-entry-overview.md) - [Self-Match Prevention](https://docs.polymarket.us/institutional/fix-api/fix-self-match-prevention.md) - [Mass Quote Protection](https://docs.polymarket.us/institutional/fix-api/fix-mass-quote-protection.md) - [NewOrderSingle](https://docs.polymarket.us/institutional/fix-api/fix-new-order-single.md) - [ExecutionReport](https://docs.polymarket.us/institutional/fix-api/fix-execution-report.md) - [Stop Orders](https://docs.polymarket.us/institutional/fix-api/fix-stop-orders.md) - [Order Modification](https://docs.polymarket.us/institutional/fix-api/fix-order-modification.md) - [Order Cancellation](https://docs.polymarket.us/institutional/fix-api/fix-order-cancellation.md) - [Market Data Subscription](https://docs.polymarket.us/institutional/fix-api/fix-market-data-subscription.md) - [Incremental Market Data](https://docs.polymarket.us/institutional/fix-api/fix-market-data-incremental.md) - [Unsubscribing from Market Data](https://docs.polymarket.us/institutional/fix-api/fix-market-data-unsubscribe.md) - [Drop Copy Overview](https://docs.polymarket.us/institutional/fix-api/fix-drop-copy-overview.md) - [ExecutionReport Message](https://docs.polymarket.us/institutional/fix-api/fix-drop-copy-execution-report.md) - [Drop Copy Configurations](https://docs.polymarket.us/institutional/fix-api/fix-drop-copy-configurations.md) - [Overview](https://docs.polymarket.us/incentives/overview.md): Polymarket operates a variety of incentive programs for all traders. - [User Incentive Programs](https://docs.polymarket.us/incentives/user-programs.md): Deposit, Refer-A-Friend, and Daily Trading Incentive Programs for Polymarket US Participants. - [Volume Incentive Program](https://docs.polymarket.us/incentives/volume.md): Earn rewards based on your share of trading volume on eligible contracts. - [Liquidity Incentive Program](https://docs.polymarket.us/incentives/liquidity.md): Earn rewards for placing resting orders close to the best price. - [Market Maker Program](https://docs.polymarket.us/incentives/market-maker.md): Apply to provide stable liquidity across a wide range of contracts. - [Referral Incentive Program](https://docs.polymarket.us/incentives/referral.md): Earn rewards for referring new traders to Polymarket US. - [Data Guide Overview](https://docs.polymarket.us/data-guide/overview.md): Connect to the Polymarket Exchange for read-only market data consumption - [Onboarding](https://docs.polymarket.us/data-guide/onboarding.md): Get started with the Polymarket Exchange API - [Candlestick Data](https://docs.polymarket.us/data-guide/candlestick-data.md): Generate candlestick data for market analysis and charting - [Market Data](https://docs.polymarket.us/data-guide/market-data.md): Access real-time and historical market data from the Polymarket Exchange - [Reference Data](https://docs.polymarket.us/data-guide/reference-data.md): Query instruments, symbols, and metadata from the Polymarket Exchange - [Sports Data](https://docs.polymarket.us/data-guide/sports-data.md): Sports teams and league data available through the ISV gateway - [Asset Master](https://docs.polymarket.us/data-guide/asset-master.md): Hierarchical structure of instruments on the Polymarket Exchange - [Naming Conventions](https://docs.polymarket.us/data-guide/asset-naming-conventions.md): ID formats and naming patterns for instruments and events - [Time & Sales Report](https://docs.polymarket.us/faqs/execution-tape.md): Execution tape with time, price, size, and symbol - [Daily Market Report](https://docs.polymarket.us/faqs/eod-reporting.md): EOD contract summary - [Partner Integration](https://docs.polymarket.us/partners/overview.md): Build a trading experience on Polymarket US as an Introducing Broker or Independent Software Vendor. - [Your Role as a Partner](https://docs.polymarket.us/partners/your-role.md): How IBs and ISVs integrate with Polymarket US as message facilitators — what you do, what we do, and what you never have to handle. - [Platform Model](https://docs.polymarket.us/partners/platform-model.md): How Polymarket US is structured as a DCM and DCO, and the entity model you integrate against. - [Integration Journey](https://docs.polymarket.us/partners/integration-journey.md): The end-to-end path from partner onboarding to live trading — and the recommended order to build it. - [Partner Glossary](https://docs.polymarket.us/partners/glossary.md): Terminology used throughout the Partner Integration docs, including the entities you act on and the people you onboard. - [ISVs](https://docs.polymarket.us/partners/partner-types/isvs.md): Independent Software Vendors building a trading experience on Polymarket US. - [IBs](https://docs.polymarket.us/partners/partner-types/ibs.md): Introducing Brokers building a trading experience on Polymarket US. - [FCMs](https://docs.polymarket.us/partners/partner-types/fcms.md): Guide for Futures Commission Merchant integrations - [Partner Onboarding](https://docs.polymarket.us/partners/get-connected/onboarding.md): What partner onboarding involves: the inputs we need from you and the credentials and access you receive. - [Authentication](https://docs.polymarket.us/partners/get-connected/authentication.md): High-level overview of Private Key JWT authentication for partners, with the partner-specific details and a pointer to the full implementation guide. - [Quickstart](https://docs.polymarket.us/partners/get-connected/quickstart.md): Onboard a participant, fund their trading account, and place their first order with a declared vendor fee. - [Onboard Participants](https://docs.polymarket.us/partners/onboarding/onboard-participants.md): How a retail trader becomes a tradable Participant: KYC is the onboarding process, and a Participant and Account are created automatically on approval. - [Overview](https://docs.polymarket.us/partners/onboarding/kyc/overview.md): How identity verification works for partners: the Socure-backed KYC process, its four outcomes, and the integration architecture. - [Digital Intelligence](https://docs.polymarket.us/partners/onboarding/kyc/digital-intelligence.md): Capture the Socure Digital Intelligence session_token to keep your instant-approval rate high and your REVIEW rate low. - [Verification Flow](https://docs.polymarket.us/partners/onboarding/kyc/verification-flow.md): Submit a participant for KYC and handle each of the four outcomes: instant approval, document verification, manual review, and rejection. - [Prefill Flow](https://docs.polymarket.us/partners/onboarding/kyc/prefill-flow.md): Optionally pre-populate the KYC form from a phone number and date of birth to reduce data entry. - [Webhooks](https://docs.polymarket.us/partners/onboarding/kyc/webhooks.md): Receive terminal KYC outcomes (approved / rejected) via signed webhooks. - [Participants](https://docs.polymarket.us/partners/onboarding/users.md): The lifecycle of a Retail Participant and how to see who your Firm can act on behalf of. - [Accounts](https://docs.polymarket.us/partners/onboarding/accounts.md): Trading account management for partners - [Partner Funding](https://docs.polymarket.us/partners/funding/overview.md): How participant trading accounts are funded — instant deposits from your funding entity's pre-positioned pool, order-time vendor fee declaration, and periodic fee collection. - [Deposits & Withdrawals](https://docs.polymarket.us/partners/funding/deposits-withdrawals.md): Mirroring wallet allocations into on-platform buying power with deposit and withdrawal transfers. - [Vendor Fees](https://docs.polymarket.us/partners/funding/vendor-fees.md): How vendor fees are declared per order, accrue as a receivable, appear on the daily Vendor Fees report, and are collected with one transfer per participant account. - [Transfers](https://docs.polymarket.us/partners/funding/transfers.md): The cash-movement API for deposits, withdrawals, and vendor fee collection between the partner funding account and participant accounts. - [Create an Order](https://docs.polymarket.us/partners/orders/create-order.md): Place an order with a declared vendor fee — recorded against the order and passed through to the exchange in one idempotent call. - [Order Data Model](https://docs.polymarket.us/partners/orders/data-model.md): Supported fields for the public InsertOrderRequest embedded in partner order entry. - [Reconciliation](https://docs.polymarket.us/partners/reconciliation.md): How to keep a correct local mirror of orders, positions, and cash — and the read APIs that anchor it. - [Changelog](https://docs.polymarket.us/changelog.md): Updates and Announcements for all APIs, tagged and filterable ## OpenAPI Specs - [trading-schema](https://docs.polymarket.us/institutional/oapi-schemas/trading-schema.json) - [rfqs-schema](https://docs.polymarket.us/institutional/oapi-schemas/rfqs-schema.json) - [report-schema](https://docs.polymarket.us/institutional/oapi-schemas/report-schema.json) - [refdata-schema](https://docs.polymarket.us/institutional/oapi-schemas/refdata-schema.json) - [combos-schema](https://docs.polymarket.us/institutional/oapi-schemas/combos-schema.json) - [incentives-schema](https://docs.polymarket.us/api-reference/oapi-schemas/incentives-schema.json) - [markets-schema](https://docs.polymarket.us/api-reference/oapi-schemas/markets-schema.json) - [tags-schema](https://docs.polymarket.us/api-reference/oapi-schemas/tags-schema.json) - [sports-schema](https://docs.polymarket.us/api-reference/oapi-schemas/sports-schema.json) - [sports-legacy-schema](https://docs.polymarket.us/api-reference/oapi-schemas/sports-legacy-schema.json) - [search-schema](https://docs.polymarket.us/api-reference/oapi-schemas/search-schema.json) - [market-schema](https://docs.polymarket.us/api-reference/oapi-schemas/market-schema.json) - [events-schema](https://docs.polymarket.us/api-reference/oapi-schemas/events-schema.json) - [series-schema](https://docs.polymarket.us/api-reference/oapi-schemas/series-schema.json) - [portfolio-schema](https://docs.polymarket.us/api-reference/oapi-schemas/portfolio-schema.json) - [orders-schema](https://docs.polymarket.us/api-reference/oapi-schemas/orders-schema.json) - [positions-schema](https://docs.polymarket.us/institutional/oapi-schemas/positions-schema.json) - [orderbook-schema](https://docs.polymarket.us/institutional/oapi-schemas/orderbook-schema.json) - [funding-schema](https://docs.polymarket.us/institutional/oapi-schemas/funding-schema.json) - [health-schema](https://docs.polymarket.us/institutional/oapi-schemas/health-schema.json) - [accounts-schema](https://docs.polymarket.us/institutional/oapi-schemas/accounts-schema.json) ## AsyncAPI Specs - [connect-wss](https://docs.polymarket.us/developers-old/open-api/connect-wss.json)