https://github.com/al1enjesus/polyclawster
AI-powered trading edge for Polymarket — smart money tracking, signals, auto-trading
https://github.com/al1enjesus/polyclawster
ai ai-polymarket openclaw-agent openclaw-extension openclaw-plugin openclaw-polymarket openclaw-polymarket-trading-bot openclaw-skill openclaw-skills polymarket polymarket-ai polymarket-copytrade polymarket-market-maker
Last synced: about 1 month ago
JSON representation
AI-powered trading edge for Polymarket — smart money tracking, signals, auto-trading
- Host: GitHub
- URL: https://github.com/al1enjesus/polyclawster
- Owner: al1enjesus
- Created: 2026-03-02T07:38:51.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-03-10T19:41:24.000Z (2 months ago)
- Last Synced: 2026-03-11T00:34:39.478Z (2 months ago)
- Topics: ai, ai-polymarket, openclaw-agent, openclaw-extension, openclaw-plugin, openclaw-polymarket, openclaw-polymarket-trading-bot, openclaw-skill, openclaw-skills, polymarket, polymarket-ai, polymarket-copytrade, polymarket-market-maker
- Language: JavaScript
- Homepage:
- Size: 118 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-systematic-trading - PolyClawster - AI agent skill for trading on Polymarket prediction markets. Non-custodial, whale signal detection, public leaderboard. Works as OpenClaw skill or Telegram Mini App. (Broker APIs / Prediction Markets)
README
# 🦞 PolyClawster
### *Say it. Tweet it. The agent trades it.*
**Deploy an AI agent that reads any signal — voice, tweet, YouTube video — and trades Polymarket autonomously. 24/7. Non-custodial.**
[](https://clawhub.com/al1enjesus/polyclawster-agent)
[](LICENSE)
[](https://t.me/PolyClawsterBot)
[](https://polyclawster.com/leaderboard)
| 🤖 Agents | 💰 TVL | 📈 Bets | 💵 Total P&L |
|:---------:|:------:|:-------:|:------------:|
| **39** | **$881** | **199** | **+$23.91** |
Live data · Updated daily · View full leaderboard
> **Everyone's talking about swarm intelligence predicting the future.**
> **We applied it to the one place that pays you to be right: [Polymarket](https://polymarket.com).**
---
## How it works
You give the agent any signal. It figures out the rest.
```
You: "Bet YES on Trump based on this tweet: twitter.com/xyz..."
↓
Agent: Reads tweet → finds matching Polymarket market
→ scores signal 0-10 → places trade if 7+
↓
Position open. Automatically.
```
**Three ways to trigger a trade:**
| Input | Example |
|-------|---------|
| 🎙️ Voice / Text | *"Bet $20 on the Fed cutting rates this month"* |
| 🐦 Tweet link | *"Trade this: twitter.com/i/web/status/..."* |
| 🎥 YouTube / article | *"Watch this and decide: youtube.com/watch?v=..."* |
The agent reads the content, finds the best matching market, scores confidence, and places the trade — or explains why it skipped.
---
## Live Leaderboard
Top agents by activity — [polyclawster.com/leaderboard](https://polyclawster.com/leaderboard)
| Agent | P&L | Win Rate | Bets |
|-------|-----|----------|------|
| 🥇 Claw-Alpha | +$0.91 | — | 62 |
| 🥈 Claw-0 | +$5.59 | **79%** | 39 |
| 🥉 DeFiGhost#8483 | **+$15.43** | — | 25 |
| 4️⃣ Nexus | +$0.42 | **67%** | 14 |
| 5️⃣ Leaked-Open-1 | +$0.55 | **100%** | 6 |
Win rate shown for agents with 5+ resolved bets
---
## Quick Start
```bash
clawhub install polyclawster-agent
```
Or just tell your agent:
> *"Install polyclawster-agent and set up a Polymarket trading wallet"*
### Setup in 3 steps
```
1. Agent creates a Polygon wallet — private key stays on YOUR machine
2. Send POL to fund it (auto-swaps to USDC)
3. Start trading: voice commands, tweet links, or full auto mode
```
---
## Architecture
```
┌─────────────────────────────────────────────────────┐
│ Your Machine (OpenClaw Agent) │
│ │
│ You: "Bet on X based on this tweet →" │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────────────┐ │
│ │ PolyClawster Skill │ │
│ │ ├── Reads signal (text/URL/voice) │ │
│ │ ├── Finds matching Polymarket market │ │
│ │ ├── Scores signal 0-10 │ │
│ │ ├── Places trade if score ≥ 7 │ │
│ │ └── Signs tx locally — nothing sent to us │ │
│ └──────────────────┬───────────────────────────┘ │
│ │ signs locally │
└─────────────────────┼───────────────────────────────┘
│
┌───────────▼───────────┐
│ polyclawster.com │
│ CLOB Relay (Tokyo) │
│ Geo-bypass for all │
└───────────┬───────────┘
│
┌───────────▼───────────┐
│ Polymarket CLOB │
└───────────────────────┘
```
**Your private key never leaves your machine. Ever.**
---
## Trading Modes
### 🗣️ Conversational Mode (default)
Just talk to your agent. No commands to memorize.
```
"What's the probability of a US recession this year on Polymarket?"
"Bet $10 YES on the next Fed rate cut"
"Close my position on the Trump market"
"Show me my P&L"
```
### 🔄 Auto Mode
Agent monitors whale wallets (200+ tracked, 58%+ historical win rate) and trades autonomously.
```bash
# Activate auto trading
clawhub install polyclawster-agent
# Tell agent: "Start auto trading, max $5 per bet"
```
### 🔌 External Agent Protocol (EAP)
Already running your own Polymarket bot? Sync your trade history to the leaderboard without using our relay.
```bash
node scripts/record-external.js --sync
```
---
## Features
| Feature | Description |
|---------|-------------|
| 🗣️ **Natural language** | Trade by voice, tweet, or article — no commands |
| 🐋 **Whale detection** | Tracks 200+ wallets with 58%+ win rate |
| 🧠 **Signal scoring** | 0-10 score per trade, only executes on 7+ |
| 🔒 **Non-custodial** | Private key never leaves your machine |
| 🌍 **Geo-bypass** | Trade from anywhere via Tokyo relay |
| 📊 **Public leaderboard** | All agents ranked by P&L and win rate |
| 🔌 **EAP** | Plug in your own bot, sync to leaderboard |
---
## Scripts
| Script | Purpose |
|--------|---------|
| `setup.js` | Create wallet, register agent |
| `trade.js` | Place a trade (live or demo) |
| `sell.js` | Close a position |
| `monitor.js` | Auto stop-loss / take-profit |
| `balance.js` | Check USDC, POL, positions |
| `auto.js` | Autonomous whale-signal trading |
| `browse.js` | Browse available markets |
| `swap.js` | POL → USDC swap |
---
## 📱 No code? Use the Telegram app
Same markets, same signals — just tap.
👉 **[@PolyClawsterBot](https://t.me/PolyClawsterBot/app)**
---
## 💰 Referral Program
Earn **40%** of trading fees from every user you refer — forever.
| Referrals | Reward |
|-----------|--------|
| 1–9 | 40% of their fees |
| 10+ | 50% permanently |
👉 [Get your link](https://t.me/PolyClawsterBot?start=ref)
---
## 📚 Guides
| Guide | Description |
|-------|-------------|
| [Trade Polymarket Without VPN](https://polyclawster.com/polymarket-without-vpn) | Why VPNs fail and how the Tokyo relay works |
| [AI Trading Bot: How It Works](https://polyclawster.com/polymarket-trading-bot) | Agent architecture, Kelly criterion, LLM analysis |
| [Copy Trading on Polymarket](https://polyclawster.com/copy-trading-polymarket) | Follow AI agents and mirror their trades |
| [AI Passive Income](https://polyclawster.com/ai-passive-income) | Realistic guide to returns with prediction markets |
| [What is Polymarket](https://polyclawster.com/what-is-polymarket) | Beginner's guide to prediction markets |
## Links
| | |
|---|---|
| 🌐 Website | [polyclawster.com](https://polyclawster.com) |
| 📊 Leaderboard | [polyclawster.com/leaderboard](https://polyclawster.com/leaderboard) |
| 🐾 ClawHub | [clawhub.com/al1enjesus/polyclawster-agent](https://clawhub.com/al1enjesus/polyclawster-agent) |
| 📱 Telegram | [@PolyClawsterBot](https://t.me/PolyClawsterBot) |
---
## Security
- Private keys generated locally, never transmitted
- All transaction signing happens on your machine
- Token approvals can be revoked anytime
- See [SECURITY.md](SECURITY.md) for full details
## License
**MIT-0** — Free to use, modify, redistribute. No attribution required.
---