Skip to main content

Documentation Index

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

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

The Polymarket US API is split into two parts: an authenticated API for trading and a public API for reading market data. For support, contact support@polymarket.us.

​
Authenticated API

https://api.polymarket.us
Use the authenticated API to trade. This is where you place orders, check your positions, and manage your account. Every request requires an API key - see Authentication to get set up.
GroupWhat you get
OrdersPlace, modify, cancel, and query orders
PortfolioView positions and trading activity
AccountCheck balances and buying power
The authenticated API also provides two WebSocket endpoints for real-time streaming:
EndpointPurpose
wss://api.polymarket.us/v1/ws/privateReal-time order, position, and balance updates
wss://api.polymarket.us/v1/ws/marketsReal-time order book and trade streaming

​
Public API

https://gateway.polymarket.us
Use the public API to browse what’s available on Polymarket US. No API key needed. This is where you fetch markets, events, series, sports data, and search results. If you’re building something that displays market information - prices, odds, order books - this is all you need.
GroupWhat you get
MarketsList markets, get order books, BBO, settlement prices
EventsList events, get event details
SeriesList series (e.g., NFL 2025-26 Season)
SportsLeagues, teams, game schedules
SearchFull-text search across events and markets