# PolyAlertHub: Complete Platform Documentation

> The premier AI-powered analytics platform for Polymarket, the world's largest prediction market. Real-time alerts, whale tracking, fresh wallet detection, and comprehensive trading intelligence.

- **Domain:** https://www.polyalerthub.com
- **API Contact:** api@polyalerthub.com
- **Discord:** https://discord.com/invite/paWVAqmy3z

---

## Platform Overview

PolyAlertHub is an AI-powered analytics platform for Polymarket that provides real-time data, intelligent alerts, and trading insights. The platform helps traders track "Whales" (high-volume traders), identify potential fresh wallet activity, monitor market movements, and practice trading strategies without risking real capital.

### Core Value Propositions

- **Make Better Decisions in Less Time:** Polymarket moves fast. Too many markets, too much data, not enough clarity. Our analytics and alert platform helps you research smarter with AI-powered insights and real-time data visualization.
- **Real-Time Intelligence:** WebSocket-powered live feeds for immediate market updates
- **Customizable Alerts:** Configurable notifications across market, price, whale, trader, and fresh wallet signals
- **Risk-Free Practice:** Paper trading with $10,000 virtual balance on real market data

---

## Plans & Pricing

Visit https://www.polyalerthub.com/plans for current pricing.

### Free Tier

**Price:** $0/month

**Features:**
- 3 Active Alerts Total (shared quota across New Market, Whale, Trader & Price Alerts)
- Repeating Price Alert Triggers (fixed 60-minute cooldown)
- Custom Whale Alert Filters
- 30 Top Traders Leaderboard
- Basic Market Insights
- Basic Trader Insights
- Basic Whale Trade & Position Analytics (3 trades, 10 positions)
- Basic Support

**Limitations:**
- Price Performance Tables: 100 items (Volume Surge, Top Gainers/Losers, Price Volatility), 50 items (Reversal Candidates)

### Pro Tier

**Price:** $14.99/month or $99.99/year (save ~44%)

**Features:**
- Unlimited Market Alerts
- Unlimited Active Price Alerts
- Unlimited Trader Alerts
- Unlimited Simple & Custom Whale Alerts
- Unlimited Real-Time Market Insights
- Unlimited Real-Time Trader Insights
- Unlimited Real-Time Fresh Wallet Alerts
- Full Whale Trade & Position Analytics
- 3000+ Top Traders Leaderboard
- Real-Time Alerts
- Priority Support
- Early Access to New Features
- Join Referral Program

### Elite Tier

**Price:** $99.99 (includes everything in Pro)

**Additional Features:**
- Full API access with authentication
- Access whale trade data programmatically
- Get fresh wallet trading alerts via API
- Retrieve top trader insights & metrics
- Market analytics and data endpoints
- Build custom integrations and tools
- API key management dashboard

---

## Core Features

### Trading Terminal

#### Trading Terminal (Flagship)
Professional-grade Polymarket trading terminal that unifies execution, analytics, and signals in one workspace.

- Live order book and depth visualization powered by Polymarket CLOB WebSocket feeds
- Real-time price and trade history charts per outcome
- One-click order entry with limit and market order support
- Open orders panel with single and batch cancel (cancel-all and cancel-selected)
- Live positions panel with real-time PnL updates
- Personal trade history with live updates from user channel
- Multi-view tabbed workspaces — up to 20 saved workspaces, each holding up to 8 market cards running simultaneously
- Per-card independent WebSocket / order book state (no cross-card collisions)
- Right-side overlay for focused-card order entry, positions, orders, and trades
- Workspace state persisted per user in Firestore
- Deep-linkable per-event terminal pages with canonical event + market query params

**URLs:**
- https://www.polyalerthub.com/terminal
- https://www.polyalerthub.com/terminal/{event-slug}

---

### Trading & Practice

#### Paper Trading
Practice trading on Polymarket with virtual money. Test strategies and learn prediction markets risk-free.

- Trade on live Polymarket markets with $10,000 virtual balance
- Real-time order book and market data
- Full trading interface with limit and market orders
- Track your P&L and position performance
- View your complete trading history
- Test strategies without risking real money
- Perfect for beginners and strategy testing
- No-account guest preview available at /try-paper-trading
- Per-event paper trading at /paper-trading/{event-slug}

**URL:** https://www.polyalerthub.com/paper-trading

#### Portfolio Analysis
Comprehensive P&L tracking and portfolio analytics.

- Real-time profit & loss tracking
- Daily P&L change visualization
- Performance metrics and statistics
- Position history and trends
- Risk-adjusted returns analysis
- Calendar heatmaps of trading activity

#### Trader Insights
Analyze trader performance and strategies.

- Win rate and profitability analysis
- Investment allocation patterns
- Position size distribution
- Entry/exit price efficiency
- Hourly trading activity patterns
- Category-specific performance metrics

---

### Alerts & Monitoring

#### Price Alerts
Get notified when markets reach your target prices.

- Custom price threshold notifications
- Above/below target price alerts
- Percentage change alerts
- Multiple price targets per market
- Outcome-specific price tracking
- Instant notifications via email or Telegram

**Free Limit:** Counts toward shared 3-alert quota (across New Market, Whale, Trader & Price Alerts); repeating triggers with fixed 60-minute cooldown
**Pro Limit:** 500 active alerts (with custom cooldown options)

**URL:** https://www.polyalerthub.com/price-alert

---

#### Price Movement Alerts
Detect rapid price movements across markets and get notified when a market experiences a large directional move in a short window. Useful for spotting volatility spikes and sudden market shifts.

- Preset and custom alerts (percentage + time window)
- Direction filter: Any, Up, or Down
- Scope filter: all markets, categories, exclude categories, portfolio, or trading wallet
- Advanced plan unlocks all scopes; trading-wallet scope is available without Advanced
- Notes: very short or specific windows (1 minute, 5 minutes, 15 minutes, 4 hours) are not monitored; markets with average volume below 1000 are not tracked to reduce noise and improve signal reliability

**URL:** https://www.polyalerthub.com/price-movement-alert

#### Volume Change Alerts
Detect rapid changes in market activity and get notified when volume spikes or drops sharply in a selected window.

- Preset and custom alerts (percentage + time window)
- Direction filter: Any, Up, or Down
- Scope filter: all markets, categories, exclude categories, portfolio, or trading wallet
- Advanced plan unlocks all scopes; trading-wallet scope is available without Advanced

**URL:** https://www.polyalerthub.com/volume-change-alert

#### Market Alerts
Stay informed about important market lifecycle events.

- New market creation notifications
- Market closing/end date reminders
- Market resolution alerts
- Category-specific filtering
- Custom notification timing
- Bulk market monitoring

**Free Limit:** Counts toward shared 3-alert quota (across New Market, Whale, Trader & Price Alerts)
**Pro Limit:** Unlimited

**URL:** https://www.polyalerthub.com/market-alert

#### Trader Alerts
Track specific traders and get notified of their every move.

- Position entry notifications
- Position exit alerts
- Position sizing adjustment tracking
- Customizable price and share size thresholds
- Multi-trader monitoring
- Real-time activity feed

**Free Limit:** Counts toward shared 3-alert quota (across New Market, Whale, Trader & Price Alerts)
**Pro Limit:** Unlimited

**URL:** https://www.polyalerthub.com/trader-alert

#### Whale Alerts
Never miss big moves from market influencers.

- High-volume trade notifications
- Configurable volume thresholds
- Market-specific or category-based filtering
- Price range and share quantity parameters
- Instant whale activity detection

**Free Limit:** Counts toward shared 3-alert quota (Simple or Custom; across New Market, Whale, Trader & Price Alerts)
**Pro Limit:** Unlimited simple & custom alerts (also includes Whale Consensus & Unusual Activity alerts)

**URL:** https://www.polyalerthub.com/whale-alert

#### Fresh Wallet Alerts
Get real-time notifications when potential fresh wallet activity is detected.

- Instant alerts for suspected fresh wallet trades
- Confidence score-based notifications
- Early signal detection for positioning opportunities
- Market-specific fresh wallet activity monitoring
- Coordinated trading pattern alerts
- Custom sensitivity thresholds

**Free Limit:** 0 (Pro only)
**Pro Limit:** Unlimited

**URL:** https://www.polyalerthub.com/insider-alert

---

### Analytics & Intelligence

#### Market Explorer
Explore all active Polymarket markets with comprehensive analytics.

- Scan disputed markets and bond markets
- Price performance tracking
- Volume surge detection
- Top gainers and losers
- Price volatility analysis
- Reversal candidates identification

**URL:** https://www.polyalerthub.com/markets

#### Polymarket Analytics
Comprehensive analytics and insights for prediction market traders.

- Detailed performance metrics
- Profit and loss tracking
- Position analysis
- Trading intelligence
- Market trend visualization

**URL:** https://www.polyalerthub.com/features/polymarket-analytics

#### Leaderboard
Rankings of top performing traders on Polymarket.

- Performance rankings by PnL
- Volume-based rankings
- ROI leaderboards
- Portfolio insights
- Historical performance data

**Free:** Top 30 traders
**Pro:** 3000+ traders

**URL:** https://www.polyalerthub.com/features/polymarket-leaderboard

#### Top Traders
Profiles and metrics of the most successful traders.

- Historical performance analysis
- Trading strategy insights
- Notable trades
- Follow and track capabilities

**URL:** https://www.polyalerthub.com/features/trader-leaderboards

#### Trader Comparison
Compare up to 5 Polymarket traders side by side on a single screen.

- PnL performance comparison (realized, unrealized, total)
- Volume and trading activity metrics
- Risk-adjusted return metrics
- Investment pattern and position sizing analysis
- Entry and exit price efficiency
- Leaderboard and series rankings
- Top categories and series per trader

**URL:** https://www.polyalerthub.com/traders/compare

#### Trader Profile
Dedicated per-trader profile page with full analytics.

- Position list and trade history
- PnL curve over time
- Win rate and average return per trade
- Category and series performance breakdown

**URL:** https://www.polyalerthub.com/traders/{wallet-or-username}

#### Categories
Directory of market segments for easy navigation.

- Politics
- Crypto
- Sports
- Finance
- Entertainment
- And more...

**URLs:**
- https://www.polyalerthub.com/categories
- https://www.polyalerthub.com/categories/{category-slug}

#### Market Explorer (Markets)
Real-time explorer with advanced filtering and saved views.

- Events, Markets, and Watch List tabs
- Optional built-in tabs (Volume Surge, Top Gainers/Losers, Price Volatility, Reversal Candidates, Disputed, Bonded)
- Custom saved filter views as additional tabs, persisted per user in Firestore (users/{uid}.marketExplorerPreferences)
- Token-level filters (price, spread) on the markets view
- Per-market detail pages at /markets/{event-or-market-slug}

**URL:** https://www.polyalerthub.com/markets

---

### Whale Tracking

#### Whales Tracker Dashboard
Dedicated view of the largest wallets active on Polymarket.

- Real-time insights into large traders
- Position monitoring
- Market-moving signal detection
- Big money flow tracking

**URL:** https://www.polyalerthub.com/features/polymarket-wallet-tracker

#### Whale Trades Analytics
Deep insights into whale trading patterns and smart money flow.

- Analyze whale trading activity and patterns
- Leaderboard tracking and performance rankings
- Trader specializations in specific markets or outcomes
- Convergence analysis and consensus tracking
- Liquidity concentration metrics
- Unusual activity detection and alerts
- Position clustering and coordination patterns

**URL:** https://www.polyalerthub.com/whale-trades

#### Whale Positions
Track major whale positions, capital allocation, and high-conviction markets.

- Track major whale positions across all markets
- Follow top traders' capital allocation
- Position size and entry price tracking
- Whale portfolio composition analysis
- Capital flow visualization
- Position change tracking over time
- Smart money concentration heatmaps

**Investment Size Filters:**
- Mega Whales: $100K+ positions
- Super Whales: $500K+ positions
- Ultra Whales: $1M+ positions
- Big Positions: 10K+ shares

**Performance Filters:**
- Profitable positions (positive realized PnL)
- 70%+ win rate traders
- Positive average profit per trade

**URL:** https://www.polyalerthub.com/whale-positions

#### Whales Live Feed
Real-time ticker showing buying and selling activity from high-net-worth wallets.

- Live feed of major trades
- Large order tracking
- Market-moving activity in real-time
- WebSocket-powered instant updates

**URL:** https://www.polyalerthub.com/whales-live-feed

#### Traders Live Feed
Real-time stream of trader entries, exits, and position changes.

- Watch trades as they happen
- Track entries and exits
- Follow market sentiment evolution
- Spot new opportunities faster

**URL:** https://www.polyalerthub.com/traders-live-feed

---

### Fresh Wallet Detection

PolyAlertHub uses algorithmic detection to identify suspicious trading patterns and potential fresh wallet activity.

#### How Fresh Wallet Detection Works

Fresh wallet positions are scored using 8 weighted signals (each 0-10 scale):

1. **New Wallet Signal:** Flags recently created wallets with unusual activity
2. **High Concentration Signal:** Detects when a user's portfolio is unusually concentrated in one market
3. **Extreme Odds Signal:** Identifies positions taken at extreme price levels
4. **Large Position Signal:** Flags abnormally large position sizes
5. **Low Diversification Signal:** Detects traders with minimal market diversification
6. **Timing Pattern Signal:** Identifies suspicious trade timing patterns
7. **Volume Anomaly Signal:** Detects unusual volume relative to market activity
8. **Price Movement Signal:** Correlates trades with subsequent price movements

#### Fresh Wallet Score & Risk Levels

- **Fresh Wallet Score:** 0-100 (weighted sum of all signals)
- **Confidence:** 0-100 confidence in detection accuracy

**Risk Levels:**
- `VERY_HIGH`: Highest probability of fresh-wallet trading
- `HIGH`: Strong indicators of unusual activity
- `MEDIUM`: Moderate suspicious patterns
- `LOW`: Minimal suspicious indicators

#### Metrics Tracked

- Wallet age in days
- Market concentration percentage
- Trade concentration percentage
- Position concentration percentage
- User's market volume vs total market volume
- Total trades and unique markets
- Open positions count and value

**URL:** https://www.polyalerthub.com/insiders

---

## Developer API

PolyAlertHub provides a REST API for developers building trading bots, analysis tools, or custom integrations.

**Documentation:** https://www.polyalerthub.com/features/polymarket-api
**Base URL:** https://api.polyalerthub.com
**Version:** 1.0.0

### Authentication

Use your API key with the Authorization header:

```
Authorization: Bearer poly_your_api_key_here
```

API keys are available for users on the Elite plan. All Elite API endpoints are prefixed with `/elite/`.

### Rate Limiting

| Tier | Limit | Window | Endpoints |
|------|-------|--------|-----------|
| Default | 50 req | 60s | Most read endpoints |
| Heavy | 50 req | 60s | Complex queries, leaderboards |
| Write | 50 req | 60s | POST/PUT/DELETE operations |

Rate limit headers included in responses:
- `X-RateLimit-Limit`: Maximum requests allowed
- `X-RateLimit-Remaining`: Remaining requests in window
- `X-RateLimit-Reset`: Unix timestamp when window resets

### Error Handling

All errors follow a consistent format:

```json
{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable message",
    "details": {},
    "requestId": "unique-request-id"
  }
}
```

### API Endpoints

#### System

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/health` | Health check |

#### Market Data

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/elite/getTagsAndTraders` | Get tags and popular traders |
| GET | `/elite/getTagSeriesList` | Get tag and series list |

#### Market Analytics

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/elite/getMarketInsights` | Get polymarket event insights |

#### Traders

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/elite/getTraderStats` | Get trader statistics |
| GET | `/elite/getTopTraders` | Get top traders |
| GET | `/elite/getLeaderboardTraders` | Get leaderboard by category |

#### Whales

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/elite/getWhalePositionsLeaderboard` | Get whale positions analytics |
| GET | `/elite/getWhaleTradesAnalytics` | Get whale trades analytics |
| GET | `/elite/getWhaleTrades` | Get recent whale trades |
| GET | `/elite/getWhaleConsensusSignals` | Get whale consensus signals |
| GET | `/elite/getWhaleUnusualActivity` | Get whale unusual activity |
| GET | `/elite/getWhaleConvergence` | Get whale convergence |

#### Fresh Wallets

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/elite/getInsiderAnalytics` | Get fresh wallet analytics dashboard |
| GET | `/elite/getInsiderPositionsByUser` | Get fresh wallet positions by user |
| GET | `/elite/getInsiderPositionsByEvent` | Get fresh wallet positions by event |
| GET | `/elite/getTopInsiders` | Get top suspected fresh wallets |

#### Paper Trading

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/elite/paper-trade/account` | Get paper trading account |
| POST | `/elite/paper-trade/account/name` | Update account name |
| GET | `/elite/paper-trade/account/stats` | Get account statistics |
| POST | `/elite/paper-trade/account/reset` | Reset paper trading account |
| GET | `/elite/paper-trade/balance` | Get account balance |
| GET | `/elite/paper-trade/positions` | Get positions |
| GET | `/elite/paper-trade/trades` | Get trade history |
| GET | `/elite/paper-trade/orders` | Get all orders |
| POST | `/elite/paper-trade/createOrder` | Create an order |
| GET | `/elite/paper-trade/order/{orderId}` | Get order by ID |
| DELETE | `/elite/paper-trade/order/{orderId}` | Cancel order |
| POST | `/elite/paper-trade/orders/cancel-all` | Cancel all orders |
| POST | `/elite/paper-trade/redeem/{positionId}` | Redeem position |
| POST | `/elite/paper-trade/redeem-all` | Redeem all positions |
| GET | `/elite/paper-trade/status` | Get system status |

### Usage Terms

This API is strictly for **non-commercial use only**. Commercial use requires a separate license. Contact api@polyalerthub.com for commercial licensing inquiries.

---

## Key Definitions

### What is a Whale?

Whales are high-volume traders defined by their historical trading volume and total value locked (TVL) in prediction markets. PolyAlertHub automatically tags these wallets based on on-chain activity.

**Classification Tiers:**
- **Mega Whales:** Positions with $100,000+ total investment
- **Super Whales:** Positions with $500,000+ total investment
- **Ultra Whales:** Positions with $1,000,000+ total investment

### What is a Fresh Wallet Signal?

Fresh Wallets are accounts that demonstrate unusual trading patterns suggesting potential access to non-public information. Detection is algorithmic and based on:

- Unusual accumulation patterns before major news events
- Consistently profitable trades on specific market outcomes
- New wallet behavior with high-conviction positions
- Abnormal concentration in single markets
- Timing patterns correlated with price movements

**Important:** Fresh wallet detection is probabilistic and does not constitute proof of misconduct. Scores and risk levels are algorithmic assessments based on observable on-chain patterns.

### What is Paper Trading?

Paper trading is a risk-free trading simulator that allows users to practice trading strategies on real Polymarket data without using real capital. Users receive a $10,000 virtual balance to:

- Place limit and market orders
- Track P&L and position performance
- Test strategies before committing real funds
- Learn how prediction markets work

### What is the Trading Terminal?

The Trading Terminal is PolyAlertHub's professional-grade execution and analytics workspace for Polymarket. It combines live order book, depth, charts, one-click order entry, positions, and trade history with a multi-view tabbed workspace system (up to 20 workspaces × 8 market cards each). Each card runs its own live WebSocket connection so multiple markets can be monitored and traded simultaneously without interference. Workspace layouts are saved per user.

### What is Multi-Address Wallet Linking?

PolyAlertHub lets a single account link multiple Polymarket wallet addresses on the Profile page. Linked addresses are aggregated for combined portfolio, PnL, and position views, so traders who use multiple wallets can see their full activity in one place.

---

## Notifications & Delivery Channels

All PolyAlertHub alerts (price, market, whale, trader, fresh wallet) can be delivered through:

- **Email:** Alert digests and instant emails. Manage delivery and unsubscribe at https://www.polyalerthub.com/unsubscribe.
- **Telegram:** Real-time push notifications via the PolyAlertHub Telegram bot.
- **In-app:** Alert center on the user dashboard at /home with completed-alert archive at /completed.

**Aggregate landing pages:**
- https://www.polyalerthub.com/features/polymarket-alerts — Overview of the full alert suite
- https://www.polyalerthub.com/features/polymarket-telegram-alerts — Overview of notification delivery and channels

---

## Account & User Management

### Dashboard
Personalized authenticated view at https://www.polyalerthub.com/home showing active alerts, tracked traders, whale activity, and analytics.

### Profile
User profile and account settings at https://www.polyalerthub.com/profile including:

- Subscription management (upgrade, downgrade, cancel)
- **Polymarket wallet linking with multi-address support** — link multiple Polymarket addresses to a single PolyAlertHub account for combined portfolio and PnL tracking
- Notification preferences (email, Telegram)
- API key management (Elite plan) at /api-keys

### Feature Requests
Submit and vote on platform feature requests at https://www.polyalerthub.com/feature-requests to influence the product roadmap.

### Authentication
- Sign-in / sign-up: https://www.polyalerthub.com/login
- Email unsubscribe: https://www.polyalerthub.com/unsubscribe

### Billing
- Stripe checkout success: https://www.polyalerthub.com/success
- Stripe checkout cancel: https://www.polyalerthub.com/cancel

---

## Referral Program

Available exclusively to premium subscribers.

### How It Works

1. Share your unique referral link with users
2. When they subscribe to premium, you earn 1 free month
3. Stack up to 20 free months for extended premium access

### Requirements

- Must maintain active premium subscription
- Referred user must create a new account
- Referred user must complete their first premium payment
- Payment must process successfully

### Restrictions

- Maximum 20 stacked free months at any time
- Excess months beyond limit are forfeited
- Honest and transparent promotion required
- No spam, misleading claims, or platform ToS violations

**URLs:**
- FAQ: https://www.polyalerthub.com/referral-faq
- Legal terms: https://www.polyalerthub.com/referral-terms
- Join via referral: https://www.polyalerthub.com/join-referral

---

## Site Map

### Core Pages
| Page | URL | Description |
|------|-----|-------------|
| Home | https://www.polyalerthub.com/ | Platform overview and main entry point |
| Features | https://www.polyalerthub.com/features | Complete feature breakdown |
| Plans | https://www.polyalerthub.com/plans | Pricing and subscription options |
| Blog | https://www.polyalerthub.com/blog | Articles, guides, and market analysis |
| How to Use Polymarket Price Alerts | https://www.polyalerthub.com/blog/how-to-use-polymarket-price-alerts | Step-by-step guide to setting Polymarket price alerts with PolyAlertHub; covers target price, direction (above/below), repeating alerts, cooldowns, and notification channels |
| How to Copy Trade Profitable Whales on Polymarket | https://www.polyalerthub.com/blog/how-to-copy-trade-polymarket-whales | Practical guide on identifying profitable whales, measuring consensus, and building copy-trading workflows with examples and API tips |
| Polymarket Whales Tracker Guide | https://www.polyalerthub.com/blog/polymarket-whales-tracker-guide | Comprehensive walkthrough of the Whales Tracker dashboard, filters, live feed, and whale analytics to spot market-moving activity |
| How to Paper Trade on Polymarket | https://www.polyalerthub.com/blog/how-to-paper-trade-on-polymarket | Tutorial on paper trading using PolyAlertHub's simulator: virtual balance, order types, strategy testing, and P&L tracking |
| User Guide | https://www.polyalerthub.com/user-guide | Platform documentation and tutorials |
| Contact | https://www.polyalerthub.com/contact | Support and partnership contact form |

### Trading Terminal
| Page | URL | Description |
|------|-----|-------------|
| Trading Terminal | https://www.polyalerthub.com/terminal | Pro Polymarket terminal with multi-view workspaces |
| Per-Event Terminal | https://www.polyalerthub.com/terminal/{slug} | Trading view for a specific Polymarket event |

### Analytics
| Page | URL | Description |
|------|-----|-------------|
| Markets | https://www.polyalerthub.com/markets | Market explorer with filters and saved views |
| Market Detail | https://www.polyalerthub.com/markets/{value} | Per-event/market detail |
| Analytics | https://www.polyalerthub.com/features/polymarket-analytics | Performance dashboards |
| Leaderboard | https://www.polyalerthub.com/features/polymarket-leaderboard | Trader rankings |
| Top Traders | https://www.polyalerthub.com/features/trader-leaderboards | Elite trader profiles |
| Trader Profile | https://www.polyalerthub.com/traders/{value} | Per-trader profile and analytics |
| Trader Comparison | https://www.polyalerthub.com/traders/compare | Compare up to 5 traders side by side |
| Categories | https://www.polyalerthub.com/categories | Market category browser |
| Category Detail | https://www.polyalerthub.com/categories/{category} | Per-category page |
| Paper Trading | https://www.polyalerthub.com/paper-trading | Trading simulator |
| Paper Trading Event | https://www.polyalerthub.com/paper-trading/{slug} | Per-event paper trading |
| Try Paper Trading | https://www.polyalerthub.com/try-paper-trading | No-account paper trading preview |

### Whale Tracking
| Page | URL | Description |
|------|-----|-------------|
| Whales Tracker | https://www.polyalerthub.com/features/polymarket-wallet-tracker | Whale dashboard |
| Whale Trades | https://www.polyalerthub.com/whale-trades | Trade analytics |
| Whale Positions | https://www.polyalerthub.com/whale-positions | Position tracker |
| Whales Live Feed | https://www.polyalerthub.com/whales-live-feed | Real-time whale activity |
| Traders Live Feed | https://www.polyalerthub.com/traders-live-feed | Real-time trader activity |

### Fresh Wallet Detection
| Page | URL | Description |
|------|-----|-------------|
| Fresh Wallets | https://www.polyalerthub.com/insiders | Fresh wallet analytics dashboard |

### Alerts
| Page | URL | Description |
|------|-----|-------------|
| Polymarket Alerts | https://www.polyalerthub.com/features/polymarket-alerts | Alert suite overview |
| Polymarket Notifications | https://www.polyalerthub.com/features/polymarket-telegram-alerts | Notification delivery overview |
| Market Alerts | https://www.polyalerthub.com/market-alert | Market event notifications |
| Price Alerts | https://www.polyalerthub.com/price-alert | Price threshold alerts |
| Create Price Alert | https://www.polyalerthub.com/price-alert/create | Price alert creation wizard |
| Completed Price Alerts | https://www.polyalerthub.com/price-alert/completed | Fired price alerts |
| Cancelled Price Alerts | https://www.polyalerthub.com/price-alert/cancelled | Cancelled price alerts |
| Whale Alerts | https://www.polyalerthub.com/whale-alert | Large trade notifications |
| Trader Alerts | https://www.polyalerthub.com/trader-alert | Trader activity tracking |
| Fresh Wallet Alerts | https://www.polyalerthub.com/insider-alert | Suspicious activity alerts |
| Completed Alerts | https://www.polyalerthub.com/completed | Archive of completed alerts |
| Unsubscribe | https://www.polyalerthub.com/unsubscribe | Email unsubscribe management |

### Account & User
| Page | URL | Description |
|------|-----|-------------|
| Login | https://www.polyalerthub.com/login | Sign-in / sign-up |
| Dashboard | https://www.polyalerthub.com/home | Authenticated user dashboard |
| Profile | https://www.polyalerthub.com/profile | Account, wallets, subscription |
| Feature Requests | https://www.polyalerthub.com/feature-requests | Submit and vote on features |
| Checkout Success | https://www.polyalerthub.com/success | Stripe post-checkout success |
| Checkout Cancel | https://www.polyalerthub.com/cancel | Stripe checkout cancellation |

### API & Developer
| Page | URL | Description |
|------|-----|-------------|
| API Documentation | https://www.polyalerthub.com/features/polymarket-api | REST API reference |
| API Docs (Swagger) | https://www.polyalerthub.com/api-docs | OpenAPI/Swagger spec endpoint |
| API Key Management | https://www.polyalerthub.com/api-keys | Generate and manage API keys |

### Referral
| Page | URL | Description |
|------|-----|-------------|
| Referral FAQ | https://www.polyalerthub.com/referral-faq | Referral program details |
| Join Referral | https://www.polyalerthub.com/join-referral | Landing page for invited users |
| Referral Terms | https://www.polyalerthub.com/referral-terms | Referral program legal terms |

### Legal
| Page | URL | Description |
|------|-----|-------------|
| Terms of Service | https://www.polyalerthub.com/tos | Usage terms |
| Privacy Policy | https://www.polyalerthub.com/privacy-policy | Data handling |

---

## Frequently Asked Questions

### General

**What is PolyAlertHub?**
Polymarket trading terminal with AI-powered analytics and real-time alerts. Track fresh wallets and smart money on Polymarket with instant alerts and notifications to telegram or email.

**How do I get alerts?**
Sign up for a free account and configure your preferred alert types including price alerts, whale trade alerts, trader position alerts, and market end alerts. Receive notifications via email or Telegram.

**Is PolyAlertHub free?**
PolyAlertHub offers both free and premium plans. The free plan includes basic alerts and limited features, while premium plans provide advanced features, unlimited alerts, and priority notifications.

### Data & Real-Time

**Is the data real-time?**
Yes, the Live Feed features utilize WebSocket connections to provide instant updates on market activity.

**What markets does PolyAlertHub support?**
PolyAlertHub specializes in Polymarket, providing comprehensive analytics and alerts for all prediction markets on the platform, including crypto, politics, sports, and more.

### Trading

**Can I copy-trade?**
While PolyAlertHub does not execute trades for you, the Trader Alert feature allows you to receive instant notifications when a target wallet trades, facilitating manual copy-trading.

**What is paper trading?**
Paper trading is a risk-free simulator with a $10,000 virtual balance that allows you to test trading strategies on real Polymarket data without risking real capital.

**Does PolyAlertHub support real trading on Polymarket?**
Yes. The Trading Terminal at /terminal provides a full execution surface for Polymarket with live order book, charts, one-click order entry, open orders, positions, trade history, and multi-view tabbed workspaces.

**Can I link more than one Polymarket wallet?**
Yes. You can link multiple Polymarket addresses to a single PolyAlertHub account from the Profile page, and your positions, PnL, and history will be aggregated across them.

**How are notifications delivered?**
Alerts can be delivered via email, Telegram (through the PolyAlertHub Telegram bot), and in-app on the dashboard. You can configure channels per alert type from your profile.

### Technical

**How do I use the API?**
API access requires an Elite subscription. Use your API key with the Authorization header: `Bearer poly_your_api_key_here`. See the API documentation at https://www.polyalerthub.com/features/polymarket-api for complete endpoint reference.

---

## Contact & Support

- **General Support:** Use the contact form at https://www.polyalerthub.com/contact
- **API Inquiries:** api@polyalerthub.com
- **Community:** https://discord.com/invite/paWVAqmy3z

---

*Last updated: May 2026*