Using the Polymarket Data API: Real-Time Prediction Market Data for Developers | Mundial 2026 Grupos

In this guide

Available Data Endpoints
Python Quickstart
Use Cases
FAQ

Developers, researchers, and analysts increasingly rely on prediction market information for building sophisticated tools and conducting rigorous studies. PolyGram provides access to the Polymarket platform, which operates the globe's most comprehensive prediction market infrastructure and corresponding developer APIs.

Available Data Endpoints

Gamma API (Market Data)

GET https://gamma-api.polymarket.com/events
  ?limit=100&active=true&order=volume24hr
  Returns: event metadata, current prices, volume, tags

GET https://gamma-api.polymarket.com/events/{slug}
  Returns: full event with all markets, prices, descriptions

GET https://gamma-api.polymarket.com/markets/{conditionId}
  Returns: single market details, current order book price

CLOB API (Order Book)

GET https://clob.polymarket.com/book
  ?token_id={tokenId}
  Returns: full order book depth (bids/asks)

GET https://clob.polymarket.com/prices/history
  ?market={conditionId}&resolution=1h&startTs=1700000000
  Returns: hourly price history

WebSocket: wss://ws-subscriptions-clob.polymarket.com
  Subscribe to real-time price updates

Python Quickstart

import requests

# Get top prediction markets by volume
r = requests.get(
    "https://gamma-api.polymarket.com/events",
    params={"limit": 10, "active": "true", "order": "volume24hr"}
)
for event in r.json():
    market = event["markets"][0] if event.get("markets") else {}
    prices = market.get("outcomePrices", "[0.5,0.5]")
    import json; p = json.loads(prices)
    print(f"{event['title'][:50]}: YES={float(p[0]):.2%}")

Use Cases

Research dashboards: Monitor how prediction market odds shift across particular outcomes and timeframes
News tools: Identify and highlight markets experiencing significant movement following newsworthy developments
Aggregators: Establish comparative analysis between Polymarket, Kalshi, and Metaculus probability estimates
Alert systems: Trigger notifications whenever market sentiment crosses predetermined boundaries
Academic research: Leverage resolved market data to evaluate forecast quality and prediction accuracy metrics

FAQ

Is the Polymarket API free to use?: Absolutely — accessing market data through the Gamma API carries no cost, subject to standard rate restrictions (approximately 100 requests per minute without authentication). Submitting orders on the CLOB requires account funding, though querying order book information remains complimentary.
Is there a Python library for Polymarket?: Multiple community-developed Python packages are available through GitHub repositories. Look for "polymarket-py" to discover the most actively maintained implementations.