gavindiaz/polymarket-whale-watcher
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add demo examples: terminal output, analysis report, daily briefing

Browse Source 
Three realistic example files in docs/examples/ showcasing the system's
output format. README updated with collapsible demo sections.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
SII-leiyu
2026-04-18 17:05:13 +08:00
parent 4a380a6769
commit 88a5309bd9
4 changed files with 304 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+76
View File
@@ -2,6 +2,82 @@
AI-powered whale trade surveillance and analysis system for Polymarket prediction markets. Combines real-time monitoring, multi-dimensional anomaly detection, LLM-driven investigation with 14 autonomous tools, and signal accuracy tracking.
## Demo
<details>
<summary><b>Terminal Output</b> — Real-time whale detection and LLM analysis</summary>
```
╭──────────────────────────────────────────────────────────╮
│ 🐋 Polymarket Whale Watcher │
│ │
│ Markets Monitored: 50 │
│ Polling Interval: 15s │
│ Min Trade Size: $1,000 │
│ Price Range: 0 - 0.7 │
╰──────────────────────────────────────────────────────────╯
[14:22:51] 🐋 WHALE DETECTED on "Will MegaETH launch a token by June 30, 2026?"
BUY Yes @ 0.4200 | $92,336 USDC | Wallet: 0x7a3b...f91e
Anomaly Score: 0.78/1.00
[14:22:53] 🤖 LLM Analysis started (model: gemini-3-flash-preview)
→ Tool call: search_web("MegaETH token launch date 2026")
→ Tool call: search_twitter("MegaETH $METH token TGE")
→ Tool call: get_protocol_tvl("megaeth")
→ Tool call: get_contract_info("0x4f9b...2a1c")
→ Tool call: search_telegram("MegaETH launch")
[14:23:07] ✅ Analysis complete
Information Asymmetry Score: 0.72 (HIGH)
Recommendation: BUY Yes | Confidence: 0.75
Report saved: reports/20260415/...
[15:00:00] 📊 Resolution check: 3 markets resolved
→ "EdgeX FDV above 400M" resolved YES — Signal CORRECT (ROI: +142%)
→ "Will Trump talk to Rutte" resolved NO — Signal INCORRECT
→ "Over 9M committed to P2P" resolved YES — Signal CORRECT (ROI: +67%)
```
See full example: [docs/examples/sample_terminal.txt](docs/examples/sample_terminal.txt)
</details>
<details>
<summary><b>Analysis Report</b> — LLM investigation with tool-use</summary>
Each whale trade generates a detailed markdown report:
- **Trade details** — amount, direction, price, trader wallet
- **Trader profile** — rank, PnL, history, recent trades
- **LLM investigation** — 5 autonomous tool calls (web, Twitter, Telegram, on-chain, DeFi)
- **Information asymmetry assessment** — score, evidence, reasoning
Example findings:
> *"New ERC-20 contract deployed by MegaETH deployer wallet 6 hours before trade — not yet publicly announced. KOL tweets about insider knowledge preceded the trade by ~3 hours."*
>
> **Information Asymmetry Score: 0.72** | Trader Credibility: HIGH
See full example: [docs/examples/sample_report.md](docs/examples/sample_report.md)
</details>
<details>
<summary><b>Daily Briefing</b> — Automated intelligence summary</summary>
Daily briefings include:
- High-confidence signals with analysis
- Price volatility alerts
- Historical signal performance (win rate, ROI by confidence tier)
Example stats:
| Metric | Value |
|--------|-------|
| Win Rate | **63.5%** |
| Avg ROI | **+28.3%** |
| Signals with IAS >= 60% | 3 today |
See full example: [docs/examples/sample_briefing.md](docs/examples/sample_briefing.md)
</details>
## Features
- **Real-Time Monitoring** — Parallel per-market polling of 50+ trending markets
docs/examples/sample_briefing.md
+84
View File
@@ -0,0 +1,84 @@
# Daily Signal Briefing - 2026-04-15
Generated at: 2026-04-16 10:00:03
## Today's Overview
- High-confidence information asymmetry signals: **3** (confidence >= 60%)
- Abnormal price volatility events: **2**
---
## High-Confidence Information Asymmetry Signals
### 1. Will MegaETH launch a token by June 30, 2026?
| Metric | Value |
|--------|-------|
| Info Asymmetry | **72%** |
| Direction | BUY Yes Token (Bullish) |
| Entry Price | 0.4200 (Odds 2.4x) |
| Trade Size | **$92,336** USDC |
| Detected At | 2026-04-15 14:23:07 |
**Analysis**: High-ranked trader (#47, PnL $284K) making concentrated bets. Unannounced smart contract deployed by MegaETH team 6 hours prior. KOL insider chatter on Twitter preceded the trade.
**Insider Evidence**: New ERC-20 contract deployed by MegaETH deployer wallet, not yet publicly announced.
### 2. US forces enter Iran by April 30
| Metric | Value |
|--------|-------|
| Info Asymmetry | **65%** |
| Direction | BUY Yes Token (Bullish) |
| Entry Price | 0.3100 (Odds 3.2x) |
| Trade Size | **$46,500** USDC |
| Detected At | 2026-04-15 09:21:53 |
**Analysis**: Top-50 trader with $500K+ PnL placing aggressive bets. Multiple high-ranked traders converging on the same direction. Trade occurred hours before Pentagon press briefing.
### 3. Will the next Prime Minister of Hungary be Viktor Orban?
| Metric | Value |
|--------|-------|
| Info Asymmetry | **61%** |
| Direction | BUY No Token (Bearish) |
| Entry Price | 0.2800 (Odds 3.6x) |
| Trade Size | **$65,699** USDC |
| Detected At | 2026-04-15 16:31:22 |
**Analysis**: Verified trader with strong European politics track record betting against Orban. Telegram channels discussing potential coalition shift not yet covered by mainstream media.
---
## Abnormal Price Volatility
| Market | Direction | Change | Start Price | End Price | Detected At |
|--------|-----------|--------|-------------|-----------|-------------|
| EdgeX FDV above 500M one day... | Up | 35.2% | 22.00% | 57.20% | 2026-04-15 03:41 |
| Iran leadership change by Dec... | Up | 22.8% | 31.00% | 53.80% | 2026-04-15 11:15 |
---
## Signal History
| Metric | Value |
|--------|-------|
| Total Signals | 847 |
| Resolved | 312 |
| Correct | 198 |
| Win Rate | **63.5%** |
| Avg ROI | **+28.3%** |
| Theoretical Total PnL | **+42.71x** |
### Performance by Confidence Tier
| Confidence Range | Signals | Resolved | Win Rate | Avg ROI |
|-----------------|---------|----------|----------|---------|
| 0.8 - 1.0 | 23 | 15 | 80.0% | +52.1% |
| 0.6 - 0.8 | 89 | 47 | 68.1% | +35.7% |
| 0.4 - 0.6 | 284 | 132 | 59.1% | +18.4% |
---
*This briefing was automatically generated by Polymarket Whale Watcher*
docs/examples/sample_report.md
+90
View File
@@ -0,0 +1,90 @@
# Whale Trade Analysis Report
**Market**: Will MegaETH launch a token by June 30, 2026?
**Generated**: 2026-04-15 14:23:07 UTC
---
## Whale Trade Anomaly Detection Report
### Trade Details
- **Trade amount**: $92,336.00 USDC
- **Trade direction**: BUY Yes Token (Bullish)
- **Buy price**: 0.4200 (~2.4x odds)
- **Trade time**: 2026-04-15 14:22:41 UTC
- **Trader wallet**: 0x7a3b...f91e
### Anomaly Score
- **Overall score**: 0.78/1.00
- **Score breakdown**:
Absolute size: 0.85 | Relative to market: 0.72 | Price uncertainty: 0.68 | Time of day: 0.45 | Trader deviation: 0.91 | Cluster signal: 0.30
### Trade Interpretation
- **Direction**: Trader bought Yes Token @ 0.4200 — Bullish (believes event will occur)
### Trader Ranking (PnL Leaderboard)
- **Rank**: #47 (Period: all-time)
- **Cumulative PnL**: $284,521.00
- **Volume**: $1,892,340.00
- **Username**: Anonymous
- **Verification**: Unverified
### Trader History
- **Recent Trades**: 156
- **Recent Volume**: $743,210.00 USDC
- **Avg Trade Size**: $4,764.17 USDC
- **Large Trades** (>=$5000): 42
- **Active Markets**: MegaETH token launch, EdgeX FDV, Billions FDV, US forces enter Iran, Hungary PM
**Recent Large Trade Details**:
1. BUY $23,015.00 @ 0.3800 - MegaETH market cap FDV 1B one day...
2. BUY $15,000.00 @ 0.4100 - MegaETH market cap FDV 600M one d...
3. BUY $8,200.00 @ 0.5500 - EdgeX FDV above 500M one day after...
---
## LLM Investigation
### Tools Used
1. **search_web** — "MegaETH token launch date 2026"
2. **search_twitter** — "MegaETH $METH token TGE"
3. **get_protocol_tvl** — "megaeth"
4. **get_contract_info** — "0x4f9b...2a1c" (MegaETH deployer)
5. **search_telegram** — "MegaETH launch"
### Key Findings
**Web Search**: No official token launch announcement found. MegaETH blog (April 12) mentions "testnet phase 3 completion" but no TGE timeline.
**Twitter**: Multiple crypto KOLs discussing potential token launch. @cryptoinsider (42K followers) posted 3 hours ago: "Hearing MegaETH team is finalizing tokenomics. Could be sooner than people think." — This post preceded the whale trade.
**On-Chain**: MegaETH deployer wallet (0x4f9b...2a1c) deployed a new ERC-20 contract 6 hours ago. Contract is verified but not yet publicly linked to any token.
**Telegram**: WuBlockchain channel shared a rumor about "major L2 token launch in Q2" without naming the project. Multiple replies speculating it's MegaETH.
**TVL**: MegaETH TVL = $847M (+12% 7d), indicating growing ecosystem activity.
---
## Information Asymmetry Assessment
| Metric | Value |
|--------|-------|
| **Information Asymmetry Score** | **0.72** |
| **Trader Credibility** | HIGH |
| **Confidence** | 0.75 |
| **Recommended Action** | BUY Yes |
### Evidence
- High-ranked trader (#47) with strong PnL ($284K) making concentrated bets on MegaETH-related markets
- New smart contract deployed by MegaETH team 6 hours before trade — not yet public knowledge
- KOL tweets about insider knowledge preceded the trade by ~3 hours
- Trader's recent history shows 3 consecutive large buys on MegaETH markets at increasing prices (0.38 → 0.41 → 0.42)
### Reasoning
The combination of a newly deployed (unannounced) smart contract, insider KOL chatter, and a high-ranked trader's aggressive accumulation pattern strongly suggests the trader has information about an imminent token launch. The information asymmetry score of 0.72 reflects multiple converging signals, though we cannot confirm the contract is the actual token contract.
---
*Disclaimer: This analysis is for research purposes only and does not constitute investment advice.*
docs/examples/sample_terminal.txt
+54
View File
@@ -0,0 +1,54 @@
$ python -m src.main run
╭──────────────────────────────────────────────────────────╮
│ 🐋 Polymarket Whale Watcher │
│ │
│ Markets Monitored: 50 │
│ Polling Interval: 15s │
│ Min Trade Size: $1,000 │
│ Price Range: 0 - 0.7 │
╰──────────────────────────────────────────────────────────╯
[14:22:41] 🔄 Refreshing trending markets... Found 50 active markets
[14:22:43] 👀 Monitoring: Will MegaETH launch a token by June 30, 2026?
[14:22:43] 👀 Monitoring: US forces enter Iran by April 30
[14:22:43] 👀 Monitoring: Will the next Prime Minister of Hungary be Viktor Orban?
... (47 more markets)
[14:22:51] 🐋 WHALE DETECTED on "Will MegaETH launch a token by June 30, 2026?"
BUY Yes @ 0.4200 | $92,336 USDC | Wallet: 0x7a3b...f91e
Anomaly Score: 0.78/1.00
[14:22:52] 🔍 Analyzing whale trade...
→ Fetching trader ranking... Rank #47 (PnL: $284,521)
→ Fetching trader history... 156 recent trades
→ Fetching event positions... 3 related markets
→ Fetching market top traders... 5 bulls, 5 bears
[14:22:53] 🤖 LLM Analysis started (model: gemini-3-flash-preview)
→ Tool call: search_web("MegaETH token launch date 2026")
→ Tool call: search_twitter("MegaETH $METH token TGE")
→ Tool call: get_protocol_tvl("megaeth")
→ Tool call: get_contract_info("0x4f9b...2a1c")
→ Tool call: search_telegram("MegaETH launch")
[14:23:07] ✅ Analysis complete
Information Asymmetry Score: 0.72 (HIGH)
Recommendation: BUY Yes | Confidence: 0.75
Report saved: reports/20260415/20260415_142307_BUY_92336USD_MegaETH_token.md
[14:23:07] 📧 Email alert sent (IAS >= 60%)
[14:23:15] 🐋 WHALE DETECTED on "US forces enter Iran by April 30"
BUY Yes @ 0.3100 | $46,500 USDC | Wallet: 0x2c8e...a4d2
Anomaly Score: 0.71/1.00
[14:23:16] 🔍 Analyzing whale trade...
...
[14:37:41] 🔄 Refreshing trending markets... Found 48 active markets (2 resolved)
[15:00:00] 📊 Resolution check: 3 markets resolved since last check
→ "EdgeX FDV above 400M" resolved YES — Signal was CORRECT (ROI: +142%)
→ "Will Trump talk to Rutte" resolved NO — Signal was INCORRECT
→ "Over 9M committed to P2P" resolved YES — Signal was CORRECT (ROI: +67%)