📈 Polymarket Prediction Market Odds & Volume Scraper

Extract live probability odds, event outcomes, 24-hour trading volume, and liquidity from the world's largest decentralized prediction market platform, Polymarket.

---

🥊 Why This Actor Beats the Competition

Feature	📈 Polymarket Odds Scraper	Heavy Web Crawlers	Webhook Bots
Speed	Under 1.5 seconds (Instant API extraction)	15–30s with DOM load	Slow & complex server maintenance
Pricing	Pay-Per-Result ($1.50 / 1k markets)	Expensive compute runtime	$49+/mo server hosting fees
Calculated Probabilities	Auto-computes clean % and dollar values	Raw decimal strings only	Requires manual math parsing
Complete Metrics	24h volume, lifetime volume, liquidity, resolution dates	Often misses liquidity depth	Inconsistent payload structures
No Crypto Wallet Needed	100% public read-only access	Fragile wallet prompts	Requires Web3 private keys

---

🛠️ Step-by-Step: How to Use

Method 1: Apify Console (No-Code GUI)

1. Choose a Topic (e.g. all, politics, crypto, business, science) or enter a search keyword.
2. Select your limit (default 25).
3. Click Start to run and download structured CSV or JSON.

Method 2: Python SDK

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run_input = {
    "topic": "crypto",
    "limit": 10,
    "activeOnly": True
}

run = client.actor("litezero/polymarket-prediction-odds-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['title']} -> 24h Vol: ${item['volume24hr']:,.2f}")
    for o in item['outcomes']:
        print(f"  - {o['outcome']}: {o['probabilityPercent']}% (${o['priceUsd']})")

Method 3: Node.js SDK

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('litezero/polymarket-prediction-odds-scraper').call({
    topic: 'all',
    searchQuery: 'Fed rate cut',
    limit: 5,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Method 4: cURL / REST API

curl --request POST \
  --url "https://api.apify.com/v2/acts/litezero~polymarket-prediction-odds-scraper/runs?token=YOUR_APIFY_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"topic": "politics", "limit": 10}'

---

📥 Input Parameters

Parameter	Type	Default	Description
topic	String	"all"	Market category (e.g. politics, crypto, business, science, or all).
searchQuery	String	""	Optional keyword search (e.g. bitcoin, election, solana).
activeOnly	Boolean	true	Filter for open/active prediction events.
limit	Integer	25	Maximum number of markets to fetch.

---

📤 Sample Output JSON

{
  "eventId": "14285",
  "title": "Fed decreases interest rates by 50 bps in November?",
  "slug": "fed-decreases-rates-50-bps-nov",
  "marketUrl": "https://polymarket.com/event/fed-decreases-rates-50-bps-nov",
  "category": "Economy",
  "volume24hr": 482910.50,
  "totalVolumeUsd": 3810420.00,
  "liquidityUsd": 745120.00,
  "outcomes": [
    {
      "outcome": "Yes",
      "priceUsd": 0.645,
      "probabilityPercent": 64.5
    },
    {
      "outcome": "No",
      "priceUsd": 0.355,
      "probabilityPercent": 35.5
    }
  ],
  "resolutionDate": "2026-11-08T00:00:00Z",
  "active": true,
  "scrapedAt": "2026-10-02T16:45:00.000Z"
}

---

💡 Top Commercial Use Cases

1. Macro Financial Hedge Funds: Track real-time market-implied probabilities for inflation, central bank rate decisions, and geopolitical events.
2. Crypto Sentiment Arbitrage: Monitor crowd odds against actual derivative pricing across decentralized exchanges.
3. Newsrooms & Media Outlets: Embed dynamic live probability trackers into breaking news stories.