Polymarket Watchlist & Movement Alerts

Monitor the prediction markets that matter to you without manually searching Polymarket or comparing numbers between visits. Polymarket Alerts & Market Watchlist API discovers relevant markets from topics, people, companies, and exact market links, then alerts you when listings, odds, volume, liquidity, or market status change.

The Actor uses Polymarket's public data APIs. You do not need a Polymarket account, wallet, trading credentials, or Polymarket API key.

What can Polymarket Alerts & Market Watchlist API do?

• Discover active markets related to a topic such as artificial intelligence, elections, Bitcoin, or interest rates.
• Follow people, companies, products, and organizations.
• Track exact markets or multi-market events using a Polymarket URL, slug, market ID, or condition ID.
• Detect newly listed matching markets.
• Alert when outcome probabilities move by a configurable number of percentage points.
• Alert when cumulative volume or available liquidity changes beyond your USD and percentage thresholds.
• Detect market activation and closure.
• Deliver alert batches to HTTPS webhooks, including Make, Zapier, custom endpoints, and Discord-compatible webhooks.
• Export results from Apify as JSON, CSV, Excel, XML, RSS, or HTML.

This Actor is useful for traders, researchers, journalists, analysts, investors, risk teams, and automation builders who need structured Polymarket monitoring instead of a one-time market search.

How to monitor Polymarket markets

1. Add at least one topic, person, company, or exact market to your watchlist.
2. Choose the movement thresholds that should create an alert.
3. Run the Actor once to establish the initial baseline.
4. Create an Apify schedule using the same input—for example, every 15 minutes or every hour.
5. Read alert records from the dataset or send them directly to your webhook workflow.

The first run is quiet by default. It saves current values as a baseline so old markets are not incorrectly reported as new. Enable Alert for every match on the first run only when you deliberately want immediate test alerts.

Polymarket watchlist input

Input	What it controls
topics	Subjects and themes to discover
people	People mentioned in relevant markets
companies	Companies, products, and organizations
markets	Exact Polymarket URLs, event slugs, market IDs, or condition IDs
priceChangePercentPoints	Minimum odds movement in probability percentage points
volumeChangePercent and volumeChangeUsd	Relative and absolute cumulative-volume thresholds
liquidityChangePercent and liquidityChangeUsd	Relative and absolute liquidity thresholds
minimumMarketVolumeUsd	Filters low-volume search discoveries; exact markets bypass it
includeSnapshots	Adds current market snapshots alongside alerts
webhookUrls	Optional HTTPS destinations for alert batches

Example input

{
  "topics": ["Artificial intelligence", "US interest rates"],
  "people": ["Sam Altman"],
  "companies": ["OpenAI", "Nvidia"],
  "markets": [],
  "priceChangePercentPoints": 3,
  "volumeChangePercent": 25,
  "volumeChangeUsd": 1000,
  "liquidityChangePercent": 25,
  "liquidityChangeUsd": 1000,
  "minimumMarketVolumeUsd": 1000,
  "includeSnapshots": false,
  "alertOnFirstRun": false,
  "resetState": false
}

Search terms can return several markets from the same event. Use minimumMarketVolumeUsd and maxTrackedMarkets to keep broad watchlists focused. For the most precise monitoring, provide exact market or event URLs.

Polymarket alert output

The dataset can contain two record types:

• alert — a threshold was crossed or the market status changed.
• snapshot — the market's current state, included only when includeSnapshots is enabled.

Each alert includes its trigger, matching watchlist term, current and previous outcome probabilities, volume, liquidity, order-book summary, market status, and direct Polymarket URL.

{
  "recordType": "alert",
  "detectedAt": "2026-08-20T10:58:23.655Z",
  "alertTypes": ["liquidity_change"],
  "question": "Will example outcome happen?",
  "outcomes": [
    {
      "name": "Yes",
      "probabilityPercent": 61.5,
      "changePercentPoints": 2.5
    }
  ],
  "volume": {
    "currentUsd": 125000,
    "changeUsd": 4200,
    "changePercent": 3.48
  },
  "liquidity": {
    "currentUsd": 18200,
    "changeUsd": 2200,
    "changePercent": 13.75
  },
  "url": "https://polymarket.com/event/example-market"
}

Movement thresholds are measured from the last alert baseline for that metric. Smaller changes therefore accumulate until they become large enough to trigger an alert.

Scheduled Polymarket alerts

This Actor performs one market check per run. Use an Apify schedule to turn it into continuous monitoring.

For scheduled runs:

• Keep the watchlist and stateStoreName unchanged so the saved baseline is reused.
• Keep resetState set to false.
• Keep alertOnFirstRun set to false after testing.
• Set includeSnapshots to false if you want datasets and webhooks to contain actionable alerts only.
• Avoid overlapping runs of the same watchlist.

Different watchlists are automatically isolated inside the state store. Changing the topics, people, companies, or exact markets creates a separate baseline.

Send Polymarket alerts to webhooks

When a run detects alerts, the Actor can send one JSON batch to each configured HTTPS webhook. The payload includes a human-readable text field and the complete alerts array.

Webhook URLs and custom headers are encrypted secret inputs. This makes it possible to connect authenticated APIs without exposing credentials in the dataset or run logs.

If delivery is critical, enable failOnWebhookError. An unsuccessful webhook will then fail the run so your schedule or external automation can retry it.

Polymarket monitoring API and integrations

Run the Actor manually, on a schedule, through the Apify API, or from integrations such as Make, Zapier, n8n, and other automation platforms. Results are stored in a structured Apify dataset and can be downloaded or consumed programmatically.

No browser or proxy is used. The Actor queries Polymarket's public Gamma API and maintains its own persistent comparison layer across runs.

How much does Polymarket monitoring cost?

The exact price and platform usage estimate are displayed in Apify before you start a run. This Actor does not require paid proxies or third-party API subscriptions. Cost mainly depends on how often it runs and how many search terms and retained markets it checks.

For an efficient production setup, begin with a 15- or 60-minute schedule, use focused search terms, set a minimum market-volume filter, and disable snapshots when you only need alerts.

Limitations

• This is scheduled monitoring, not a real-time streaming trading feed. Detection speed depends on your schedule frequency.
• Topic, person, and company discovery uses Polymarket search relevance and may return broadly related markets. Exact URLs provide the highest precision.
• A first run cannot identify historical changes because no previous baseline exists.
• Availability and field accuracy depend on Polymarket's public APIs.
• The Actor monitors public market data; it does not place trades or access user portfolios.

Frequently asked questions

Does this Actor scrape Polymarket?

No. It uses Polymarket's public APIs and adds discovery, persistent baselines, threshold evaluation, structured output, scheduling, and webhook delivery.

Do I need a Polymarket account or wallet?

No. Public market monitoring does not require authentication, a wallet, or trading credentials.

Why did my first run produce no alerts?

That is the expected default. The first run creates the comparison baseline. Enable snapshots to inspect matches immediately, or temporarily enable first-run alerts for testing.

Why do I see both an alert and a snapshot for the same market?

includeSnapshots was enabled. Disable it when you want only actionable alert records.

How do I start over with a fresh baseline?

Enable resetState for one manual run, then turn it off again. Do not leave it enabled in a schedule.

Can I monitor one exact market?

Yes. Add its Polymarket URL, slug, numeric market ID, or condition ID to markets and leave the broader search lists empty.

Support and disclaimer

If you find an issue or need a new alert type, open an issue from the Actor's Issues tab with a sample input and run ID.

Prediction-market probabilities are not financial advice. Polymarket controls market data and resolution rules. Review each market's resolution criteria before making decisions based on an alert.