📊 Polymarket Activity Tracker

Real-time Polymarket wallet monitor with Discord alerts for BUY & SELL trades.

What is this?

Polymarket Activity Tracker watches any wallet address on Polymarket and fires a Discord notification the moment a BUY or SELL trade is detected. Two independent threads run in parallel — one for buys, one for sells — so no trade ever slips through.

---

✨ Features

Feature	Details
🔴 Real-time monitoring	Polls Polymarket's public API every 30 seconds (configurable)
📣 Separate Discord channels	Dedicated webhooks for BUY and SELL notifications
🎨 Rich Discord embeds	Market name, position (Yes/No), size, price, USD value, and direct market link
🔒 Duplicate protection	In-memory deduplication via transaction hash + timestamp
🧵 Multi-threaded	BUY and SELL trackers run in fully independent threads

---

📸 Discord Notification Preview

🟢 New BUY Trade Detected

BUY Trade (BUY)
├── 👤 User         xFairyzz
├── 📊 Market       Will the Fed cut rates in July?
├── ✅ Position     Yes
├── 📈 Size         250.00 Shares
├── 💵 Price/Share  $0.72 (72.0%)
├── 💰 USD Spent    $180.00
├── 🕐 Time         2025-05-09 14:32:11
└── 🔗 Market Link  https://polymarket.com/event/...

---

🚀 Quick Start

1. Clone

git clone https://github.com/xFairyzz/Polymarket-Tracker.git
cd Polymarket-Tracker

2. Install dependencies

pip install requests colorama

3. How to get a Wallet Address

1. Go to "https://polymarket.com/de/leaderboard"
2. Click on a Profile
3. When you open the profile, you will see a button labeled "Copy Address" to the left of the "Gift" button.

4. Configure

Open config.py and fill in your values:

WALLET_ADDRESS          = "0xYourWalletAddressHere"
BUY_DISCORD_WEBHOOK_URL = "https://discord.com/api/webhooks/..."
SELL_DISCORD_WEBHOOK_URL= "https://discord.com/api/webhooks/..."

CHECK_INTERVAL = 30   # seconds between API polls

5. Run

python main.py

The tracker resolves the wallet's username automatically, starts both threads, and sends a startup notification to each Discord channel.

---

⚙️ Configuration Reference

Variable	Required	Default	Description
WALLET_ADDRESS	✅	—	Wallet to monitor
BUY_DISCORD_WEBHOOK_URL	✅	—	Webhook URL for BUY alerts
SELL_DISCORD_WEBHOOK_URL	✅	—	Webhook URL for SELL alerts

---

📁 Project Structure

Polymarket-Tracker/
├── main.py                  # Entry point — starts threads, handles shutdown
├── config.py                # All configuration variables
└── functions/
    ├── common.py            # API calls, username resolution, trade parsing
    ├── buy_tracker.py       # BUY detection
    └── sell_tracker.py      # SELL detection

---

🛠️ Tech Stack

• Python 3.8+
• requests — HTTP client for the Polymarket API and Discord webhooks
• colorama — Cross-platform colored terminal output
• threading — Standard library, parallel BUY/SELL loops
• Discord Webhooks — No bot token needed, zero infrastructure

---

⚠️ Disclaimer

• Uses Polymarket's public data API — no authentication required
• Please use a reasonable CHECK_INTERVAL to avoid hammering the API
• This project is not affiliated with or endorsed by Polymarket

---

📄 License

MIT License — free to use, modify, and distribute.

---

Made with ❤️ by xFairyzz / Juliaan