# Polymarket Whale Tracker - Smart Money, Top Traders & Holders (`smartmoney-data/polymarket-smart-money`) Actor

Track Polymarket smart money: large whale trades as they happen, the top traders by profit with their open positions, the biggest holders of any market, and any wallet's portfolio. Public Polymarket data, no API key, no login.

- **URL**: https://apify.com/smartmoney-data/polymarket-smart-money.md
- **Developed by:** [SmartMoney Data](https://apify.com/smartmoney-data) (community)
- **Categories:** Business, AI, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 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 - Smart Money, Top Traders & Holders

**See where the biggest money on Polymarket is going: whale bets as they happen, what the most profitable traders hold, and who is on each side of a market.**

| | |
|---|---|
| **Data** | Polymarket's official public APIs (trades, positions, holders, leaderboard, markets) |
| **Price** | $3 per 1,000 records, no subscription. Apify's free plan credit covers a first test. |
| **Freshness** | Live: every run reads the latest trades and positions |
| **Try it** | The input is pre-filled with a working example: just click **Start**. |

**Example output**

| Trader | Side | Outcome | Price | Trade $ | Market |
|---|---|---|---|---|---|
| whale_one | BUY | Yes | 0.81 | $48,600 | Will the Fed cut rates in December? |
| sharp_two | SELL | Over | 0.30 | $15,000 | Lens vs Sporting: O/U 1.5 |

*Illustrative rows; real runs return the full fields listed under Output.*

Prediction-market prices move when big, well-informed traders put money down. This Actor tracks them through Polymarket's own public APIs, with four modes:

| Mode | What you get |
|---|---|
| **Whale trades** | Every trade above your dollar threshold, newest first, with the trader's name and portfolio value |
| **Top traders** | The leaderboard by profit or volume (day, week, month, all time) with each trader's biggest open positions |
| **Who holds a market** | For any market or event URL: current prices, the largest holders of each outcome, and the biggest trades |
| **Wallets** | Portfolio value and open positions for any wallet you want to follow |

### What you can do with it

- 🐋 **Whale alerts:** schedule it every 15 minutes and send $25k+ bets to Slack, Discord or Telegram.
- 🧠 **Copy the sharpest traders:** see what this week's most profitable accounts are holding right now.
- ⚖️ **Read a market:** are the big holders on Yes or No?
- 📰 **News and research:** spot where money flows on elections, the Fed, crypto and sports before the price settles.

### How to use it

#### Whale bets over $25,000 in the last 6 hours

```json
{ "mode": "whales", "minUsd": 25000, "lookbackHours": 6 }
```

#### Whale bets on Fed markets only

```json
{ "mode": "whales", "minUsd": 5000, "marketKeyword": "Fed" }
```

#### This week's 20 most profitable traders and their top 5 positions

```json
{ "mode": "top-traders", "timePeriod": "WEEK", "orderBy": "PNL", "maxResults": 20 }
```

#### Who holds this market

```json
{ "mode": "market", "markets": ["https://polymarket.com/event/your-event-slug"] }
```

### Output

Whale trade:

```json
{
  "type": "whale-trade",
  "timestamp": "2026-10-13T16:43:58.000Z",
  "wallet": "0x5fdd...a747",
  "trader": "juice-fruit",
  "side": "BUY",
  "outcome": "Over",
  "price": 0.83,
  "shares": 15076.62,
  "usdValue": 12513.59,
  "market": "Racing Club de Lens vs. Sporting CP: O/U 1.5",
  "marketUrl": "https://polymarket.com/event/ucl-rcl-spo-2026-10-13-more-markets",
  "traderUrl": "https://polymarket.com/profile/0x5fdd...a747",
  "traderPortfolioValue": 48210.5
}
```

Top trader rows add `rank`, `pnlUsd`, `volumeUsd` and `topPositions` (market, outcome, shares, average and current price, value, profit). Market rows list each `outcome` with its `price` and `topHolders`, plus `largeTrades`.

### Use it from code or an AI agent

**Python**

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("smartmoney-data/polymarket-smart-money").call(run_input={"mode": "whales", "minUsd": 25000})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**AI agents (Claude, ChatGPT, Cursor and other MCP clients):** connect the Apify MCP server with this Actor preloaded:

```text
https://mcp.apify.com/?tools=smartmoney-data/polymarket-smart-money
```

Add this URL as a remote MCP server or custom connector in your AI client, sign in with Apify (OAuth), then just ask, for example:

> What are the biggest Polymarket bets in the last 6 hours, and what do this week's top traders hold?

> Part of the **SmartMoney Data** suite: [Congress Stock Trades](https://apify.com/smartmoney-data/congress-stock-trades-tracker) · [Insider Trades](https://apify.com/smartmoney-data/sec-insider-trades-tracker) · [Smart Money Alerts](https://apify.com/smartmoney-data/smart-money-watchlist-alerts) · [Washington Money](https://apify.com/smartmoney-data/washington-money-contracts-lobbying)

### Pricing

**Pay per result:** you're charged for each record returned. See the **Pricing** tab for current rates.

### FAQ

**Do I need a Polymarket account or API key?**
No. Everything comes from Polymarket's public read-only APIs.

**Are trader names real identities?**
No. They are the usernames or pseudonyms traders chose on Polymarket, plus their public wallet address.

**Is this legal to use?**
Yes. The data is public and read from Polymarket's documented public endpoints. This Actor does not place trades.

### Support

Found a bug or need a feature? Open an issue on the **Issues** tab or email **smartmoney-data@googlegroups.com**.

*Data is provided for informational purposes only and is not financial advice. Prediction markets may be restricted in your country.*

# Actor input Schema

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

Whale trades, the leaderboard's top traders, the holders of specific markets, or specific wallets.

## `minUsd` (type: `integer`):

Whale and market modes: only trades of at least this many dollars.

## `lookbackHours` (type: `integer`):

Whale mode: only trades in the last N hours.

## `marketKeyword` (type: `string`):

Whale mode: only markets whose title contains this, e.g. Fed, election, Bitcoin.

## `side` (type: `string`):

Whale mode: buys, sells or both.

## `timePeriod` (type: `string`):

Top-traders mode.

## `orderBy` (type: `string`):

Top-traders mode.

## `positionsPerTrader` (type: `integer`):

Top-traders and wallets modes: largest open positions to include.

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

Market mode: Polymarket URLs or slugs. An event URL covers all its open markets.

## `holdersPerOutcome` (type: `integer`):

Market mode: largest holders listed for each outcome.

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

Wallets mode: Polymarket wallet addresses (0x...).

## `enrichTraders` (type: `boolean`):

Whale mode: one extra lookup per trader.

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

Upper bound on records returned.

## Actor input object example

```json
{
  "mode": "whales",
  "minUsd": 10000,
  "lookbackHours": 24,
  "marketKeyword": "",
  "side": "",
  "timePeriod": "WEEK",
  "orderBy": "PNL",
  "positionsPerTrader": 5,
  "markets": [],
  "holdersPerOutcome": 10,
  "wallets": [],
  "enrichTraders": true,
  "maxResults": 100
}
```

# Actor output Schema

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

No description

## `summary` (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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("smartmoney-data/polymarket-smart-money").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("smartmoney-data/polymarket-smart-money").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 '{}' |
apify call smartmoney-data/polymarket-smart-money --silent --output-dataset

```

## MCP server setup

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

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/qUzgogQRhabWbmBus/builds/Ap9PBawipEpzMHTfG/openapi.json