Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs-polymarket-us.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

The Polymarket US Retail API provides programmatic access for automated trading.

API Overview

The Retail API includes 11 REST endpoints + 2 WebSocket endpoints:
CategoryEndpointsPurpose
Markets4Query market data and settlement
Trading5Place, cancel, query orders
Portfolio2Positions and balances
WebSocket2Real-time streaming (private + markets)

Capabilities

  • Query markets with filtering, pagination, and sorting
  • Generate API keys from the web portal
  • Subscribe to real-time market data (up to 10 instruments) via /v1/ws/markets
  • Subscribe to real-time order, position, and balance updates via /v1/ws/private
  • Place limit and market orders
  • Cancel orders (single or all)
  • Check open orders
  • View positions and balances