Polymarket Market Scraper

Get normalized Polymarket prediction-market data from its public APIs — questions, outcomes with live prices, 24h volume, liquidity, end dates, tags, and optional CLOB orderbook depth. No login, no proxies — pure official APIs (gamma-api + clob), fast and reliable.

Built for AI agents and MCP clients: flat JSON output, one record per market, ready for datasets, databases, or agent tools.

Features

• 📈 Active markets ranked by 24h volume (default: top 50)
• 🏷️ Optional tag filter (crypto, politics, sports, nba, ...)
• 💰 Normalized outcomes with live prices: [{ "name": "Yes", "price": 0.125 }, ...]
• 📊 Volume & liquidity: volume24hr, volumeNum, liquidityNum
• 📖 Optional orderbook depth (best bid/ask + total depth) for the top N markets via the CLOB API
• 🆔 conditionId + clobTokenIds included → trade-ready identifiers for bots
• ⚡ Runs in seconds, costs a fraction of a cent

Input

{
  "tagSlugs": [],
  "limit": 50,
  "minVolume24hUsd": 1000,
  "includeOrderbook": true,
  "orderbookTopN": 3
}

Field	Type	Default	Description
tagSlugs	string[]	[] (all)	Filter by Polymarket tag slug
limit	int	50	Max markets per tag, ranked by 24h volume
minVolume24hUsd	int	0	Skip markets below this 24h volume
includeOrderbook	bool	false	Fetch CLOB orderbook for top markets
orderbookTopN	int	3	How many top markets get orderbooks

Output

One dataset record per market:

{
  "question": "Will Indiana enact a data center moratorium by December 31, 2026?",
  "slug": "will-indiana-enact-a-data-center-moratorium",
  "conditionId": "0x...",
  "clobTokenIds": "[\"123...\", \"456...\"]",
  "endDate": "2026-12-31T00:00:00Z",
  "volume24hr": 126505.5,
  "volumeNum": 4500000,
  "liquidityNum": 139830.1,
  "outcomes": [
    { "name": "Yes", "price": 0.125 },
    { "name": "No", "price": 0.875 }
  ],
  "tags": ["politics"],
  "url": "https://polymarket.com/market/...",
  "orderbook": {
    "bestBid": "0.12",
    "bestAsk": "0.13",
    "bidDepth": 2128891.32,
    "askDepth": 1607415.02
  }
}

(orderbook present only for the top N when includeOrderbook is on.)

Use cases

• AI agent prediction-market tool (MCP): live odds for any agent decision pipeline
• Odds monitoring/alerting: poll prices, notify on moves above a threshold
• Cross-market analytics: volume/liquidity trends across tags
• Trading bots: clobTokenIds + orderbook depth → straight into execution logic
• Research datasets: prediction-market efficiency studies, calibration data

Performance & reliability

• Uses Polymarket's official public APIs (gamma-api.polymarket.com, clob.polymarket.com) — no HTML scraping, no proxies, no browser
• Typical run: a few seconds
• Polite delays between calls; no auth needed

Pricing

Pay per event — you pay a small flat fee per 1,000 market records. Free trial included, see the pricing tab.

Support

Open an issue on this Actor's Issues tab — I respond quickly (within a day, usually hours).