You have open positions across multiple wallets. One resolved yesterday. You haven't claimed it. Polymarket Resolution Tracker monitors every open position, alerts before each resolution deadline, and optionally claims payouts automatically.
Last updated: March 2026
Polymarket Resolution Tracker is a resolution monitoring and payout management tool for Polymarket. It loads all open positions across one or more wallets, tracks resolution deadlines in real time, and sends Telegram alerts at 24 hours and 6 hours before each resolution. When a market resolves, the tracker detects the outcome and optionally claims your payout automatically.
Unclaimed winning positions on Polymarket expire after 30 days. Positions resolving while you are not watching go unnoticed. Resolution Tracker solves both problems.
| Platform | Architecture | Download |
|---|---|---|
| Windows | x64 | Download the latest release |
Most Polymarket traders accumulate positions across multiple markets and sometimes multiple wallets. Without a tracker:
| Problem | Cost |
|---|---|
| Market resolves while you are offline | Payout unclaimed until you notice |
| Approaching resolution date missed | No exit strategy executed before deadline |
| Wrong side of a resolved market held | Capital locked longer than needed |
| Multi-wallet positions uncoordinated | One wallet's resolution goes unnoticed |
Resolution Tracker eliminates all four problems with a single always-on monitoring process.
| Item | How Often | Alert Trigger |
|---|---|---|
| Open positions | Every Polygon block | Position detected as resolved |
| Resolution countdown | Every 15 minutes | 24 hours before deadline |
| Resolution countdown | Every 15 minutes | 6 hours before deadline |
| Payout availability | Every Polygon block | Payout claimable after resolution |
| Expired unclaimed payouts | Daily | Any unclaimed payout older than 7 days |
- Multi-wallet support - monitor any number of Polymarket wallets simultaneously from a single instance
- Full position scan - loads all open ERC-1155 positions from Polygon on-chain data, no Polymarket account login required
- Resolution countdown - tracks time to resolution for every open market and fires alerts at configurable intervals
- Auto-claim - automatically claims winning payouts when a market resolves in your favour
- Exit reminder - sends an alert when a market you hold is approaching resolution so you can exit before deadline if needed
- Telegram alerts - instant notifications for resolution events, countdown warnings, and payout claims
- Dashboard view - live table of all open positions with market name, your side, current odds, days to resolution, and unrealised P&L
- History log - complete record of every resolved position, claim transaction, and final P&L
| Windows App | Python Bot | |
|---|---|---|
| Setup | Double-click | pip install + config |
| Dashboard | Built-in GUI | Terminal table |
| Auto-claim | Config toggle | Configurable |
| Multi-wallet | Config list | Config list |
| Alerts | Dashboard + Telegram | JSON + Telegram |
# 1. Download from Releases
# 2. Edit config.toml - add wallet addresses and Telegram token
# 3. Run Resolution Tracker - position scan and countdown monitoring starts immediately
cd polymarket-resolution-tracker/python
pip install -r requirements.txt
python polymarket-resolution-tracker-v.1.1.0.py
Three continuous loops running in parallel:
Position scan loop (every Polygon block):
- Scan - reads all ERC-1155 token balances for each configured wallet on Polygon
- Match - maps each token to its Polymarket market via the CLOB market index
- Update - refreshes position status (open, resolved, claimable) and current odds
Countdown loop (every 15 minutes):
- Check - evaluates time remaining to resolution for every open position
- Alert - sends Telegram notification when any position crosses 24h or 6h threshold
Claim loop (every Polygon block, if auto-claim enabled):
- Detect - identifies positions where the held side has resolved as the winner
- Claim - submits the redemption transaction automatically
- Log - records the claim transaction, payout amount, and final P&L
[wallets]
addresses = [
"0x...", # primary wallet
"0x..." # secondary wallet
]
[alerts]
telegram_bot_token = ""
telegram_chat_id = ""
countdown_hours = [24, 6] # alert at these hours before resolution
alert_on_resolution = true
alert_on_claim = true
alert_unclaimed_after_days = 7
[execution]
auto_claim = false # set true to claim payouts automatically
private_key_env = "WALLET_KEY" # env var holding private key (auto-claim only)
[rpc]
provider = "" # Alchemy, Chainstack, or Infura endpoint{
"position_id": "pos_0x4f2a...#YES",
"market_id": "0x4f2a...",
"market_name": "Will Congress pass the budget bill before April 2026?",
"category": "politics",
"wallet": "0x...",
"outcome_held": "YES",
"contracts": 3420,
"entry_price_avg": 0.29,
"current_odds": 0.61,
"unrealised_pnl_usdc": 108.72,
"resolution_date": "2026-04-01T00:00:00Z",
"hours_to_resolution": 187.4,
"status": "open",
"alerts_sent": ["24h"]
}Configuration used:
- 2 wallets monitored, auto-claim enabled, 24h + 6h alerts
- Primary wallet:
0x3c7a9f1b5e2d4c8a0f3b7e9d1c5a7f2b4e8d0c6a
Countdown alert sent, auto-claim executed:
| Event | Transaction | Block |
|---|---|---|
| Auto-claim | 0x2d4f6a... | #70,731,558 |
Resolution details:
- Alert sent: 23h 47min before resolution
- Market resolved YES at block #70,731,001
- Auto-claim submitted 41 seconds after resolution detected
- Payout: 3,420 tokens at 1.00 USDC = 3,420.00 USDC
- Net P&L on position: +2,427.80 USDC (234% ROI)
What is Polymarket Resolution Tracker? Polymarket Resolution Tracker monitors all open positions across configured wallets, sends Telegram alerts before resolution deadlines, and optionally claims winning payouts automatically when markets resolve.
How does it find my open positions? The tracker reads your ERC-1155 token balances directly from Polygon. Every Polymarket position is an ERC-1155 token in your wallet. No Polymarket account login is required - only your wallet address for read-only monitoring.
Do I need to share my private key? Only if you enable auto-claim. In monitor-only mode, the tracker reads your wallet's on-chain state and sends alerts without any signing capability. For auto-claim, the private key is read from an environment variable, never stored in plain text in config files.
What happens if I miss a resolution? If auto-claim is disabled and you miss a resolution, the payout sits unclaimed in your position. Polymarket allows claims for 30 days after resolution. The tracker will continue alerting you about unclaimed payouts until you claim them.
Can I monitor multiple wallets?
Yes. Add any number of wallet addresses to the addresses list in config. Each is scanned independently on every Polygon block.
Can I disable specific alert types? Yes. Each alert type (countdown, resolution, claim, unclaimed expiry) can be toggled independently in config.
Does it work on Linux? Yes. The Python version runs on any platform with Python 3.10+. The Windows .exe is Windows-only.
- Multi-wallet management - track all open positions across multiple Polymarket wallets from a single dashboard
- Resolution deadline alerts - never miss a resolution or leave a position open without an exit plan
- Auto-claim payouts - collect winnings automatically without checking Polymarket manually
- Expiry protection - receive alerts before any unclaimed payout approaches the 30-day expiry window
- P&L tracking - maintain a complete history of every resolved position with final P&L per trade
- Pre-resolution exit reminders - get an alert 6 hours before resolution to decide whether to exit early
polymarket-resolution-tracker/
+-- polymarket-resolution-tracker-v.1.1.0.exe
+-- config.toml
+-- data/
| +-- positions/
| +-- claims/
| +-- logs/
| +-- dll/
+-- python/
| +-- src/
| | +-- scanner.py
| | +-- countdown.py
| | +-- claimer.py
| | +-- alerts.py
| +-- requirements.txt
+-- README.md
python-dotenv, typer[all], web3, httpx, websockets, devtools
- Polymarket wallet address(es) for read-only monitoring
- Telegram bot token for alerts
- RPC provider - Alchemy, Chainstack, or Infura (free tier sufficient)
- Private key only required for auto-claim mode
Track. Alert. Claim.
