Skip to main content
The Polymarket US Retail API provides programmatic access for automated trading. This MVP release includes everything needed for bot trading while keeping the attack surface minimal.

API Overview

The Retail API includes 14 REST endpoints + 1 WebSocket endpoint:
CategoryEndpointsPurpose
API Keys3Generate, list, revoke keys
Trading5Place, cancel, query orders
Portfolio2Positions and balances
Instruments3Market discovery
WebSocket1Real-time prices

What You Can Do Now

  • Generate API keys from web portal
  • List available instruments
  • Subscribe to real-time prices (up to 10 instruments)
  • Place limit and market orders
  • Cancel orders (single or all)
  • Check open orders
  • View positions and balances

What You Will Be Able to Do Soon

  • Deposit or withdraw funds (use web)
  • Modify existing orders (cancel + re-place instead)
  • View P&L calculations (calculate client-side)
  • Access historical price data (use external sources)
  • Subscribe to more than 10 instruments
  • Open multiple WebSocket connections
Need Higher Limits? Contact support after demonstrating legitimate use to request increased rate limits or connection quotas.

Other API Options

Looking for more advanced trading capabilities? Trading Gateway - Direct market access for institutional traders
  • Visit docs.polymarketexchange.com
  • Username/password authentication
  • gRPC streaming for high-performance trading
  • REST API for order entry
Exchange Gateway - Comprehensive API with payments, KYC, and more