# Polymarket Scraper — Live Odds, Volume & Liquidity (`rbbscrap/polymarket-scraper`) Actor

Extract real-time Polymarket prediction market probabilities (Yes/No %), USD trading volume, liquidity, resolution dates, and condition IDs via Gamma API. Zero-browser 256MB RAM.

- **URL**: https://apify.com/rbbscrap/polymarket-scraper.md
- **Developed by:** [Hector](https://apify.com/rbbscrap) (community)
- **Categories:** Business, News
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.30 / 1,000 scraped polymarket markets

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

<p align="center">
  <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/GjS6nQ8qauOdq9KGy-actor-QeX2hDc9rgHMS3Fu0-fYJn0G5VWb-polymarket1671006384460.png" alt="Polymarket official logo" width="72" height="72" />
</p>

## Polymarket Scraper — Live Odds, Volume & Liquidity

> **Pay-Per-Event Pricing ($0.30 / 1,000 markets — 5x–10x cheaper than #1, 1st Run 100% Free!)** · Built for **Zero-Browser 256MB RAM** execution on Apify Cloud · Export to **JSON, CSV, Excel, Make, n8n, Zapier & MCP**.

**Related US Scrapers**: [Yahoo Finance Scraper](https://apify.com/rbbscrap/yahoo-finance-scraper) · [CoinMarketCap Scraper](https://apify.com/rbbscrap/coinmarketcap-scraper) · [Ticketmaster Scraper](https://apify.com/rbbscrap/ticketmaster-scraper) · [Twitter Scraper](https://apify.com/rbbscrap/twitter-scraper)

***

### What does Polymarket Scraper do?

Live Odds, Volume & Liquidity extractor built for speed, reliability, and ultra-low compute cost. Run a **1-Click Run** immediately using prefilled US defaults or pass your own keywords, filters, and direct URLs.

#### Beyond the Official API

Instead of writing custom Polygon subgraph queries, decoding JSON-stringified outcome arrays, and handling search endpoints manually, this actor consumes Polymarket Gamma APIs natively in milliseconds at 256MB RAM and normalizes clean Yes/No probabilities, USD volumes, liquidity, and CLOB token IDs.

***

### What data can you scrape?

| Category | Extracted Fields & Capabilities |
| :--- | :--- |
| **Contract Identifiers** | Market ID, Condition ID (`0x...`) & Event Slug |
| **Real-Time Probabilities** | Yes %, No % & Full Outcomes Probability Map |
| **Liquidity & Flows** | Total USD Volume, 24h Volume & Available Liquidity ($) |
| **Resolution Metadata** | End Date, Active/Closed Status & UMA Resolution Source |
| **On-Chain Execution IDs** | CLOB Token IDs Ready for Orderbook & Trading Bots |
| **Direct Contract Links** | Verified `polymarket.com/event/...` URL |

***

### Why scrape Polymarket? (Typical Use Cases)

- **Quant Traders & Hedge Funds**: Feed live election, Federal Reserve rate cut, CPI, and geopolitical probabilities into trading models.
- **Financial Journalists & Analysts**: Embed real-time prediction market odds in newsletters, dashboards, and live election trackers.
- **Arbitrage Bots (Polymarket vs Kalshi / Metaculus)**: Monitor spreads across top-volume contracts sorted by 24h liquidity.
- **AI Macro Forecasting Agents**: Connect Polymarket datasets directly to Claude, Cursor, or LangChain via Apify MCP.

***

### How to scrape Polymarket data (4 Simple Steps)

1. Enter a **Search Topic** (e.g. `Fed rate`, `Election`, `Bitcoin`) or leave empty for top global markets by USD volume.
2. Select **Market Status** (`active` / `closed`), **Sort Order** (`volume`, `volume24hr`, `liquidity`), and optional USD floors.
3. Click **Start** — your **1st run is 100% free** (`$0.00` billed).
4. Export clean contract probabilities, volumes, and CLOB token IDs as JSON or CSV.

***

### Input Configuration & Examples

| Parameter | Type | Description | Default |
| :--- | :--- | :--- | :--- |
| `searchQuery` | `string` | Topic or keyword to search across Polymarket events (e.g. 'Fed rate', 'Election', 'Bitcoin', 'AI'). Leave empty for top global markets by volume. | `"Fed rate"` |
| `marketUrls` | `array` | Optional direct polymarket.com/event/... URLs to fetch live odds and sub-markets. | `[]` |
| `category` | `string` | Topic tag filter (politics, crypto, finance, economics, sports, pop-culture, or all). | `"all"` |
| `status` | `string` | Filter by active live trading markets, resolved/closed markets, or all. | `"active"` |
| `sortBy` | `string` | Sort Polymarket contracts by total volume, 24h volume, liquidity, or newest. | `"volume"` |
| `minVolumeUsd` | `number` | Filter out low-volume markets below this USD threshold (0 = no minimum). | `0` |
| `minLiquidityUsd` | `number` | Filter out illiquid markets below this USD liquidity threshold. | `0` |
| `maxItems` | `integer` | Maximum number of Polymarket market records to extract (1–500). | `25` |
| `includeOutcomesBreakdown` | `boolean` | Include per-outcome probability map and Polygon CLOB token IDs. | `true` |
| `proxyConfiguration` | `object` | Optional Apify Proxy (recommended only if running from restricted EU jurisdictions). | `{"useApifyProxy":false}` |

#### Example Inputs

##### Fed Rate & Macro Markets (Default 1-Click)

```json
{
  "searchQuery": "Fed rate",
  "status": "active",
  "sortBy": "volume",
  "maxItems": 25,
  "includeOutcomesBreakdown": true
}
```

##### High-Liquidity Markets Above $100K Volume

```json
{
  "searchQuery": "",
  "status": "active",
  "sortBy": "liquidity",
  "minVolumeUsd": 100000,
  "maxItems": 50
}
```

***

### Output Example (Table View, JSON & Output Fields Reference)

```json
{
  "marketId": "517310",
  "conditionId": "0x4b9d12a8e9c1b30f2c0091847a1f3d",
  "eventTitle": "Fed decision in December?",
  "question": "Fed decreases interest rates by 25 bps after December 2026 meeting?",
  "category": "economics",
  "yesProbabilityPercent": 68.5,
  "noProbabilityPercent": 31.5,
  "outcomesBreakdown": {
    "Yes": 68.5,
    "No": 31.5
  },
  "clobTokenIds": [
    "21742633143463906290569050155826241533067272736897614950488156847949938836455"
  ],
  "volumeUsd": 18450320.45,
  "volume24hrUsd": 1420810.12,
  "liquidityUsd": 892410.8,
  "status": "Active",
  "endDate": "2026-12-16T20:00:00Z",
  "resolutionSource": "Federal Reserve FOMC Statement",
  "marketUrl": "https://polymarket.com/event/fed-decision-in-december",
  "scrapedAt": "2026-11-13T09:15:00.000Z"
}
```

#### Output Fields Reference

| Field | Description |
| :--- | :--- |
| `marketId / conditionId` | Polymarket contract ID and on-chain Condition ID |
| `eventTitle / question` | Parent event headline and exact binary/multi-outcome question |
| `yesProbabilityPercent / noProbabilityPercent` | Implied Yes and No probabilities (0–100%) |
| `outcomesBreakdown` | Full key-value map of every outcome label and probability |
| `volumeUsd / volume24hrUsd / liquidityUsd` | Cumulative trading volume, 24h volume, and orderbook liquidity |
| `clobTokenIds` | CLOB token IDs for downstream orderbook analysis |
| `endDate / status` | Contract resolution date and Active / Closed status |
| `marketUrl` | Direct Polymarket event URL |

***

### Related & Dedicated Scrapers

| Scraper | Niche | Why Combine It? |
| :--- | :--- | :--- |
| **[Yahoo Finance Scraper](https://apify.com/rbbscrap/yahoo-finance-scraper)** | US Market Data | Correlate prediction odds with S\&P 500, yields & macro stocks |
| **[CoinMarketCap Scraper](https://apify.com/rbbscrap/coinmarketcap-scraper)** | US Market Data | Track crypto spot prices alongside Polymarket crypto contracts |
| **[Ticketmaster Scraper](https://apify.com/rbbscrap/ticketmaster-scraper)** | US Market Data | Track US live entertainment & sports ticket markets |
| **[Twitter Scraper](https://apify.com/rbbscrap/twitter-scraper)** | US Market Data | Monitor breaking US macro & election sentiment on X |

***

### Error Items & Resilience Reference

- **Anti-Bot & Timeout Protection**: Strict request timeouts (12–15s) and global 75s safety exit guarantee zero runaway compute charges.
- **Zero-Null Guarantee**: Every normalized field defaults cleanly without `null` or `undefined` gaps breaking downstream Make/n8n/Zapier parsers.
- **No Unwanted Compute Drain**: Zero headless browser overhead — runs cleanly at `256 MB` RAM.

***

### Frequently Asked Questions (FAQ)

#### 1. How much does it cost, and is the first run really free?

This scraper uses **Pay-Per-Event** pricing at **$0.0003 per record** (**$0.30 / 1,000 markets**), roughly **5x–10x cheaper** than leading competitors. Your **very first run is 100% free** (`$0.00` event charges waived automatically via our developer trial registry).

#### 2. Can I connect this scraper to Make, n8n, or Zapier?

Yes. Every dataset item is flat, strongly typed JSON ready for **Make (Integromat)**, **n8n**, **Zapier**, Google Sheets, Airtable, and webhooks.

#### 3. How do I call this actor via Python or Node.js API?

Use `apify-client` in Python or Node.js by passing your `APIFY_TOKEN` and actor slug `rbbscrap/polymarket-scraper`, then read `client.dataset(run["defaultDatasetId"]).iterate_items()`.

#### 4. Does it work with Claude Desktop, Cursor, or AI Agents (MCP)?

Yes. Connect the official **Apify MCP Server** and invoke `rbbscrap/polymarket-scraper` directly as a tool inside Claude, Cursor, or Windsurf.

#### 5. Do I need residential proxies or cookies?

No cookies are required. Default runs work immediately without paid proxies; an optional `proxyConfiguration` input is available for localized or high-volume direct URL runs.

#### 6. Is scraping public data legal (GDPR / US compliance)?

This actor only reads publicly accessible web pages and public APIs without bypassing login gates or paywalls, and does not harvest private personal data under **EU Regulation 2016/679 (GDPR)**. Ensure your downstream usage complies with applicable local laws and target site terms.

#### 7. Where can I report an issue or request a new field?

Open an issue directly on our Apify Actor page: [Report an Issue / Request Feature](https://apify.com/rbbscrap/polymarket-scraper/issues/open).

# Actor input Schema

## `searchQuery` (type: `string`):

Topic or keyword to search across Polymarket events (e.g. 'Fed rate', 'Election', 'Bitcoin', 'AI'). Leave empty for top global markets by volume.

## `marketUrls` (type: `array`):

Optional direct polymarket.com/event/... URLs to fetch live odds and sub-markets.

## `category` (type: `string`):

Topic tag filter (politics, crypto, finance, economics, sports, pop-culture, or all).

## `status` (type: `string`):

Filter by active live trading markets, resolved/closed markets, or all.

## `sortBy` (type: `string`):

Sort Polymarket contracts by total volume, 24h volume, liquidity, or newest.

## `minVolumeUsd` (type: `number`):

Filter out low-volume markets below this USD threshold (0 = no minimum).

## `minLiquidityUsd` (type: `number`):

Filter out illiquid markets below this USD liquidity threshold.

## `maxItems` (type: `integer`):

Maximum number of Polymarket market records to extract (1–500).

## `includeOutcomesBreakdown` (type: `boolean`):

Include per-outcome probability map and Polygon CLOB token IDs.

## `proxyConfiguration` (type: `object`):

Optional Apify Proxy (recommended only if running from restricted EU jurisdictions).

## Actor input object example

```json
{
  "searchQuery": "Fed rate",
  "marketUrls": [],
  "category": "all",
  "status": "active",
  "sortBy": "volume",
  "minVolumeUsd": 0,
  "minLiquidityUsd": 0,
  "maxItems": 25,
  "includeOutcomesBreakdown": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "Fed rate",
    "marketUrls": [],
    "category": "all",
    "status": "active",
    "sortBy": "volume",
    "minVolumeUsd": 0,
    "minLiquidityUsd": 0,
    "maxItems": 25,
    "includeOutcomesBreakdown": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("rbbscrap/polymarket-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQuery": "Fed rate",
    "marketUrls": [],
    "category": "all",
    "status": "active",
    "sortBy": "volume",
    "minVolumeUsd": 0,
    "minLiquidityUsd": 0,
    "maxItems": 25,
    "includeOutcomesBreakdown": True,
}

# Run the Actor and wait for it to finish
run = client.actor("rbbscrap/polymarket-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQuery": "Fed rate",
  "marketUrls": [],
  "category": "all",
  "status": "active",
  "sortBy": "volume",
  "minVolumeUsd": 0,
  "minLiquidityUsd": 0,
  "maxItems": 25,
  "includeOutcomesBreakdown": true
}' |
apify call rbbscrap/polymarket-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rbbscrap/polymarket-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/6at8K8cG4cpM0m0nE/builds/iaxVRZEDs17QF1NMU/openapi.json
