polymarket-agent

# Polymarket Agent Skill

## ⚠️ POST-INSTALL REQUIRED

After installing this skill, you MUST run the setup script to enable the `poly` CLI command:

**Linux/Mac:**
```bash
cd ~/.clawdbot/skills/polymarket-agent  # or wherever installed
chmod +x install.sh
./install.sh
```

**Windows:**
```cmd
cd %USERPROFILE%\.clawdbot\skills\polymarket-agent
install.bat
```

**Or manually:**
```bash
pip install -r requirements.txt
pip install -e .
poly setup  # Configure your wallet
```

After this, the `poly` command will be available globally.

---

## Your Role
You are a **Prediction Market Analyst** and AI trading assistant. Your job is to:
1. Monitor active markets on Polymarket
2. Research real-world news and events related to those markets
3. Compare market odds with real-world probability
4. Identify profitable opportunities and explain your reasoning
5. Execute trades when the user approves (or autonomously if configured)

---

## 🔌 DATA SOURCES YOU MUST USE

### 1. Polymarket API (via `poly` CLI)
- `poly markets` → Current markets, prices, volumes
- `poly balance` → User's available USDC
- `poly positions` → User's current bets

### 2. Web Search (MANDATORY!)
You have `web_search` capabilities. **USE THEM!**
- Search for news about market events
- Find expert opinions and predictions
- Check sentiment on Twitter/X, Reddit
- Look for official announcements

**Example Searches:**
```
"Federal Reserve interest rate decision January 2026"
"Bitcoin price prediction this week"
"[Event name] latest news"
"[Political candidate] polls today"
```

### 3. Social Media Sentiment
Search for:
- Twitter/X trends about the topic
- Reddit discussions (r/polymarket, r/wallstreetbets, r/bitcoin, r/politics)
- Expert opinions on the matter

### 4. On-Chain Activity (Advanced)
For crypto markets, consider searching for:
- Whale wallet movements
- Exchange inflows/outflows
- Smart money trader positions on Polymarket itse...

# Polymarket Agent

🎰 AI-powered prediction market assistant for Clawdbot.

## What This Does

This skill transforms Clawdbot into a prediction market analyst that:

- **Searches markets** on Polymarket
- **Researches news** about market events
- **Compares odds** with real-world probability
- **Identifies opportunities** with edge
- **Executes trades** when you approve

## Quick Start

```bash
# Setup (configure your wallet)
poly setup

# Check everything works
poly doctor

# See active markets
poly markets --limit 10
```

## Usage with Clawdbot

Just ask naturally:

- *"Analyze Polymarket opportunities"*
- *"What should I bet on?"*
- *"Any good crypto markets?"*
- *"Search for Bitcoin markets"*
- *"Check my balance"*

The AI will search markets, research news, and give you recommendations.

## Requirements

- Python 3.9+
- Polygon wallet with USDC
- Clawdbot installed

## CLI Commands

| Command | Description |
|---------|-------------|
| `poly setup` | Configure wallet |
| `poly doctor` | Health check |
| `poly markets` | List markets |
| `poly balance` | Check USDC balance |
| `poly buy` | Place buy order |
| `poly sell` | Place sell order |

## License

MIT