# Polymarket Whale Tracker: Unusual-activity Scores, Wallet P\&L (`mrlarryjohnson/polymarket-whale-tracker-pro`) Actor

Track Polymarket whales: large-trade feed with 0-100 unusual-activity scores, top holders per market, and full wallet P\&L reports. Dedup billing — the same trade is never charged twice.

- **URL**: https://apify.com/mrlarryjohnson/polymarket-whale-tracker-pro.md
- **Developed by:** [Larry Johnson](https://apify.com/mrlarryjohnson) (community)
- **Categories:** AI, MCP servers, Agents
- **Features:** Limited permissions
- **Stats:** 11 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 whale trade records

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 Whale Tracker — Unusual-activity-Scored Trades, Top Holders & Wallet P\&L

> **Not financial advice.** Informational data only. Scores are statistical heuristics about trade size and patterns; they do not mean anyone has inside or non-public information.

Track the **smart money on Polymarket** without building a data pipeline: a clean, deduplicated **whale alert feed** of large trades (each scored 0–100 for "how unusual is this?"), **top holders** for any prediction market, and full **wallet P\&L reports** — from Polymarket's public APIs, normalized into one schema. Perfect for whale alerts, copy-trading research, smart-money dashboards, and prediction-market analytics.

### Why this tracker

- **Unusual-activity scoring, not just size.** Every trade gets a 0–100 score from heuristics built for a private prediction-market trading engine: conviction longshots (big money at extreme odds), niche-market concentration (big fish in small pools), late-certainty sweeps (resolution-sniping pattern).
- **You are never billed twice for the same trade.** Whale-feed mode keeps a cross-run dedup store of transaction hashes — schedule it hourly and you only pay for *new* events.
- **Partial-failure resilient.** One delisted market or bad wallet never kills your run; you get the error inline and everything else completes.
- **Every record carries the on-chain `tx` hash** — verify any trade independently on Polygonscan. No black-box numbers.
- **No API keys, no wallet, no login** — public Polymarket endpoints only. Works out of the box.

### Modes

| Mode | What you get | Typical use |
|---|---|---|
| `whale-feed` | All trades ≥ `minTradeUsd` across Polymarket, unusual-activity-scored | Whale alerts (webhook/Slack/Telegram), smart-money dashboards |
| `market-whales` | Top holders + recent whale trades for given market slugs | Research one election/race/event in depth |
| `wallet-tracker` | Positions, open P\&L, recent activity per wallet | Follow specific proven traders (copy-trading research) |

### Quick start

1. Pick a mode (default `whale-feed` works with zero config).
2. Run once to see the data, then **schedule it** (every 10–60 min) for a continuous feed.
3. Add an Apify **webhook integration** to pipe new whales straight into Slack, Discord, Telegram, or your own endpoint.

### Input reference

| Field | Mode | Default | Notes |
|---|---|---|---|
| `mode` | — | `whale-feed` | `whale-feed` | `market-whales` | `wallet-tracker` |
| `minTradeUsd` | whale-feed, market-whales | 10000 | Only trades at/above this USD size |
| `maxResults` | whale-feed | 100 | Hard cap per run — bounds your cost |
| `dedupAcrossRuns` | whale-feed | true | Never output (or bill) the same tx twice |
| `markets` | market-whales | \[] | Market slugs from the polymarket.com URL (max 25) |
| `topHolders` | market-whales | 10 | Largest holders returned per market |
| `wallets` | wallet-tracker | \[] | Proxy wallet addresses 0x… (max 50) |
| `maxPositions` | wallet-tracker | 25 | Open positions per wallet report |
| `activityLimit` | wallet-tracker | 25 | Recent trades/redemptions per wallet report |

### Sample output (whale-feed)

```json
{
  "detectedAt": "2026-06-09T19:40:11+00:00",
  "tx": "0x8be0...",
  "wallet": "0xd1049158a102840ce595efc6ab683a0cb6fbacef",
  "trader": "pilimili",
  "side": "BUY",
  "outcome": "Yes",
  "price": 0.9705,
  "shares": 19419.75,
  "usd": 18847.27,
  "title": "Israel closes its airspace by June 9?",
  "slug": "israel-closes-its-airspace-by-june-9",
  "link": "https://polymarket.com/event/israel-closes-its-airspace-by-june-9",
  "score": 30
}
```

### What the 0–100 unusual-activity score means

| Signal | Points | Why it matters |
|---|---|---|
| Trade size ($1k → $100k+) | up to 45 | Bigger bets = stronger conviction |
| Conviction longshot (big BUY ≤ 15¢ / SELL ≥ 85¢) | +20 | Informed traders take asymmetric odds |
| Niche market (< $50k daily volume) | +25 | Big fish in small pools move first |
| Late-certainty sweep (≥ 95¢ BUY ≥ $20k) | +10 | Classic resolution-sniping pattern |

Score ≥ 60 is rare and worth a look; sort the dataset by `score` descending.

### Pricing

Pay-per-event: you're charged only for records actually delivered (new whale trades / market snapshots / wallet reports). Set `maxResults` to hard-cap any run's cost; dedup means scheduled runs only pay for genuinely new activity.

### Use with AI agents (Claude, Cursor, n8n — MCP)

This Actor works out of the box as an **MCP tool**. Point your agent at Apify's hosted MCP server and it can call the Actor directly:

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=mrlarryjohnson/polymarket-whale-tracker-pro"
    }
  }
}
```

OAuth sign-in happens on first connect (or use an `Authorization: Bearer <APIFY_TOKEN>` header). Your agent can then fetch live unusual-activity-scored whale trades, market holders, or wallet P\&L on demand and reason over the results — same pay-per-event pricing, no extra setup.

### FAQ

- **Do I need API keys or a crypto wallet?** No — public Polymarket endpoints only.
- **How fresh is the data?** Each run pulls live data; schedule the actor (e.g. every 10–60 min) for a near-real-time whale feed.
- **Can I export to CSV / Excel / JSON?** Yes — standard Apify dataset export formats.
- **Does it cover sports, elections, crypto markets?** All of Polymarket — every market, every category.
- **Is this financial advice?** No. Informational data only.

### Changelog

- **0.1** — initial release: three modes (whale feed, market whales, wallet tracker), 0–100 unusual-activity scoring, cross-run dedup billing.

### More tools by this maker

| Tool | What it does |
|---|---|
| [Polymarket Whale Tracker Pro](https://apify.com/mrlarryjohnson/polymarket-whale-tracker-pro) | Unusual-activity-scored large trades, top holders, wallet P\&L |
| [Polymarket Top Traders](https://apify.com/mrlarryjohnson/polymarket-top-traders) | Leaderboards with cross-window consistency + verified P\&L |
| [Polymarket MCP Server](https://apify.com/mrlarryjohnson/polymarket-mcp-server) | The same live data as native AI-agent tools (MCP) |
| [Hyperliquid Whale Tracker](https://apify.com/mrlarryjohnson/hyperliquid-whale-tracker) | Scored perp trades w/ counterparty addresses, funding/OI, wallet PnL |
| [Web Search MCP Server](https://apify.com/mrlarryjohnson/web-search-mcp-server) | Multi-engine web/news search + instant answers for AI agents |

Same engineering rules everywhere: fail-loud data integrity, dedup-before-billing, errors never billed.

# Actor input Schema

## `mode` (type: `string`):

whale-feed = global large-trade feed (unusual-activity-scored). market-whales = top holders + recent whale trades for given market slugs. wallet-tracker = positions, P\&L and activity for given wallets.

## `minTradeUsd` (type: `integer`):

Only surface trades at or above this dollar size.

## `maxResults` (type: `integer`):

Cap on records returned per run — protects your pay-per-event budget.

## `markets` (type: `array`):

Polymarket market slugs, e.g. from the URL polymarket.com/event/<slug>. Max 25.

## `wallets` (type: `array`):

Polymarket proxy wallet addresses (0x...). Max 50.

## `topHolders` (type: `integer`):

How many of the largest holders to return per market (market-whales mode).

## `maxPositions` (type: `integer`):

Cap on open positions included in each wallet report.

## `activityLimit` (type: `integer`):

How many recent trades/redemptions to include in each wallet report.

## `dedupAcrossRuns` (type: `boolean`):

Never output (or bill) the same transaction twice across scheduled runs.

## Actor input object example

```json
{
  "mode": "whale-feed",
  "minTradeUsd": 10000,
  "maxResults": 10,
  "markets": [],
  "wallets": [],
  "topHolders": 10,
  "maxPositions": 25,
  "activityLimit": 25,
  "dedupAcrossRuns": true
}
```

# Actor output Schema

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

All records produced by this run as JSON items.

# 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 = {
    "mode": "whale-feed",
    "minTradeUsd": 10000,
    "maxResults": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("mrlarryjohnson/polymarket-whale-tracker-pro").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 = {
    "mode": "whale-feed",
    "minTradeUsd": 10000,
    "maxResults": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("mrlarryjohnson/polymarket-whale-tracker-pro").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 '{
  "mode": "whale-feed",
  "minTradeUsd": 10000,
  "maxResults": 10
}' |
apify call mrlarryjohnson/polymarket-whale-tracker-pro --silent --output-dataset

```

## MCP server setup

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

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/AfQL52CKQYXGfsELE/builds/I99OlO4IOp7Q6GLEM/openapi.json