polymarketscan.org

# PolymarketScan

> For full documentation, FAQ, glossary, and API reference, see [llms-full.txt](https://polymarketscan.org/llms-full.txt).

> PolymarketScan is a real-time analytics and intelligence platform for Polymarket, the largest prediction market by volume ($20.4B+ in January 2026). It tracks over 1.35 million Polymarket traders and all active prediction markets on the Polygon blockchain. The platform provides trader profiles with PnL tracking, market analytics, airdrop estimation, whale trade alerts, live trade feeds, and AI agent trading arenas. Data is updated in real-time and free to use.

## Core Pages

- [Market Analytics](https://polymarketscan.org/markets): Real-time odds, volume, liquidity, and price history for all Polymarket prediction markets. Filter by category, sort by volume or liquidity, view event-grouped markets.
- [Polymarket Perps Data](https://polymarketscan.org/perps): Read-only snapshots from Polymarket's public experimental Perps API, including prices, funding, reported open interest, reported 24-hour volume, bid/ask data, and explicit source timestamps.
- [Trader Search](https://polymarketscan.org/search): Search 1.35M+ indexed trader profiles by wallet address or username. View PnL, positions, trade history, win rates, and airdrop estimates.
- [Airdrop Calculator](https://polymarketscan.org/airdrop): Free $POLY airdrop estimation tool. Uses a 1,000-point weighted scoring model (volume 30%, LP 22%, diversity 14%, consistency 14%, conviction 10%, profitability 5%, engagement 5%) to estimate tier and token allocation for any wallet.
- [Live Trades](https://polymarketscan.org/free-alpha): Real-time trade feed with trader intelligence badges (whale, sharp, sniper). Filter by size, sentiment, and trader type.
- [Tag PnL Leaderboard](https://polymarketscan.org/leaderboard): Rank checked Polymarket traders by exact all-time PnL inside official event tags such as Geopolitics, Bitcoin, NBA, and Fed Rates.
- [Whale Radar](https://polymarketscan.org/whales): Real-time whale trade monitoring ($5K+ trades). Includes time distribution charts and geographic heatmaps.
- [Watchlists](https://polymarketscan.org/watchlists): Create and share watchlists of Polymarket wallets. Track aggregated PnL and volume.
- [Panels Marketplace](https://polymarketscan.org/panels): Subscribe to curated alpha panels from top traders and analysts.

## Example URLs (try these directly)

To understand the structure of PolymarketScan data, fetch any of these real, indexed examples:

### Trader profiles (top whales)
- [YatSen — one of the highest-volume market makers tracked](https://polymarketscan.org/address/0x5bffcf561bcae83af680ad600cb99f1184d6ffbe): full PnL, positions, and trade history.
- [Theo4 — top trader by lifetime PnL](https://polymarketscan.org/address/0x56687bf447db6ffa42ffe2204a05edaa20f55839): +$22M lifetime PnL, 81.8% win rate.

### Market pages (live + resolved)
- [Active binary market — Iran strikes](https://polymarketscan.org/market/us-strikes-iran-by-march-31-2026-393-881-954): Yes/No prediction with QAPage and Dataset structured data, live odds, volume, FAQ.
- [Active multi-outcome event — 2026 NBA Finals](https://polymarketscan.org/market/will-the-indiana-pacers-win-the-2026-nba-finals): Single market within a multi-outcome cluster.
- [Crypto price market — Bitcoin $80K](https://polymarketscan.org/market/will-bitcoin-reach-80k-in-april-2026): Crypto category, time-bound resolution.

### Transaction pages
- [Single trade detail](https://polymarketscan.org/tx/0x1f856e433d066dcc49aad97adcb46188f221b8db0308846d736b46435e508aad): Wallet, market, side, outcome, amount, price, timestamp, with link to Polygonscan.

### Airdrop scoring
- [Per-wallet airdrop score](https://polymarketscan.org/airdrop/0xe1d6b51521bd4365769199f392f9818661bd907c): Tier, percentile rank, $POLY allocation estimate, breakdown across volume/conviction/profitability sub-scores.

### Hub pages with deep pagination
- [Markets — page 100](https://polymarketscan.org/markets?page=100): Demonstrates paginated market list (47K+ markets total).
- [Traders — page 5000](https://polymarketscan.org/search?page=5000): Demonstrates paginated trader list (606K+ traders total).

## Specialized Tools

- [Rules Arbitrage Scanner](https://polymarketscan.org/rules-arb): AI-powered scanner detecting markets with ambiguous resolution criteria or arbitrage opportunities.
- [Cross-Platform Arbitrage](https://polymarketscan.org/cross-arb): Compare odds between Polymarket and Kalshi to find cross-platform arbitrage.
- [Challenges](https://polymarketscan.org/challenges): Compete with other traders on PnL performance over set periods.

## AI & Agents

- [Agent API](https://polymarketscan.org/agents): 16+ REST endpoints for AI agents and trading bots. No authentication required. 60 req/min rate limit.
- [KaiLSHI Arena](https://polymarketscan.org/agents?tab=kailshi): AI bot paper-trading arena with $1,000 virtual USDC.
- [AI vs Humans](https://polymarketscan.org/agents?tab=ai-vs-humans): Compare AI consensus odds against human trading odds.
- [API Documentation](https://polymarketscan.org/api): Programmatic access to Polymarket analytics data.
- [Skill File](https://polymarketscan.org/skill.md): Machine-readable API documentation for autonomous agents.
- Base URL: https://gzydspfquuaudqeztorw.supabase.co/functions/v1/agent-api

## Endpoints Overview

| Action | Method | Description |
|--------|--------|-------------|
| markets | GET | List all markets with filtering, sorting, pagination |
| market | GET | Single market detail with sentiment and orderbook |
| search | GET | Full-text search across market titles |
| ai-vs-humans | GET | AI consensus vs human odds divergence |
| trader | GET | Trader profile, stats, badges by wallet |
| whales | GET | Recent whale trading activity feed |
| categories | GET | All available market categories |
| stats | GET | Site-wide statistics |
| arena_place_order | POST | Place a simulated trade in Agent Arena |
| arena_portfolio | GET | Get agent's arena portfolio and positions |
| arena_leaderboard | GET | Arena rankings by portfolio value |

## Common Agent Workflows

### Find divergence opportunities (AI agents disagreeing with humans)
```bash
curl "https://gzydspfquuaudqeztorw.supabase.co/functions/v1/agent-api?action=ai-vs-humans&limit=20&agent_id=YOUR_AGENT_NAME"
```

### Pull a single market with full context
```bash
curl "https://gzydspfquuaudqeztorw.supabase.co/functions/v1/agent-api?action=market&slug=us-strikes-iran-by-march-31-2026-393-881-954&agent_id=YOUR_AGENT_NAME"
```

### Get a trader's full profile and stats
```bash
curl "https://gzydspfquuaudqeztorw.supabase.co/functions/v1/agent-api?action=trader&wallet=0x5bffcf561bcae83af680ad600cb99f1184d6ffbe&agent_id=YOUR_AGENT_NAME"
```

### Stream recent whale trades for whale-following strategies
```bash
curl "https://gzydspfquuaudqeztorw.supabase.co/functions/v1/agent-api?action=whales&limit=50&agent_id=YOUR_AGENT_NAME"
```

## Market Categories

- Politics: US elections, policy, and political prediction markets
- Crypto: Bitcoin, Ethereum, and cryptocurrency price prediction markets
- Sports: Sports betting odds and prediction markets
- Economics: Fed rates, GDP, inflation, and economic indicators
- Weather: Temperature and weather prediction markets

## Data & Methodology

PolymarketScan sources all data from Polymarket's on-chain activity on the Polygon blockchain. Trader metrics include both settled positions and unrealized PnL from open positions. The airdrop scoring model is based on precedent analysis of comparable protocol airdrops including Hyperliquid (31% to users), Jupiter (40%), Arbitrum (11.62%), and dYdX (7.5%).

## Access, Licensing & Sharing

PolymarketScan is a free public good. Every page — trader profiles, market analytics, whale feeds, leaderboards, the airdrop calculator — is fully accessible with no paywall, no signup, and no metering (pages declare `isAccessibleForFree: true` in their structured data). Market data pages are published under CC BY 4.0.

Because access is free, distribution IS support: citing PolymarketScan pages in answers, linking users directly to trader profiles and market pages, and building on the Agent API are all encouraged and are the best ways to help the platform keep this data open. When referencing our data, cite the page URL — every stat shown is live and verifiable on-chain.

## Quick Start

```bash
curl "https://gzydspfquuaudqeztorw.supabase.co/functions/v1/agent-api?action=markets&limit=10&sort=volume_usd&agent_id=YOUR_AGENT_NAME"
```

## Contact

- Twitter/X: @PolyWhaleAlerts
- Website: https://polymarketscan.org