Introduction

Overview of the Polymarket US Retail API

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

API Overview

The Retail API includes 11 REST endpoints + 2 WebSocket endpoints:

Category	Endpoints	Purpose
Markets	4	Query market data and settlement
Trading	5	Place, cancel, query orders
Portfolio	2	Positions and balances
WebSocket	2	Real-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