Polymarket Leaderboard Scraper

Scrape Polymarket's top-trader leaderboard — ranked by trading volume and profit (PnL) across 1d, 7d, 30d, and all-time windows. Each row gives you the trader's rank, name, on-chain wallet, USD amount, and profile link, with optional live portfolio-value enrichment. HTTP-only against Polymarket's public API — fast, cookieless, no login. MCP-ready for AI agents.

What it does

Polymarket ranks its most active and most profitable traders on a public leaderboard. This actor pulls that leaderboard as clean, structured JSON so you can track smart money, build copy-trading watchlists, or research who is winning on the biggest prediction market in the world.

• Two ranking metrics — volume (total USD traded) and profit (realized PnL in USD).
• Four time windows — last 24 hours (1d), last 7 days (7d), last 30 days (30d), and all-time.
• Top 50 per metric × window — Polymarket's API caps the leaderboard at 50, so 50 is the ceiling for each combination (the actor tells you this and clamps automatically).
• Specific-wallet lookup — pass one or more 0x… addresses to fetch their volume/profit directly, even outside the top 50.
• Live portfolio-value enrichment (optional) — add each trader's current open-position value in USD.

When to use it

• Track "smart money" — find the wallets with the highest all-time or 7-day profit and follow their trades.
• Build a copy-trading watchlist and feed the wallets into a Polymarket position/whale tracker.
• Research prediction-market participants for a newsletter, dashboard, or trading model.
• Monitor how a specific wallet ranks over time by scheduling runs.

Not for: individual market odds, order books, or a single trader's full position history — this actor is the leaderboard, not market or position data.

Output

One dataset row per trader per metric × window:

Field	Type	Description
rank	integer	1-based leaderboard position (null for direct wallet lookups)
metric	string	volume or profit
window	string	1d, 7d, 30d, or all
displayName	string	Best public name (pseudonym or wallet-derived label)
pseudonym	string	Polymarket pseudonym, if set
proxyWallet	string	On-chain proxy-wallet address (0x…)
amountUsd	number	Volume (USD) or profit (USD) depending on metric
portfolioValueUsd	number	Live open-position value (only when enrichment is on)
bio	string	Public profile bio, if set
profileImage	string	Profile image URL, if set
profileUrl	string	Link to the trader's Polymarket profile
scrapedAt	string	ISO 8601 UTC timestamp

Example row

{
  "rank": 1,
  "metric": "volume",
  "window": "all",
  "displayName": "swisstony",
  "pseudonym": "swisstony",
  "proxyWallet": "0x204f72f35326db932158cba6adff0b9a1da95e14",
  "amountUsd": 1348706088.83,
  "portfolioValueUsd": 1631434.05,
  "bio": "",
  "profileImage": "",
  "profileUrl": "https://polymarket.com/profile/0x204f72f35326db932158cba6adff0b9a1da95e14",
  "scrapedAt": "2026-07-01T00:00:00.000Z"
}

Pricing (Pay Per Event)

Event	Price
Actor start	$0.00005
Leaderboard entry (per row)	$0.004
Wallet enriched (per unique wallet, optional)	$0.002

Typical costs:

• Top 50 by profit, all-time (1 metric × 1 window): ~$0.20.
• Both metrics × all 4 windows × 50 (400 rows): ~$1.60.
• Add live portfolio value: +$0.002 per unique wallet.

The actor prints the maximum cost up front and the actual billed amount at the end. Use maxResults to hard-cap spend.

Input

Field	Default	Notes
metrics	["volume","profit"]	Which rankings to scrape
windows	["all"]	1d / 7d / 30d / all, one or more
limit	50	Rows per metric × window (1–50, clamped to 50)
addresses	[]	Optional 0x… wallets to look up directly
enrichPortfolioValue	false	Add live portfolio value per wallet
maxResults	0	Optional total-row cap (0 = no extra cap)
proxyConfiguration	Apify datacenter	Public API — datacenter is enough

Example input

{
  "metrics": ["profit"],
  "windows": ["7d", "all"],
  "limit": 25,
  "enrichPortfolioValue": true
}

Usage

Apify CLI

$apify call khadinakbar/polymarket-leaderboard-scraper --input='{"metrics":["profit"],"windows":["all"],"limit":50}'

JavaScript (apify-client)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('khadinakbar/polymarket-leaderboard-scraper').call({
  metrics: ['volume', 'profit'],
  windows: ['all'],
  limit: 50,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python (apify-client)

from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("khadinakbar/polymarket-leaderboard-scraper").call(run_input={
    "metrics": ["profit"],
    "windows": ["7d", "all"],
    "limit": 50,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

AI agents / MCP

Exposed via Apify MCP as khadinakbar/polymarket-leaderboard-scraper. Give the agent a metric, window, and limit; it returns structured leaderboard rows. Ideal for "who are the top 20 most profitable Polymarket traders this week?" style questions.

FAQ

Why only 50 results? Polymarket's leaderboard API hard-caps each metric × window at 50 traders. There is no pagination past that; the actor requests more windows/metrics to widen coverage instead.

What is a proxy wallet? Polymarket assigns each user an on-chain proxy wallet on Polygon. That address is the stable identifier and the key into position/value data.

Can I get a specific trader who isn't in the top 50? Yes — put their 0x… address in addresses. The actor returns their volume/profit for the selected windows regardless of rank.

How fresh is the data? Live at request time. Schedule the actor to build a time series.

Does it need login or cookies? No. It reads Polymarket's public JSON API.

Legal / disclaimer

This actor collects publicly available data from Polymarket's public API. It does not bypass authentication, access private data, or place trades. Use it in compliance with Polymarket's Terms of Service and all applicable laws. Data is provided as-is for research and informational purposes only and is not financial advice. You are responsible for how you use the output.