Forecasting applications, quantitative research, and real-time trading strategies increasingly rely on prediction market intelligence. PolyGram and the underlying Polymarket CLOB infrastructure provide robust APIs enabling developers to construct applications atop the world's foremost prediction market network.
Available APIs
Polymarket Gamma API (Market Data)
The Gamma REST API delivers event information, current pricing, and time-series data:
- Base URL: https://gamma-api.polymarket.com
- Endpoints: /events, /markets, /positions, /activity
- Authentication: Public market information requires no credentials
- Rate limits: Approximately 100 calls per minute without authentication
Polymarket CLOB API (Order Book & Trading)
The CLOB API grants access to live order book snapshots and enables order placement:
- Base URL: https://clob.polymarket.com
- Endpoints: /book, /trades, /orders, /prices/history
- WebSocket: wss://ws-subscriptions-clob.polymarket.com for streaming data
- Authentication: ECDSA-signed requests mandatory for placing orders
PolyGram API
PolyGram offers its proprietary API for authenticated trading workflows:
- Consult comprehensive documentation at PolyGram API Docs
- REST endpoints supporting order execution, account holdings, and market discovery
- API key-based authentication for automated trading workflows
Common Developer Use Cases
- Algorithmic trading: Systematic position adjustment triggered by external data sources
- Research dashboards: Tracking historical probability shifts across sports, political, or macroeconomic markets
- Market aggregators: Benchmarking odds and pricing across multiple prediction platforms
- Embedded widgets: Displaying current prediction odds directly within publisher sites or applications
- Alert systems: Triggering notifications when market movements exceed defined parameters
Getting Started: Fetch Market Data
A straightforward Python snippet to retrieve active 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?
- Market data via the Gamma API incurs no cost subject to rate restrictions. Submitting orders through the CLOB API requires a wallet with funds and ECDSA signing but carries no service charges.
- Can I paper trade with the API before risking real USDC?
- Polymarket lacks a testnet or sandbox. Explore Manifold Markets API for risk-free experimentation, then migrate to Polymarket/PolyGram CLOB when ready for production.
- Are there Python or JavaScript SDKs available?
- Community contributors have published third-party Python and JavaScript libraries for Polymarket integration. Check GitHub repositories including "polymarket-py" and "polymarket-js" for current maintained versions.