PolymarketScan API — Free Polymarket Data API for Developers and AI Agents

PolymarketScan API — Free Polymarket Data

Free REST API for Polymarket on-chain data. Access wallet profiles, PnL, trade history, market data, leaderboards, whale trades, and alerts. 30 req/min. Used by 160+ developers with 526,111+ requests served.

API Overview

Base URL

https://gzydspfquuaudqeztorw.supabase.co/functions/v1/public-api

Rate Limit

30 requests per minute

Format

REST / JSON

Developers

160+

Requests Served

526,111+

Cost

Free

Quick Start

Pass your API key via x-api-key header or api_key query parameter.

GET https://gzydspfquuaudqeztorw.supabase.co/functions/v1/public-api?endpoint=markets&limit=10&api_key=YOUR_KEY

Data Endpoints

Wallet Profile

Get trading stats for a wallet: PnL, volume, win rate, best trade.

GET ?endpoint=wallet_profile&address=0x1234...abcd&api_key=YOUR_KEY

Wallet Trades

Get paginated trade history for a specific wallet. Supports limit (max 500) and offset.

GET ?endpoint=wallet_trades&address=0x1234...abcd&limit=50&api_key=YOUR_KEY

Wallet PnL

Get PnL summary and daily timeseries for a wallet.

GET ?endpoint=wallet_pnl&address=0x1234...abcd&api_key=YOUR_KEY

Markets List

Get active Polymarket markets sorted by 24h volume. Supports pagination and category filter.

GET ?endpoint=markets&limit=10&category=crypto&api_key=YOUR_KEY

Market Data

Get detailed data for a specific market by slug or market_id.

GET ?endpoint=market_data&slug=will-bitcoin-hit-100k&api_key=YOUR_KEY

Leaderboard

Get top Polymarket traders ranked by total PnL. Supports limit (max 100).

GET ?endpoint=leaderboard&limit=25&api_key=YOUR_KEY

Whale Trades

Recent large trades over $1,000 across all Polymarket markets.

GET ?endpoint=whale_trades&limit=10&api_key=YOUR_KEY

Market Whale Trades

Whale trades for a specific market with aggregate stats: volume, buy/sell split, unique wallets.

GET ?endpoint=market_whales&market_slug=will-bitcoin-hit-100k&min_size=5000&limit=20&api_key=YOUR_KEY

Deposits and Withdrawals

Fetch all USDC deposit and withdrawal transactions for a Polymarket wallet on Polygon.

GET ?endpoint=deposits&address=0x1234...abcd&api_key=YOUR_KEY

GET ?endpoint=withdrawals&address=0x1234...abcd&api_key=YOUR_KEY

Alerts API

Create price, liquidity, time, and whale alerts. Requires an API key with a linked wallet address.

Price Alerts

Alert when a market outcome price crosses a threshold (above or below).

POST ?endpoint=alerts_create_price&token_id=123&outcome=Yes&above_threshold=0.8&api_key=YOUR_KEY

Liquidity Alerts

Alert based on fill simulation — triggers when a trade of given size can fill at target price.

POST ?endpoint=alerts_create_liquidity&token_id=123&outcome=Yes&side=BUY&size_shares=500&api_key=YOUR_KEY

Time Alerts

Alert before a market closes/expires.

POST ?endpoint=alerts_create_time&market_end_date=2026-04-01T00:00:00Z&alert_before_minutes=30&api_key=YOUR_KEY

Whale Trade Alerts

Alert when any wallet (or a specific wallet) makes a trade above a USD threshold.

POST ?endpoint=whale_alerts_create_trade&min_size_usd=10000&target_wallet=0x1234...abcd&api_key=YOUR_KEY

Whale Deposit Alerts

Alert on large USDC deposits or withdrawals for a tracked wallet.

POST ?endpoint=whale_alerts_create_deposit&target_wallet=0x1234...abcd&min_amount_usd=50000&api_key=YOUR_KEY

Response Format

All responses return JSON with ok, data, and response_time_ms fields. Errors return an error string and rate limit info. Example success response:

{"ok":true,"data":{...},"response_time_ms":142}

MCP Server

PolymarketScan also provides an MCP (Model Context Protocol) server for AI agent integration, allowing AI agents to directly query Polymarket data via structured tool calls.