> ## Documentation Index
> Fetch the complete documentation index at: https://docs-polymarket-us.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://polymarket.us/developer)
* 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