Skip to main content
The Polymarket US Retail API provides programmatic access for automated trading.

Generate API Keys

Visit the developer portal to generate your Ed25519 API keys. Your private key will be shown only once.

API Overview

The Retail API includes 23 REST endpoints + 2 WebSocket endpoints:
CategoryEndpointsPurpose
Markets6Query market data, sides, and settlement
Events4Event data and search
Series2Series information
Sports2Sports configuration and teams
Orders6Create, cancel, and query orders
Portfolio2Positions and activities
Account1Account 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