# Polymarket US Documentation

- [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
- [Combos FAQs](https://docs.polymarket.us/faqs/combos-faqs.md): Frequently asked questions about how combos work and how they settle 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
- [Crypto FAQs](https://docs.polymarket.us/faqs/crypto-faqs.md): Frequently asked questions about trading Cryptocurrency 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 a debit card, bank transfer (ACH), Apple Pay, PayPal, Venmo, USDC, 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 a debit card, bank transfer (ACH), Apple Pay, PayPal, Venmo, USDC, 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
- [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
- [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 market and 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 how fractional contracts work on Polymarket US
- [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): Manage RFQs and quotes and query RFQ trades
- [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 using the authenticated Retail account.
- [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 using the authenticated Retail account. Every successful call returns a new quoteId, including replacements. See [quote replacement](/api-reference/rfqs/overview#replace-a-quote).
- [Get RFQ trades](https://docs.polymarket.us/api-reference/rfqs/get-rfq-trades.md): Returns anonymous original fills where either order originated from an RFQ, newest first. Includes single instruments, combos, and later fills on resting orders. Repeat the same filters and limit with each cursor; an empty cursor ends the traversal. History is eventually visible. Requery overlapping…
- [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 Price History](https://docs.polymarket.us/api-reference/price-history/get-price-history.md): Returns book-derived Yes and No display prices for one market. Use the market slug as `symbol`.
- [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
- [Asset Prices API Overview](https://docs.polymarket.us/api-reference/asset-prices/overview.md): Reference index price history for crypto price markets
- [Get A Bucketed OHLC Price Series For One Or More Assets](https://docs.polymarket.us/api-reference/asset-prices/get-a-bucketed-ohlc-price-series-for-one-or-more-assets.md): Returns a dense, ascending OHLC candle series per requested asset between from and to, one candle per bucket. Buckets with no ticks are gap-filled: close is carried forward, open/high/low equal that close, and tick_count is 0. The server clamps rather than rejects: a to of 0 or in the future becomes…
- [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, plus direct player lookup
- [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 Players](https://docs.polymarket.us/api-reference/sports/get-sports-players.md): Fetch sports players, filterable by abbreviation, name, id, team, or provider reference
- [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): Returns incentive programs grouped by market, with time periods.
- [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
- [Crypto Schema](https://docs.polymarket.us/trader-guide/crypto-schema.md): Instrument fields for safely identifying crypto price markets
- [Combos/RFQ](https://docs.polymarket.us/trader-guide/combos.md): Quote RFQs, including combo RFQs, 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
- [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
- [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
- [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
- [Combos API Overview](https://docs.polymarket.us/institutional/combos/overview.md): Create and read combo instruments
- [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/institutional/rfqs/overview.md): Create and manage RFQs and quotes
- [Get RFQs](https://docs.polymarket.us/institutional/rfqs/get-rfqs.md): Returns RFQs matching the query filters.
- [Create RFQ](https://docs.polymarket.us/institutional/rfqs/create-rfq.md): Creates a combo RFQ.
- [Get quotes](https://docs.polymarket.us/institutional/rfqs/get-quotes.md): Returns quotes matching the query filters.
- [Create quote](https://docs.polymarket.us/institutional/rfqs/create-quote.md): Creates a quote for an RFQ. Every successful call returns a new quoteId, including replacements. See [quote replacement](/institutional/rfqs/overview#create-or-replace-a-quote).
- [Get RFQ trades](https://docs.polymarket.us/institutional/rfqs/get-rfq-trades.md): Query trades originating from RFQs.
- [Get RFQ user ID](https://docs.polymarket.us/institutional/rfqs/get-rfq-user-id.md): Returns the public RFQ user ID for the authenticated participant.
- [Delete RFQ](https://docs.polymarket.us/institutional/rfqs/delete-rfq.md): Closes an open RFQ.
- [Delete quote](https://docs.polymarket.us/institutional/rfqs/delete-quote.md): Deletes a quote so it can no longer be accepted.
- [Accept quote](https://docs.polymarket.us/institutional/rfqs/accept-quote.md): Accepts one side of a quote.
- [Confirm quote](https://docs.polymarket.us/institutional/rfqs/confirm-quote.md): Confirms an accepted quote during last look.
- [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
- [Settlement API Overview](https://docs.polymarket.us/institutional/settlement/overview.md): Read an instrument’s final settlement price
- [Get instrument settlement](https://docs.polymarket.us/api-reference/settlement/get-instrument-settlement.md): Read the final settlement price for an exact instrument symbol, including terminated instruments. Requires a bearer token with read:marketdata scope; no x-participant-id header is needed. Returns 200 with stats absent when the newest record is not a final EVENT_TIER_1 settlement, and 404 for an unkn…
- [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): Query the authenticated identity, tradable accounts, and users you may act on behalf of
- [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 Programs](https://docs.polymarket.us/api-reference/incentives/get-incentive-programs.md): Returns incentive programs grouped by market, with time periods.
- [Get Incentive Earnings](https://docs.polymarket.us/api-reference/incentives/get-incentive-earnings.md): Returns incentive earnings for the participant identified by request metadata.
- [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
- [Streaming Best Practices](https://docs.polymarket.us/streaming-endpoints/streaming-best-practices.md): Keep gRPC streams long-lived. One Drop Copy per firm. Persist resume_token after you apply. Do not cancel mid-replay.
- [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 RFQ, quote, and trade 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): 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, Sequential, and Deposit and 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.
- [Fee Schedule](https://docs.polymarket.us/fees.md): Trading fee schedule, rebates, and examples
- [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 players, 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
- [End-User Legal Agreements](https://docs.polymarket.us/partners/onboarding/legal-agreements.md): The five documents in the Polymarket US legal set, the exact acceptance language and flow, and how agreement versioning works.
- [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.
- [Combos for Takers](https://docs.polymarket.us/partners/orders/combos-takers.md): Decode, size, reconcile, and settle combo trades as an RFQ requester
- [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.
- [Streaming Best Practices](https://docs.polymarket.us/streaming-endpoints/streaming-best-practices.md): Keep gRPC streams long-lived. One Drop Copy per firm. Persist resume_token after you apply. Do not cancel mid-replay.
- [Changelog](https://docs.polymarket.us/changelog.md): Updates and Announcements for all APIs, tagged and filterable
- [Legal Notices](https://docs.polymarket.us/legal-notices.md): Exchange and Clearing notices.

## OpenAPI Specs

- [asset-prices-schema](/api-reference/oapi-schemas/asset-prices-schema.json)
- [combos-schema](/api-reference/oapi-schemas/combos-schema.json)
- [events-schema](/api-reference/oapi-schemas/events-schema.json)
- [incentives-schema](/api-reference/oapi-schemas/incentives-schema.json)
- [market-schema](/api-reference/oapi-schemas/market-schema.json)
- [markets-schema](/api-reference/oapi-schemas/markets-schema.json)
- [orders-schema](/api-reference/oapi-schemas/orders-schema.json)
- [portfolio-schema](/api-reference/oapi-schemas/portfolio-schema.json)
- [price-history-schema](/api-reference/oapi-schemas/price-history-schema.json)
- [rfqs-schema](/api-reference/oapi-schemas/rfqs-schema.json)
- [search-schema](/api-reference/oapi-schemas/search-schema.json)
- [series-schema](/api-reference/oapi-schemas/series-schema.json)
- [sports-legacy-schema](/api-reference/oapi-schemas/sports-legacy-schema.json)
- [sports-schema](/api-reference/oapi-schemas/sports-schema.json)
- [tags-schema](/api-reference/oapi-schemas/tags-schema.json)
- [accounts-schema](/institutional/oapi-schemas/accounts-schema.json)
- [combos-schema](/institutional/oapi-schemas/combos-schema.json)
- [funding-schema](/institutional/oapi-schemas/funding-schema.json)
- [health-schema](/institutional/oapi-schemas/health-schema.json)
- [incentives-schema](/institutional/oapi-schemas/incentives-schema.json)
- [orderbook-schema](/institutional/oapi-schemas/orderbook-schema.json)
- [positions-schema](/institutional/oapi-schemas/positions-schema.json)
- [refdata-schema](/institutional/oapi-schemas/refdata-schema.json)
- [report-schema](/institutional/oapi-schemas/report-schema.json)
- [rfqs-schema](/institutional/oapi-schemas/rfqs-schema.json)
- [settlement-schema](/institutional/oapi-schemas/settlement-schema.json)
- [trading-schema](/institutional/oapi-schemas/trading-schema.json)
- [override-banner](/scripts/sync/tests/fixtures/override-banner.json)
- [override-edited](/scripts/sync/tests/fixtures/override-edited.json)
- [override-schema](/scripts/sync/tests/fixtures/override-schema.json)
- [override-structural](/scripts/sync/tests/fixtures/override-structural.json)
- [scan-clean](/scripts/sync/tests/fixtures/scan-clean.json)
- [scan-dirty](/scripts/sync/tests/fixtures/scan-dirty.json)
- [treeshake-input](/scripts/sync/tests/fixtures/treeshake-input.json)

## AsyncAPI Specs

- [connect-wss](/developers-old/open-api/connect-wss.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.