A real-time position monitor for Polymarket that features automated profit reinvestment and risk-management circuit breakers.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install polymarket-portfolio-tracker-v2
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install polymarket-portfolio-tracker-v2 using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Polymarket Portfolio Tracker?
The Polymarket Portfolio Tracker is a sophisticated monitoring tool designed for active prediction market participants. As part of the Openclaw Skills ecosystem, it bridges the gap between manual trading and automated portfolio management by fetching live position data directly from the Polymarket Data API. It provides developers and traders with a robust framework to monitor wins, losses, and significant price fluctuations without constant manual checking.
Beyond simple tracking, this skill acts as a financial guardian for your prediction market activities. It incorporates a smart circuit breaker to halt trading during high-volatility loss events and manages automated capital deployment. By integrating seamlessly with Telegram, it ensures you are always informed of resolved positions and ROI progress through a silent heartbeat mechanism that only alerts you when meaningful events occur.
Polymarket Portfolio Tracker Use Cases
- Monitoring open prediction market positions for real-time P&L and ROI tracking.
- Automating capital recycling by reinvesting cash balances into new markets when specific thresholds are met.
- Protecting portfolios from catastrophic drawdowns using a built-in daily loss circuit breaker.
- Receiving instant Telegram notifications for resolved bets and significant 20%+ price movements.
How Polymarket Portfolio Tracker Works
- The script initializes by fetching all open and recently resolved positions via the Polymarket Data API.
- It compares current snapshots against the .monitor_state.json file to detect new WIN/LOSS outcomes.
- P&L is calculated for resolved positions, and price volatility is checked for active ones.
- The daily loss tracker updates .daily_pnl.json; if losses exceed 15%, the circuit breaker is engaged to pause reinvestment.
- If the cash balance exceeds $40, it triggers external reinvestment scripts to deploy capital into high-conviction plays.
- A summarized report is dispatched via Telegram, highlighting portfolio health and progress toward a financial goal.
Polymarket Portfolio Tracker Setup
First, ensure you have the required Python environment and libraries installed:
pip install requests polymarket-clob-client
Configure your environment variables or edit the constants in monitor.py to connect your wallet:
export PRIVATE_KEY=your_polygon_private_key
export WALLET_ADDRESS=0xYourPolymarketWallet
export TELEGRAM_BOT_TOKEN=your_bot_token
export TELEGRAM_CHAT_ID=your_chat_id
To run the tracker as a recurring job every 30 minutes, add the following to your crontab:
*/30 * * * * cd /path/to/scripts && python3 monitor.py >> logs/monitor.log 2>&1
Polymarket Portfolio Tracker Data Schema & Taxonomy
The skill manages its state and risk metrics through local JSON structures to ensure persistence across runs:
| File | Purpose |
|---|---|
.monitor_state.json |
Stores position snapshots, historical outcomes, and cumulative P&L metrics. |
.daily_pnl.json |
Tracks intraday performance to calculate circuit breaker triggers. |
logs/monitor.log |
Standard output and error logs for debugging and audit trails. |
Polymarket Portfolio Tracker Advanced Features
- Intelligent Circuit Breaker: Automatically pauses all reinvestment activity if daily losses cross the 15% threshold, resetting at midnight UTC.
- Multi-Script Integration: Designed to trigger secondary Openclaw Skills like weather_scanner.py and exit_manager.py for complex cross-market strategies.
- Dynamic Goal Tracking: Visualizes progress toward a custom financial target with ROI and wagered-capital metrics.
- Silent Heartbeat: Minimizes notification fatigue by suppressing alerts unless a position resolves, a price move is detected, or reinvestment occurs.
SKILL.md
Loading
Related Openclaw Skills
Workamajig
Seamlessly manage project data, financial records, and agency workflows using Openclaw Skills integrated with Workamajig.
Editorial Card Screenshot
A professional design skill that converts raw information into sophisticated, Swiss-international style HTML cards and captures them as high-resolution screenshots.
GitHub Rising Stars
A powerful analytical tool that identifies high-velocity GitHub repositories by calculating growth rates before they reach the official trending charts.
Integrations Page Generator
A specialized framework for building and optimizing high-converting integration, plugin, and extension marketplaces for SaaS and developer products.
Variflight Global Flight Fares
A specialized skill for querying the Variflight API to retrieve one-way flight schedules, pricing, and transfer details using IATA codes.
Cognitive Compaction State Manager
An active monitoring system that prevents AI context overflow by executing memory compaction and semantic state summarization.
Featured*
