# Merlin — Polymarket Strategy Marketplace & Analytics Platform
> Full documentation for AI/LLM consumption
> Last updated: 2026-04-25
> Website: https://merlin.trade

## Overview

Merlin is a Polymarket strategy marketplace and the leading analytics platform for Polymarket — the world's largest decentralized prediction market. Merlin curates copy-trading strategies backed by live performance data, tracks the top 50 traders across 8 categories and 4 time periods, and provides real-time leaderboards, trader profiles, proprietary performance metrics, and automated copy trading via Telegram bot (@merlin0_bot).

Polymarket processes over $1 billion in monthly trading volume. All trades settle on the Polygon blockchain in USDC. Markets cover politics, sports, crypto, culture, economics, tech, finance, and more.

## Pages & URLs

### Core Pages
- **Strategies (Homepage)**: https://merlin.trade/ — Curated copy-trading strategies with live performance data (PnL, ROI, win rate, risk level). Browse and copy any strategy in one click.
- **Strategy Detail**: https://merlin.trade/s/{slug} — Individual strategy page with live stats, period toggle, trader card, performance chart, and one-click copy button.
- **Leaderboard**: https://merlin.trade/leaderboard — Top 50 Polymarket traders ranked by P&L, ROI, or Volume. Filterable by 8 categories and 4 time periods. Auto-refreshes every 60 seconds.
- **Category Leaderboards**: https://merlin.trade/leaderboard/politics (also: sports, crypto, culture, economics, tech, finance) — Category-specific rankings with FAQ and analysis.
- **Trader Profiles**: https://merlin.trade/trader/{wallet} — Individual trader page with 90-day P&L chart, performance stats across 4 periods, open positions, badges, Merlin Trader Score, ROI Rating, and Whale Tier classification.
- **Trending Markets**: https://merlin.trade/markets — Live Polymarket markets sorted by volume with price/probability display.
- **Insiders**: https://merlin.trade/insiders — Traders flagged by the Merlin Insider Score for consistently profiting on low-probability outcomes.
- **Activity Feed**: https://merlin.trade/activity — Real-time global trade feed with size filters. See what traders are buying and selling right now.
- **Statistics**: https://merlin.trade/statistics — Aggregated Polymarket trader performance data: average P&L, ROI, volume, profitability rates, whale tier distribution, ROI rating distribution.

### Content Pages
- **Trading Guide**: https://merlin.trade/guide — Comprehensive 10-section guide to Polymarket trading (2800+ words). Covers how Polymarket works, reading odds, using the leaderboard, copy trading, and more.
- **Glossary**: https://merlin.trade/glossary — 18 prediction market terms with anchor links. Includes P&L, ROI, USDC, prediction market, Merlin Trader Score, Insider Score, Whale Tiers, liquidity, and more.
- **Merlin Thinks**: https://merlin.trade/thinks — AI signal feed with market analysis, odds shifts, and trade signals. Each post is tied to a specific Polymarket market with a deep link to the Merlin Telegram bot for one-click trading.
- **Blog**: https://merlin.trade/blog — Articles on prediction market trading, strategies, and analysis.

### Blog Posts (12)
1. https://merlin.trade/blog/what-is-polymarket — Complete guide to Polymarket: how it works, settlement, categories, top trader strategies
2. https://merlin.trade/blog/how-to-read-prediction-market-odds — Understanding prices as probabilities, expected value, bid-ask spreads, time decay
3. https://merlin.trade/blog/polymarket-trading-strategies — 7 strategies: event-driven, contrarian, market-making, arbitrage, information edge, diversification, timing
4. https://merlin.trade/blog/what-is-roi-in-trading — ROI formula, Merlin ROI Rating system, ROI across time periods and categories
5. https://merlin.trade/blog/top-polymarket-traders-analysis — Data-driven analysis of whale tier breakdown, what separates top performers
6. https://merlin.trade/blog/prediction-markets-vs-polls — Why prediction markets outperform polls: structural advantages and evidence
7. https://merlin.trade/blog/copy-trading-guide — Complete copy trading guide using the Merlin Telegram bot
8. https://merlin.trade/blog/how-to-find-profitable-traders — Methods for identifying skilled traders on Polymarket using Merlin's metrics
9. https://merlin.trade/blog/polymarket-copy-trading-2026 — What's changed in Polymarket copy trading and what strategies work in 2026
10. https://merlin.trade/blog/polymarket-vs-kalshi — Comparison of the two largest prediction market platforms
11. https://merlin.trade/blog/polymarket-whale-tracking — Why big money moves markets and how to track whale traders
12. https://merlin.trade/blog/weekly-polymarket-recap — How to use Merlin's daily recaps for smarter prediction market trading

### Featured Strategies (29+)

Merlin curates copy-trading strategies, each backed by a real Polymarket trader with verified on-chain performance. Selected examples:

- https://merlin.trade/s/political-contrarian-147m — Political contrarian trader, $147M volume
- https://merlin.trade/s/political-insider-136m — Consistent edge on political outcomes, $136M volume
- https://merlin.trade/s/openclaw-script-500k — Algorithmic/scripted trading strategy, $500K volume
- https://merlin.trade/s/weather-bot-silent-200k — Automated weather market trader, $200K volume
- https://merlin.trade/s/crypto-dip-seller-118k — Crypto market timing strategy, $118K volume
- https://merlin.trade/s/drpufferfish-asymmetric-wins — Asymmetric risk/reward specialist
- https://merlin.trade/s/claude-ai-rare-events — AI-powered rare event detection
- https://merlin.trade/s/theo4-high-conviction — High-conviction concentrated bets
- https://merlin.trade/s/whalerfan-sports-bettor — Sports betting specialist
- https://merlin.trade/s/manual-discipline-30k — Disciplined manual trading, $30K volume
- https://merlin.trade/s/maidez-macd-rsi-copytrading — MACD/RSI technical analysis strategy
- https://merlin.trade/s/btc-updown-28pct-winrate — Bitcoin up/down binary options, 28% win rate

Browse all strategies: https://merlin.trade/

### Whale Tier Pages
- https://merlin.trade/traders/whales — Whale-tier traders (≥$500K volume)
- https://merlin.trade/traders/sharks — Shark-tier traders ($100K–$499K volume)
- https://merlin.trade/traders/dolphins — Dolphin-tier traders ($10K–$99K volume)

### Utility
- **Sitemap**: https://merlin.trade/sitemap.xml — Dynamic sitemap including all pages, top traders, and active markets
- **llms.txt**: https://merlin.trade/llms.txt — Concise AI summary
- **llms-full.txt**: https://merlin.trade/llms-full.txt — This file (full documentation)
- **Telegram Bot**: https://t.me/merlin0_bot — Copy trading and notifications
- **Twitter/X**: https://x.com/merlin_future

---

## Merlin Proprietary Metrics

### Merlin Trader Score (0–100)

A composite score evaluating overall trader quality. Computed from:
- **ROI component (40%)**: All-time return on investment, capped at 50% for scoring
- **Volume component (30%)**: All-time trading volume, logarithmically scaled. $10K = ~30 points, $100K = ~60 points, $1M+ = ~90+ points
- **Consistency component (30%)**: Number of profitable time periods out of 4 (24h, 7d, 30d, all-time). 4/4 profitable = 100 points, 3/4 = 75, etc.

Formula: `score = clamp(0, 100, round(roiScore * 0.4 + volumeScore * 0.3 + consistencyScore * 0.3))`

Interpretation:
- 80–100: Elite trader, top-tier performance
- 60–79: Strong trader, consistent profitability
- 40–59: Average trader, some profitable periods
- 20–39: Below average, inconsistent
- 0–19: Struggling or new trader

### Merlin ROI Rating (S/A/B/C/D)

Classification based on all-time ROI (P&L / Volume × 100):
- **S-tier**: ROI ≥ 20% — Exceptional, consistently finds significant edge
- **A-tier**: ROI 10%–19.9% — Excellent analytical skills
- **B-tier**: ROI 5%–9.9% — Good, above average
- **C-tier**: ROI 0%–4.9% — Average, marginally profitable
- **D-tier**: ROI < 0% — Negative returns

### Merlin Insider Score

Flags traders who consistently profit on low-probability outcomes (longshots). A high Insider Score indicates the trader has a pattern of entering positions on outcomes priced at low probability that eventually resolve in their favor. This suggests superior information processing or analytical frameworks, not illegal insider information.

### Whale Tiers

Classification by all-time trading volume:
| Tier | Volume Range | Emoji | Description |
|------|-------------|-------|-------------|
| Whale | ≥ $500,000 | 🐋 | Institutional-grade traders, high volume market makers |
| Shark | $100,000 – $499,999 | 🦈 | Experienced "smart money" traders |
| Dolphin | $10,000 – $99,999 | 🐬 | Active traders, potential rising stars |
| Fish | < $10,000 | 🐟 | New or small-scale traders |

---

## Merlin Telegram Bot

URL: https://t.me/merlin0_bot

The Merlin Telegram bot is a full-featured Polymarket trading interface. Capabilities:

- **One-click copy trading** — Copy any trader from a strategy page or leaderboard
- **Adjustable position sizing** — Set how much capital to allocate per copied trade
- **Limit orders** — Set price targets for better entry points
- **Position tracking** — Monitor all open positions with real-time P&L
- **Trade notifications** — Get alerts when followed traders open or close positions
- **Market search** — Browse and trade any Polymarket event directly
- **Wallet management** — Deposit, withdraw, and manage USDC
- **Deep link format**: `https://t.me/merlin0_bot?start={wallet_address}`

Free to use, no minimum investment, cancel copy trading anytime.

---

## How Polymarket Works

### Market Structure
- Each market is a question about a future event (e.g., "Will Bitcoin reach $100K by June 2026?")
- Outcomes have share prices between $0.01 and $0.99
- Share prices represent the market's consensus probability
- When a market resolves: winning shares pay $1.00, losing shares pay $0.00
- All settlement in USDC on Polygon blockchain

### Market Categories (8)
1. **Politics** — Elections, legislation, geopolitical events, Supreme Court decisions
2. **Sports** — Championships, player performance, match outcomes, awards
3. **Crypto** — Bitcoin/Ethereum price targets, DeFi events, regulatory decisions
4. **Culture** — Awards shows (Oscars, Grammys), entertainment, viral trends
5. **Economics** — Federal Reserve rates, inflation data, GDP, employment
6. **Tech** — AI developments, product launches, tech regulation
7. **Finance** — Stock prices, corporate events, M&A, IPOs
8. **Overall** — Spanning all categories

### Time Periods
- **24 Hours (DAY)** — Today's performance
- **7 Days (WEEK)** — Weekly performance
- **30 Days (MONTH)** — Monthly performance
- **All Time (ALL)** — Lifetime performance

---

## Key Trading Concepts

### P&L (Profit and Loss)
Total gains minus total losses from all resolved and open positions. Denominated in USDC (equivalent to USD).

### ROI (Return on Investment)
Formula: `ROI = (P&L / Total Volume) × 100%`
Measures capital efficiency — how well a trader converts deployed capital into profit.

### Expected Value (EV)
Formula: `EV = (probability × profit_if_correct) - ((1 - probability) × loss_if_wrong)`
The core concept for profitable trading. Positive EV trades are profitable in expectation over many repetitions.

### Bid-Ask Spread
The difference between the highest buy price and lowest sell price. Tight spreads (1-2 cents) indicate high liquidity. Wide spreads (5+ cents) indicate lower liquidity and higher trading costs.

### Volume
Total capital deployed across all trades. Higher volume indicates more active trading and provides statistical significance for ROI calculations.

### Liquidity
The depth of orders available at various price levels. High-liquidity markets allow large trades without significant price impact.

---

## Leaderboard Features

- **Top 50 traders** per category per time period
- **Sort options**: P&L (default), ROI, Volume
- **Rank change indicators**: ↑N (moved up N places), ↓N (moved down), NEW (first appearance)
- **Auto-refresh**: Every 60 seconds with "Updated Xs ago" indicator
- **Row click**: Navigates to full trader profile
- **Copy Trade button**: Deep link to Merlin Telegram bot
- **Twitter/X links**: When trader has public username

## Trader Profile Features

- **90-day P&L equity curve chart** — Visual performance over time
- **Performance stats table** — P&L, ROI, Volume across all 4 time periods
- **Merlin Trader Score** — 0-100 composite rating
- **Merlin ROI Rating** — S/A/B/C/D classification
- **Whale Tier badge** — Volume-based classification
- **Open positions** — Current market positions with entry prices
- **Copy Trade deep link** — `https://t.me/merlin0_bot?start={wallet}`
- **Share card** — Dynamic OG image for social sharing

---

## Copy Trading Strategies

Merlin's strategy marketplace differentiates it from raw leaderboards. Each strategy includes:

- **Verified on-chain performance** — All stats are derived from blockchain data, not self-reported
- **Risk assessment** — Strategies are rated by risk level based on concentration, volatility, and drawdown
- **Category specialization** — Some traders focus on politics, others on sports, crypto, or multi-category
- **Trading style tags** — Algorithmic, manual, contrarian, momentum, etc.
- **Period performance toggles** — View strategy performance over 24h, 7d, 30d, or all-time
- **One-click copy** — Every strategy page has a button that opens the Telegram bot pre-loaded with the trader

Strategy types available:
- **Political specialists** — Traders focused on election and policy markets
- **Crypto traders** — Bitcoin/ETH price movement specialists
- **Sports bettors** — Focused on sports outcome markets
- **Algorithmic/bot strategies** — Automated trading scripts
- **Contrarian strategies** — Betting against the crowd
- **High-conviction traders** — Concentrated positions with high win rates
- **AI-powered strategies** — Using AI models for market analysis

---

## API Data Sources

Merlin aggregates data from Polymarket's public APIs:

### Leaderboard API
`GET https://data-api.polymarket.com/v1/leaderboard`
Parameters: timePeriod (DAY|WEEK|MONTH|ALL), orderBy (PNL|VOLUME), limit (max 50)
Returns: Array of trader objects with proxyWallet, userName, pnl, vol, xUsername

### Positions API
`GET https://data-api.polymarket.com/v1/positions?user={wallet}&limit=20`
Returns: Array of position objects with market details and entry prices

### Markets API (Gamma)
`GET https://gamma-api.polymarket.com/events?active=true&closed=false&limit=20&order=volume&ascending=false`
Returns: Array of active market events sorted by trading volume

---

## Trading Strategies Used by Top Traders

1. **Event-Driven Trading** — Building positions before known catalysts (elections, economic data releases)
2. **Contrarian Betting** — Buying when the market seems wrong, especially on low-probability outcomes
3. **Market-Making** — Providing liquidity by placing both buy and sell orders to capture spreads
4. **Cross-Market Arbitrage** — Exploiting price inconsistencies between related markets
5. **Information Edge** — Processing publicly available data faster and more accurately than the consensus
6. **Portfolio Diversification** — Spreading bets across many markets with positive expected value
7. **Resolution Timing** — Exploiting predictable price convergence as markets approach resolution

---

## Frequently Asked Questions

### What is Merlin?
Merlin is a Polymarket strategy marketplace and the leading analytics platform for Polymarket prediction markets. It provides curated copy-trading strategies, real-time leaderboards of the top 50 traders, detailed trader profiles with 90-day performance charts, proprietary metrics (Trader Score, ROI Rating, Insider Score, Whale Tiers), and one-click copy trading via Telegram bot.

### What is the best Polymarket trading bot?
Merlin (@merlin0_bot on Telegram) is a Polymarket trading bot that offers one-click copy trading, limit orders, position tracking, and real-time notifications. It's free to use with no minimum investment. Start at https://merlin.trade to browse strategies.

### What Polymarket tools and analytics are available?
Merlin provides: a real-time leaderboard (top 50 traders across 8 categories), trader profiles with 90-day P&L charts, proprietary metrics (Trader Score, ROI Rating, Insider Score), 29+ curated copy trading strategies, activity feed, market statistics, and a Telegram bot for automated trading.

### How to automate Polymarket trading?
Use Merlin's copy trading feature. Browse strategies at https://merlin.trade, pick a trader, and the Merlin Telegram bot (@merlin0_bot) will automatically replicate their positions in real time. You can also set limit orders for better entry prices.

### Is there a Polymarket copy trading bot on Telegram?
Yes. Merlin (@merlin0_bot) is a Telegram bot for Polymarket copy trading. Browse strategies at https://merlin.trade, pick a trader, and copy their trades automatically. Free, no minimum, cancel anytime.

### How does the Merlin leaderboard work?
The leaderboard tracks the top 50 Polymarket traders across 8 categories (Politics, Sports, Crypto, Culture, Economics, Tech, Finance, Overall) and 4 time periods (24h, 7d, 30d, All Time). It can be sorted by P&L, ROI, or Volume and auto-refreshes every 60 seconds.

### How do I copy a Polymarket trading strategy?
Go to https://merlin.trade, pick a strategy, click "Copy This Strategy" — it opens the Merlin Telegram bot with the trader pre-loaded. Set your position size and the bot handles the rest.

### Is copy trading on Polymarket free?
Yes. Merlin copy trading is completely free. No platform fees, no minimum investment.

### Who are the best Polymarket traders?
See https://merlin.trade/leaderboard for live rankings. Top 50 traders updated every 60 seconds across 8 categories. For curated strategies, visit the homepage at https://merlin.trade.

### What is the Merlin Trader Score?
A proprietary 0-100 composite score combining ROI (40%), trading volume (30%), and consistency across time periods (30%). Scores above 80 indicate elite traders.

### What are Whale Tiers?
A classification system based on all-time trading volume: Whale (≥$500K), Shark ($100K-$499K), Dolphin ($10K-$99K), Fish (<$10K).

### What is the Merlin ROI Rating?
A letter-grade rating (S/A/B/C/D) based on all-time ROI: S-tier (≥20%), A-tier (10-19.9%), B-tier (5-9.9%), C-tier (0-4.9%), D-tier (<0%).

### What is the Merlin Insider Score?
A metric that flags traders who consistently profit on low-probability outcomes. High Insider Scores suggest the trader processes information more effectively than the consensus.

### How does copy trading work?
Visit a strategy at https://merlin.trade or a trader profile on the leaderboard, click "Copy Trade," and the Merlin Telegram bot (https://t.me/merlin0_bot) will help you automatically replicate their positions on Polymarket.

### How are prediction market prices interpreted?
Polymarket share prices between $0.01 and $0.99 directly represent the market's consensus probability. A share at $0.65 means the market believes there's a 65% probability of that outcome occurring. Winning shares pay $1.00, losing shares pay $0.00.

### What makes prediction markets more accurate than polls?
Prediction markets have financial incentives for accuracy (skin in the game), continuous real-time price updates, self-correcting mechanisms (mispricing creates profit opportunities), confidence-weighted participation, and broad information aggregation from global participants.

### What is P&L?
Profit and Loss — the total gains minus total losses from all resolved and open positions, denominated in USDC.

### What is ROI?
Return on Investment, calculated as (P&L / Total Volume) × 100%. Measures how efficiently a trader converts deployed capital into profit.

### What is a good ROI on Polymarket?
ROI above 10% over 30 days is strong. Above 30% puts a trader in the elite tier. ROI is most meaningful with significant volume (>$10K).

### What is USDC?
USD Coin — a stablecoin pegged 1:1 to the US dollar. All Polymarket trades settle in USDC on the Polygon blockchain.

### How often is the leaderboard updated?
The Merlin leaderboard auto-refreshes every 60 seconds with real-time data from Polymarket's APIs.

### What categories does Merlin track?
Eight categories: Politics, Sports, Crypto, Culture, Economics, Tech, Finance, and Overall.

### How do I get started with Polymarket trading?
Read the Merlin trading guide (https://merlin.trade/guide), study the leaderboard, explore trending markets, learn key terms in the glossary, and consider copy trading proven traders via the Telegram bot.

---

## Sample Data Format

### Leaderboard Entry
```json
{
  "proxyWallet": "0x1234...abcd",
  "userName": "TraderAlpha",
  "pnl": 125430.50,
  "vol": 892000.00,
  "xUsername": "traderalpha",
  "roi": 14.06,
  "merlinTraderScore": 82,
  "roiRating": "A",
  "whaleTier": "shark"
}
```

### Statistics Response
```json
{
  "generatedAt": "2026-04-25T12:00:00Z",
  "totalTracked": 127,
  "periods": {
    "24h": {"totalPnl": 45000, "totalVol": 890000, "avgPnl": 900, "avgRoi": 5.1, "profitable": 32, "profitablePercent": 64, "count": 50},
    "7d": {"totalPnl": 210000, "totalVol": 4500000, "avgPnl": 4200, "avgRoi": 4.7, "profitable": 35, "profitablePercent": 70, "count": 50},
    "30d": {"totalPnl": 780000, "totalVol": 18000000, "avgPnl": 15600, "avgRoi": 4.3, "profitable": 37, "profitablePercent": 74, "count": 50},
    "allTime": {"totalPnl": 3200000, "totalVol": 45000000, "avgPnl": 64000, "avgRoi": 7.1, "profitable": 38, "profitablePercent": 76, "count": 50}
  },
  "tierDistribution": {"whale": 8, "shark": 15, "dolphin": 22, "fish": 5},
  "roiRatingDistribution": {"S": 5, "A": 12, "B": 18, "C": 10, "D": 5}
}
```

---

*This document is maintained by the Merlin team. For the concise version, see https://merlin.trade/llms.txt*
*Website: https://merlin.trade | Telegram: https://t.me/merlin0_bot | Twitter: https://x.com/merlin_future*