Real-time prediction market data has become essential for algorithmic trading, quantitative research, and dynamic forecasting systems. PolyGram and the underlying Polymarket CLOB infrastructure offer robust APIs enabling developers to integrate with the world's most active prediction market platform.
Available APIs
Polymarket Gamma API (Market Data)
The Gamma REST API delivers event information, live pricing, and time-series analytics:
- Base URL: https://gamma-api.polymarket.com
- Endpoints: /events, /markets, /positions, /activity
- Authentication: None required for public market data
- Rate limits: ~100 requests/minute for unauthenticated access
Polymarket CLOB API (Order Book & Trading)
The CLOB API grants access to live order book snapshots and order placement capabilities:
- Base URL: https://clob.polymarket.com
- Endpoints: /book, /trades, /orders, /prices/history
- WebSocket: wss://ws-subscriptions-clob.polymarket.com for real-time updates
- Authentication: ECDSA-signed requests required for order submission
PolyGram API
PolyGram provides its own dedicated API for authenticated trading workflows:
- See full documentation at PolyGram API Docs
- REST endpoints for trade placement, portfolio data, and market browse
- API key authentication for programmatic trading
Common Developer Use Cases
- Algorithmic trading: Automated position management based on external signals
- Research dashboards: Historical probability tracking for election or economic forecasts
- Market aggregators: Comparing prediction market prices across platforms
- Embedded widgets: Show live prediction market odds on news sites or blogs
- Alert systems: Notify when a market moves beyond a threshold
Getting Started: Fetch Market Data
A basic Python example to fetch live events:
import requests
response = requests.get(
"https://gamma-api.polymarket.com/events",
params={"limit": 10, "active": "true", "order": "volume24hr"}
)
events = response.json()
for event in events:
print(event["title"], event["volume"])FAQ
- Is the Polymarket API free to use?
- Yes — market data (Gamma API) is free with rate limits. Order submission (CLOB API) requires a funded wallet and ECDSA authentication but has no additional fees.
- Can I paper trade with the API before risking real USDC?
- Polymarket doesn't have a sandbox environment. Use Manifold Markets API for paper trading, then transition to Polymarket/PolyGram CLOB for live trading.
- Are there Python or JavaScript SDKs available?
- The community has developed unofficial Python and JS libraries for Polymarket. Search GitHub for "polymarket-py" and "polymarket-js" for the latest maintained options.