Pull trading activity from Polymarket for any user
Pull trading activity from Polymarket's Data API for any user by username or wallet address.
# Analyze gabagool22's last 7 days of trading
python scripts/polymarket-user-activity.py gabagool22 --analyze
# Save to CSV
python scripts/polymarket-user-activity.py gabagool22 --days 7 --output data/gabagool22-trades.csv
# Save as JSON
python scripts/polymarket-user-activity.py gabagool22 --days 7 --output data/gabagool22-trades.json
# Use wallet address directly
python scripts/polymarket-user-activity.py 0x6031b6eed1c97e853c6e0f03ad3ce3529351f96d --analyze
| Option | Description | Default |
|---|---|---|
user |
Username (e.g. gabagool22) or wallet address (0x...) | Required |
--days N |
Number of days of history to fetch | 7 |
--limit N |
Maximum number of trades to fetch | 10000 |
--output PATH |
Output file (CSV or JSON based on extension) | None |
--analyze |
Print analysis summary | False |
--json |
Output raw JSON to stdout | False |
| Field | Description |
|---|---|
| datetime | ISO timestamp |
| timestamp | Unix timestamp |
| side | BUY or SELL |
| outcome | Up or Down |
| title | Market question |
| size | Number of shares |
| price | Price per share |
| value | size * price |
| slug | Market URL slug |
| eventSlug | Event identifier |
| conditionId | Market condition hash |
| transactionHash | On-chain tx hash |
| proxyWallet | Trader wallet |
The --analyze flag prints:
============================================================
TRADE ANALYSIS SUMMARY
============================================================
Total trades: 847
- BUY: 623
- SELL: 224
Total volume: $42,350.00
Date range: 2024-12-08 09:15 to 2024-12-15 14:30
(7 days)
Outcome breakdown:
- UP positions: 412
- DOWN positions: 435
Price stats:
- Average: $0.485
- Min: $0.08
- Max: $0.92
Top 5 markets by trade count:
- Bitcoin up or down? (Dec 15, 2:00 PM ET)... (45 trades, $1,250.00)
- Ethereum up or down? (Dec 15, 10:00 AM ET)... (38 trades, $980.00)
...
============================================================
Uses the Polymarket Data API:
https://data-api.polymarket.com/trades?user={wallet}&limit={n}&offset={n}To analyze a trader's strategy:
Pull their recent trades:
python scripts/polymarket-user-activity.py gabagool22 --days 7 --output data/trades.csv
Look for patterns:
Compare to market conditions: