| Extract Polymarket's top traders with wallet addresses, P&L, volume, open positions, and trade history — powered by public APIs for maximum speed and reliability. |
##### Copy to your AI assistant
Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.
````
parsebird/polymarket-scraper on Apify. Call: ApifyClient("TOKEN").actor("parsebird/polymarket-scraper").call(run\_input={...}), then client.dataset(run\["defaultDatasetId"]).list\_items().items for results. Key inputs: timeRange (string, "DAY"/"WEEK"/"MONTH"/"ALL", default "MONTH"), category (string, "OVERALL"/"POLITICS"/"SPORTS"/"CRYPTO"/"FINANCE"/"CULTURE"/"MENTIONS"/"WEATHER"/"ECONOMICS"/"TECH", default "OVERALL"), leaderboardType (string, "PNL"/"VOL", default "PNL"), maxResults (integer, 1-1000, default 20), includePositions (boolean, default true), includeActivity (boolean, default true). Full actor spec: fetch build via GET https://api.apify.com/v2/acts/parsebird~polymarket-scraper (Bearer TOKEN). Get token: https://console.apify.com/account/integrations
````
### What does Polymarket Leaderboard Scraper do?
This Actor scrapes Polymarket's leaderboard rankings and enriches each trader with detailed profile data. It uses Polymarket's public REST APIs directly — no browser needed — making it fast, reliable, and cost-effective.
For each trader on the leaderboard, the scraper collects:
- **Leaderboard data** — rank, wallet address, username, profile image, P&L, volume, verified badge, X (Twitter) handle
- **Profile enrichment** — display name, bio, join date, profile URL
- **Portfolio value** — total current positions value
- **Open positions** (optional) — market title, outcome, size, avg price, current value, cash P&L, percent P&L
- **Recent trades** (optional) — last 10 trades with market title, outcome, side, size, price, USDC size, timestamp
### Why scrape Polymarket?
- **Trading intelligence** — Track the top-performing traders on the world's largest prediction market and analyze their strategies
- **Portfolio analysis** — Study what positions the best traders hold, their entry prices, and current P&L
- **Market research** — Identify trending markets by seeing where top traders are placing bets
- **Wallet tracking** — Get wallet addresses of top traders for on-chain analysis and copy-trading
- **Social discovery** — Find X (Twitter) handles and profiles of influential prediction market traders
- **Data enrichment** — Feed trader data into your own analytics platform, dashboard, or trading tools
- **Academic research** — Study prediction market behavior, trader performance, and market efficiency
### How to use
1. Go to the [Polymarket Leaderboard Scraper](https://apify.com/parsebird/polymarket-scraper) page on Apify Store
2. Click **Try for free**
3. Configure your input:
- **Time Range** — Today, This Week, This Month, or All Time
- **Category** — All Categories, Politics, Sports, Crypto, Finance, Culture, etc.
- **Leaderboard Type** — Rank by Profit/Loss or Volume
- **Max Results** — How many traders to scrape (1–1000)
- **Include Positions** — Fetch current open positions for each trader
- **Include Recent Trades** — Fetch last 10 trades for each trader
4. Click **Start** and wait for the run to finish
5. Download your data in JSON, CSV, Excel, or connect via API
### Input parameters
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `timeRange` | enum | `MONTH` | Leaderboard time period: `DAY` (today), `WEEK`, `MONTH`, `ALL` |
| `category` | enum | `OVERALL` | Market category: `OVERALL`, `POLITICS`, `SPORTS`, `CRYPTO`, `FINANCE`, `CULTURE`, `MENTIONS`, `WEATHER`, `ECONOMICS`, `TECH` |
| `leaderboardType` | enum | `PNL` | Rank by profit/loss (`PNL`) or trading volume (`VOL`) |
| `maxResults` | integer | `20` | Number of traders to scrape (1–1000) |
| `includePositions` | boolean | `true` | Fetch current open positions for each trader |
| `includeActivity` | boolean | `true` | Fetch last 10 trades for each trader |
### Output data
Each result represents one trader with the following fields:
| Field | Type | Description |
|-------|------|-------------|
| `rank` | number | Leaderboard position |
| `walletAddress` | string | Trader's proxy wallet address |
| `username` | string | Polymarket username |
| `displayName` | string | Display name from profile |
| `profileImage` | string | Profile image URL |
| `xUsername` | string | X (Twitter) handle |
| `verifiedBadge` | boolean | Whether the trader is verified |
| `profitLoss` | number | Profit/loss for the selected time period |
| `volume` | number | Trading volume for the selected time period |
| `positionsValue` | number | Total current portfolio value |
| `bio` | string | Profile bio text |
| `joinedAt` | string | Account creation date |
| `profileUrl` | string | Full Polymarket profile URL |
| `positions` | array | Current open positions (if enabled) |
| `recentTrades` | array | Last 10 trades (if enabled) |
| `scrapedAt` | string | ISO timestamp of when the data was scraped |
#### Positions array fields
| Field | Type | Description |
|-------|------|-------------|
| `title` | string | Market question title |
| `outcome` | string | Position outcome (Yes/No) |
| `size` | number | Position size |
| `avgPrice` | number | Average entry price |
| `currentValue` | number | Current position value |
| `cashPnl` | number | Cash profit/loss |
| `percentPnl` | number | Percentage profit/loss |
| `curPrice` | number | Current market price |
| `eventSlug` | string | Market event slug |
#### Recent trades array fields
| Field | Type | Description |
|-------|------|-------------|
| `title` | string | Market question title |
| `outcome` | string | Trade outcome (Yes/No) |
| `side` | string | Trade side (BUY/SELL) |
| `size` | number | Trade size |
| `price` | number | Trade price |
| `usdcSize` | number | Trade value in USDC |
| `timestamp` | string | Trade timestamp |
| `eventSlug` | string | Market event slug |
#### Example output
```json
{
"rank": 1,
"walletAddress": "0x1234...abcd",
"username": "toptrader",
"displayName": "Top Trader",
"profileImage": "https://polymarket-upload.s3.us-east-2.amazonaws.com/...",
"xUsername": "toptrader_x",
"verifiedBadge": true,
"profitLoss": 125000.50,
"volume": 500000.00,
"positionsValue": 75000.00,
"bio": "Full-time prediction market trader",
"joinedAt": "2023-06-15T12:00:00.000Z",
"profileUrl": "https://polymarket.com/@toptrader",
"positions": [
{
"title": "Will Bitcoin hit $100k by end of 2026?",
"outcome": "Yes",
"size": 1000,
"avgPrice": 0.65,
"currentValue": 750.00,
"cashPnl": 100.00,
"percentPnl": 15.38,
"curPrice": 0.75,
"eventSlug": "bitcoin-100k-2026"
}
],
"recentTrades": [
{
"title": "US Presidential Election 2028 Winner",
"outcome": "Yes",
"side": "BUY",
"size": 500,
"price": 0.42,
"usdcSize": 210.00,
"timestamp": "2026-03-27T14:30:00.000Z",
"eventSlug": "us-presidential-election-2028"
}
],
"scrapedAt": "2026-03-28T10:00:00.000Z"
}
````
### Use with the Apify API
```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("parsebird/polymarket-scraper").call(run_input={
"timeRange": "WEEK",
"category": "POLITICS",
"leaderboardType": "PNL",
"maxResults": 50,
"includePositions": True,
"includeActivity": True,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(f"#{item['rank']} {item.get('username', 'N/A')} — P&L: ${item.get('profitLoss', 0):,.2f}")
```
### Pricing
This Actor uses **Pay-per-event** pricing:
| Event | Cost | Rate |
|-------|------|------|
| `pm-leaderboard-profile` | $0.00149 | $1.49 per 1,000 traders |
Each trader profile scraped incurs one charge — this includes leaderboard rank, profile enrichment, positions, and activity data.
**Cost examples:**
- 20 traders (default): $0.03
- 100 traders: $0.15
- 500 traders: $0.75
- 1,000 traders: $1.49
You only pay for the traders actually returned.
### Tips and best practices
- **Start small** — Set `maxResults` to 10–20 for your first run to verify the output format meets your needs.
- **Disable enrichment for speed** — Set `includePositions` and `includeActivity` to `false` if you only need basic leaderboard data. This significantly reduces API calls and run time.
- **Time range matters** — The `DAY` time range may return fewer traders than `ALL`. Adjust `maxResults` accordingly.
- **Rate limits** — The scraper respects Polymarket's API rate limits (1,000 req/10s general, 150 req/10s for positions). Concurrency is capped internally.
- **No browser needed** — This Actor uses Polymarket's public REST APIs directly, so it's fast and doesn't require Playwright or residential proxies.
- **Scheduling** — Set up daily or weekly runs to track leaderboard changes and trader performance over time.
### Integrations
Connect this Actor to your workflow:
- **Google Sheets** — Export results directly
- **Webhooks** — Trigger actions when new data arrives
- **API** — Access data programmatically via the Apify API
- **Zapier / Make** — Automate downstream workflows
### Limitations
- Polymarket leaderboard data is based on their public APIs, which may have slight delays compared to real-time on-chain data.
- The `positions` endpoint has a stricter rate limit (150 req/10s). For large scrapes (500+ traders), the scraper automatically throttles to stay within limits.
- Some traders may not have profile data (bio, display name, X handle) if they haven't set up their Polymarket profile.
- Portfolio value reflects the current snapshot and may change rapidly during active trading hours.
# Actor input Schema
## `timeRange` (type: `string`):
Leaderboard time period. DAY = today, WEEK = this week, MONTH = this month, ALL = all time.
## `category` (type: `string`):
Market category to filter the leaderboard. OVERALL includes all categories.
## `leaderboardType` (type: `string`):
Rank traders by profit/loss (PNL) or trading volume (VOL).
## `maxResults` (type: `integer`):
Maximum number of traders to scrape from the leaderboard (1-1000).
## `includePositions` (type: `boolean`):
Fetch current open positions for each trader. Adds position details like market title, outcome, size, average price, current value, and PnL.
## `includeActivity` (type: `boolean`):
Fetch the last 10 trades for each trader. Adds trade details like market title, outcome, side (buy/sell), size, price, and timestamp.
## Actor input object example
```json
{
"timeRange": "MONTH",
"category": "OVERALL",
"leaderboardType": "PNL",
"maxResults": 20,
"includePositions": true,
"includeActivity": true
}
```
# Actor output Schema
## `dataset` (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 '