Polymarket Scraper & API – Odds, Volume, Price History

Get Polymarket prediction market data as a clean, flat dataset: live YES/NO odds (implied probabilities), all outcomes, total and 24h volume, liquidity, best bid/ask, 24h price change, close date, resolution rules and links. You can add a price history time series per market, and use monitor mode to output only new markets or big odds moves.

• Official public APIs only. The Actor uses Polymarket's Gamma API and the CLOB /prices-history endpoint. There is no login, no API key, no browser and no HTML scraping.
• Search any way you like. Find markets by keyword, tag, event or market URL, slug or ID, sorted by 24h volume, total volume, liquidity, closing date or newest.
• $2 per 1,000 markets. Price history costs $0.003 per market, and a run costs $0.0001 to start. Monitor mode outputs only new markets and markets whose odds moved.

Quick start

This is the prefilled input: the top 4 open markets by 24h volume, in seconds, for about $0.008. Raise maxMarkets (up to 5,000) for more.

{ "maxMarkets": 4 }

Sample output (illustrative values)

question	yes_price	volume_usd	volume_24h_usd	close_time
Will the Fed cut rates by 25 bps in December 2026?	0.62	9,000,000	300,000	2026-12-31
Will the Fed hold rates in December 2026?	0.30	6,000,000	200,000	2026-12-31

Price comparison (Apify Store, September 2026)

Actor	Price per 1,000 markets	Monthly users
Polymarket Scraper & API (this Actor)	$2	new
scrapemint/polymarket-market-monitor	$12	32

Related Actors: Google News Scraper for the news behind the odds, and SEC EDGAR MCP Server & API for company fundamentals.

What can this Polymarket scraper do?

• Top markets in one click. The prefilled input returns the 4 open markets with the highest 24h volume. With no input at all, the Actor returns the top 20.
• Keyword and tag search. For example fed rate, bitcoin, election or recession, with tags such as politics, crypto, economy or sports.
• Status and sorting. Choose open, closed/resolved, or all markets. Sort by 24h volume, total volume, liquidity, closing soonest or newest.
• Market details by URL or ID. Accepts Polymarket event URLs (all markets of the event), market URLs, slugs, numeric IDs and condition IDs.
• Price history. Optional YES-price time series for the last day, week or month, or the full history (daily points).
• Monitor mode. Schedule the Actor, for example hourly. Each run outputs only markets that are new or whose YES probability moved by at least X points since the last run. State is kept in a named key-value store.

Use cases

• Trading research. Find the most active and liquid markets, spreads and 24h moves, and export them to Sheets or BI tools.
• News and media. Show "what the markets say" about elections, Fed decisions, crypto and sports, with links.
• Alerts. Run monitor mode hourly and connect Apify integrations (Slack, email, webhooks, Make, Zapier) to hear when odds move 5+ points.
• Data science and backtesting. Use price history for calibration studies, forecasting benchmarks and dashboards.
• AI agents. Give an LLM grounded, current probabilities for real-world events.

Input example

{
  "search": "fed",
  "status": "open",
  "sortBy": "volume24h",
  "maxMarkets": 20,
  "includePriceHistory": true,
  "historyRange": "1w"
}

Specific markets:

{ "marketIds": ["https://polymarket.com/event/fed-decision-in-december", "will-bitcoin-reach-150000-by-december-31-2026"] }

Monitor mode (schedule it):

{ "search": "election", "monitorMode": true, "priceMoveThresholdPct": 5, "monitorStoreName": "election-odds" }

Output example

{
  "platform": "polymarket",
  "market_id": "500011",
  "event_id": "901",
  "event_title": "Fed decision in December?",
  "question": "Will the Fed cut rates by 25 bps in December 2026?",
  "category": "Economy",
  "outcomes": [
    { "name": "Yes", "price": 0.62, "probability": 0.62 },
    { "name": "No", "price": 0.38, "probability": 0.38 }
  ],
  "yes_price": 0.62, "no_price": 0.38, "best_bid": 0.61, "best_ask": 0.63, "last_price": 0.62,
  "price_change_24h": 0.015,
  "volume_usd": 9000000, "volume_24h_usd": 300000, "liquidity_usd": 12345.6,
  "status": "open", "open_time": "2026-01-01T00:00:00Z", "close_time": "2026-12-31T00:00:00Z",
  "url": "https://polymarket.com/event/fed-decision-december/market-11",
  "platform_ids": { "slug": "market-11", "event_slug": "fed-decision-december", "condition_id": "0x…", "clob_token_ids": ["…", "…"] },
  "rules": "This market will resolve to \"Yes\" if …",
  "price_history": [{ "t": "2026-09-27T00:00:00Z", "ts": 1790467200, "p": 0.51 }],
  "price_history_points": 168
}

Field notes:

• Prices and probabilities range from 0 to 1, as displayed by Polymarket. Volume and liquidity are in USD (USDC).
• Multi-outcome markets (for example team A vs team B) list every outcome in outcomes. For these, yes_price and no_price are the first and second outcome.
• Monitor runs add monitor_change (new / price_move), previous_yes_price and yes_change_pp.
• A run summary (counts, errors, request count) is saved to the OUTPUT record of the key-value store.

Pricing

Pay per event. You pay only for results:

Event	Price
Run start	$0.0001
Market saved	$0.002 ($2 per 1,000 markets)
Price history fetched (per market, only if data was returned)	$0.003

Examples: the prefilled run (top 4 markets) costs about $0.008, and the top 20 markets cost about $0.04. 100 markets with a week of price history cost $0.50. Set a maximum cost per run in Apify. The Actor checks your remaining budget before each market, skips history it can't afford, and stops cleanly.

Why this Actor

Prediction-market Actors on the Store have about 230 monthly users combined, and at least one popular Actor shows a run success rate of around 15%. This one is built for reliability:

• official JSON APIs only, with no HTML scraping that breaks
• retries with backoff
• a time budget, so searches always return the best results found so far
• per-input errors recorded instead of crashing
• a flat, documented schema

Use with AI agents (Apify MCP)

Add this Actor to the Apify MCP server (https://mcp.apify.com) in Claude, ChatGPT, Cursor or any MCP client. An agent can then ask "What are the current Polymarket odds that the Fed cuts in December?" and get compact, structured JSON. The inputs are plain strings, numbers and booleans, so they're easy for LLMs to fill in.

from apify_client import ApifyClient
run = ApifyClient("<TOKEN>").actor("gazidev/polymarket-data").call(run_input={"search": "bitcoin", "maxMarkets": 10})

Data source, terms and attribution

• Endpoints: gamma-api.polymarket.com (/markets, /events, /public-search) and clob.polymarket.com/prices-history. These are public, read-only and need no authentication, as documented at docs.polymarket.com. The Actor never places orders and never touches user or wallet endpoints.
• Rate limits: Polymarket enforces per-IP limits through Cloudflare. Gamma allows roughly 300 /markets and 500 /events requests per 10 seconds. A typical run makes 1–30 requests.
• Terms: Polymarket's Terms of Use (polymarket.com/tos) apply to your use of the data. Polymarket's API docs don't set a specific attribution or redistribution rule for public market data. When you publish odds, please credit "Source: Polymarket". Polymarket trading isn't available in some jurisdictions. This Actor only reads public market data.
• Data is provided as-is and may be delayed. This is informational data, not trading or investment advice.

FAQ

Do I need a Polymarket account or API key? No. Only public market-data endpoints are used.

Why does a keyword search return fewer markets than I asked for? Polymarket has no full-text market filter, so the Actor combines Polymarket's public search with a scan of events sorted by your chosen field, within discoveryTimeoutSecs / maxEventsToScan. Raise those for exhaustive scans, or use a broader keyword.

Monitor mode: what counts as a price move? The absolute change in YES probability since the previous run, in percentage points (40% → 45% is 5 points). The first run outputs everything as new unless you turn off monitorEmitOnFirstRun.

Some inputs failed. Was I charged? No. Unknown IDs and API errors are listed in the OUTPUT summary and aren't charged. Price history is charged only when points were returned.

Is it affiliated with Polymarket? No. This is an independent tool that uses Polymarket's public API.