# Polymarket & Kalshi API - Prediction Market Odds (`sndzcc/prediction-markets-scraper`) Actor

Live odds, probabilities, 24h moves and volume of every Polymarket and Kalshi prediction market in one dataset. Search by keyword or category, or get only the biggest moves of the day.

- **URL**: https://apify.com/sndzcc/prediction-markets-scraper.md
- **Developed by:** [Sndz Data](https://apify.com/sndzcc) (community)
- **Categories:** Business, News
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 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

## Polymarket & Kalshi API: Prediction Market Odds

Get the **live odds of every prediction market on Polymarket and Kalshi in one dataset**: the probability of each outcome, how much it **moved in the last 24 hours**, volume, liquidity, end date and link. Search by keyword (`bitcoin`, `fed`, `election`, `nba`), filter by category, or catch only the **biggest moves of the day**.

Straight from both platforms' official public APIs: no login, no API key, no browser. Hundreds of markets in seconds.

### Why this one?

- **Both platforms, one format.** Compare what Polymarket and Kalshi traders think about the same event, side by side.
- **Probabilities ready to use.** Each outcome's chance in %, plus the 24h move in percentage points, bid, ask and last trade.
- **Market movers.** Set **Min 24h move** to get only the markets whose odds jumped, perfect for a daily alert.
- **Search the whole catalog.** Keywords across every open market (tens of thousands on Kalshi), sorted by 24h volume, total volume, biggest move or closing date.
- **Cheap and fast.** Pay per market, no subscription.

### Use cases

- **Traders and arbitrage hunters:** compare odds for the same event across Polymarket and Kalshi.
- **News and media:** cite what markets expect for elections, the Fed, crypto prices, sports and pop culture.
- **Research and AI:** feed real-time crowd forecasts into dashboards, models or agents.
- **Alerts:** schedule it hourly or daily and send big moves to Slack, Telegram, email or Google Sheets.

### Input

| Field | What it does |
|---|---|
| **Platforms** | Polymarket, Kalshi or both (default). |
| **Keywords** | Only markets about these topics, e.g. `bitcoin`, `fed`, `election`. Empty = the most traded markets. |
| **Categories** | Optional: `Politics`, `Crypto`, `Sports`, `Economics`, `Elections`, `Climate and Weather`... |
| **Sort by** | Most traded in 24h (default), most traded overall, biggest 24h move or closing soonest. |
| **Max markets per platform** | How many markets to keep from each platform, after sorting. |
| **Min total volume** | Skip thin markets. |
| **Min 24h move (points)** | Only markets whose probability moved at least this much. |

```json
{
  "keywords": ["bitcoin", "fed"],
  "sortBy": "volume24h",
  "maxMarketsPerPlatform": 50,
  "minChange24h": 0
}
```

### Output

One row per market (each outcome of a multi-outcome event is its own market):

```json
{
  "platform": "Polymarket",
  "category": "Economy",
  "eventTitle": "Fed Decision in October?",
  "question": "Will there be no change in Fed interest rates after the October 2026 meeting?",
  "outcome": "No change",
  "outcomes": [{"name": "Yes", "price": 0.945}, {"name": "No", "price": 0.055}],
  "probability": 94.5,
  "lastPrice": 0.945,
  "bestBid": 0.944,
  "bestAsk": 0.946,
  "change24h": -1.0,
  "volume": 98500000.0,
  "volume24h": 1803564.35,
  "volumeUnit": "USD",
  "liquidity": 1961748.4,
  "openInterest": null,
  "endDate": "2026-10-29T03:59:00Z",
  "url": "https://polymarket.com/event/fed-decision-in-october",
  "marketId": "0x...",
  "eventId": "fed-decision-in-october",
  "scrapedAt": "2026-10-26T09:26:30Z"
}
```

- `probability` is the chance of **Yes** in %, from the last trade (or the bid/ask midpoint when there's no trade yet).
- `change24h` is the move of that probability in the last 24 hours, in percentage points.
- Volume is in **USD on Polymarket** and in **contracts on Kalshi** (each contract pays $1), see `volumeUnit`. Kalshi markets have `openInterest`; Polymarket markets have `liquidity`.

### Good to know

- Only **open** markets are returned.
- Data comes from the public read-only APIs of each platform. This Actor doesn't place trades and isn't affiliated with Polymarket or Kalshi.
- Prediction markets aren't available to trade in every country. This tool only reads public prices.

### Integrations

Schedule it with Apify Schedules and send results to Google Sheets, Slack, Telegram, Discord, Zapier, Make, n8n or your own API.

### How to use it

1. Click **Try for free** (or **Start**) at the top of this page.
2. Fill in the input, or keep the example to see it working in seconds.
3. Click **Start** and wait for the run to finish.
4. Download the results as **Excel, CSV, JSON or HTML**, or get them through the Apify API.

### How much does it cost?

**$0.002 per market** ($2.00 per 1,000). No start fee, no monthly fee, and you only pay for the results saved to your dataset.

| Example | Cost |
|---|---|
| Top 100 markets on both platforms | about $0.40 |
| Hourly movers alert for a month | about $10.00 |

Apify's free plan includes monthly credit, so you can try it for free.

### FAQ

**Do I need a Polymarket or Kalshi account?**

No. It reads both platforms' public APIs, with no login or API key.

**Can I compare the same event on both platforms?**

Yes. Search a keyword (for example fed or bitcoin) and both platforms come out in the same format, side by side.

**Can I get alerts when odds move a lot?**

Yes. Set "Min 24h move" (for example 10 points) and schedule it hourly or daily.

**Is volume in dollars?**

On Polymarket, yes. On Kalshi it is in contracts, each of which pays $1. The volumeUnit field says which.

### More tools from Sndz Data

- [BORME Scraper API - Spain New Company Leads Daily](https://apify.com/sndzcc/borme-spain-companies): every new company registered in Spain, daily
- [App Store & Google Play Reviews Scraper API](https://apify.com/sndzcc/app-reviews-scraper): App Store and Google Play reviews in one run
- [Job Scraper API - Greenhouse, Lever, Ashby & Workable](https://apify.com/sndzcc/ats-jobs-scraper): all open jobs from Greenhouse, Lever, Ashby and more
- [Google News Scraper API - Articles with Real URLs](https://apify.com/sndzcc/google-news-scraper): news by keyword or topic, with real article URLs
- [Email & Contact Scraper API - Emails, Phones & Socials](https://apify.com/sndzcc/contact-details-scraper): emails, phones and social profiles from any website
- [Telegram Scraper API - Channel Posts, Views & Media](https://apify.com/sndzcc/telegram-channel-scraper): posts, views and media from public Telegram channels
- [Brand Monitoring API - Mentions Radar for News & Reddit](https://apify.com/sndzcc/brand-mentions-radar): brand mentions across 9 sources, with sentiment
- [AI Image Upscaler API - Upscale & Enhance Photos 4x](https://apify.com/sndzcc/ai-image-upscaler): upscale and enhance photos 4x with AI
- [Keyword Research API - Google, YouTube & Amazon Ideas](https://apify.com/sndzcc/keyword-ideas-machine): hundreds of keyword ideas from 5 search engines
- [Tech Stack Detector API - Wappalyzer & BuiltWith Alternative](https://apify.com/sndzcc/tech-stack-detector): the technologies behind any website, in bulk
- [WHOIS & Domain Lookup API - DNS, SSL & Availability](https://apify.com/sndzcc/domain-intel): WHOIS, availability, DNS and SSL for any list of domains
- [Bluesky Scraper API - Posts, Profiles & Followers](https://apify.com/sndzcc/bluesky-scraper): posts, profiles and followers from Bluesky, no login
- [SEO Audit API - Broken Links, Meta Tags & Site Crawler](https://apify.com/sndzcc/seo-audit): SEO audit and broken link checker for any website
- [OCR API - Image & PDF to Text Extractor, 100+ Languages](https://apify.com/sndzcc/image-pdf-to-text): text from images and scanned PDFs, 100+ languages

### Support

Want price history, order books or another platform? Open an issue on the **Issues** tab.

If this Actor saves you time, a quick ⭐ review helps a lot and keeps it maintained. Thank you!

# Actor input Schema

## `platforms` (type: `array`):

Which prediction markets to read. Both by default.

## `keywords` (type: `array`):

Only markets about any of these topics, e.g. bitcoin, fed, election, trump, nba. Leave empty for the most traded markets.

## `categories` (type: `array`):

Optional. Only markets in these categories, e.g. Politics, Crypto, Sports, Economics, Elections, Climate and Weather.

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

Which markets come first (and are kept when there are more than the maximum).

## `maxMarketsPerPlatform` (type: `integer`):

How many markets to save from each platform, after sorting.

## `minVolume` (type: `integer`):

Skip thin markets. USD on Polymarket, contracts on Kalshi (1 contract pays $1).

## `minChange24h` (type: `number`):

Only markets whose probability moved at least this many percentage points in 24 hours, up or down. 0 = all markets. Great for daily alerts on big moves.

## Actor input object example

```json
{
  "platforms": [
    "polymarket",
    "kalshi"
  ],
  "keywords": [
    "bitcoin",
    "fed"
  ],
  "sortBy": "volume24h",
  "maxMarketsPerPlatform": 100,
  "minVolume": 0,
  "minChange24h": 0
}
```

# Actor output Schema

## `overview` (type: `string`):

One row per market: platform, event, outcome, probability, 24h move, volume, end date and link.

## `allData` (type: `string`):

Every field, including bid/ask, liquidity or open interest, outcome prices and market IDs.

# 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 = {
    "keywords": [
        "bitcoin",
        "fed"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sndzcc/prediction-markets-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 = { "keywords": [
        "bitcoin",
        "fed",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("sndzcc/prediction-markets-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 '{
  "keywords": [
    "bitcoin",
    "fed"
  ]
}' |
apify call sndzcc/prediction-markets-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sndzcc/prediction-markets-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/3tGpT1soVAbEkfawd/builds/2ncNNDxyhfhatCwYh/openapi.json