# Polytragent — Documentation

Your AI-Powered Polymarket Trading Agent

v11.2 — Telegram Bot

🔬

#### Event Research

Paste any Polymarket link — get full AI analysis with market data, whale activity, and entry strategy

📊

#### Portfolio

Connect your wallet for live positions, P\&L tracking, risk scoring, and performance analytics

📈

#### Strategies

AI trading signals — NO Theta Decay and Scalping strategies with proven entry gates

🐋

#### Whale Alerts

Follow top wallets, get push notifications when whales trade, monthly P\&L leaderboard

## Quick Start

#### Open the bot

Search for **@bmpolybot** on Telegram or click the bot link

#### Send /menu

Opens the main menu with all features

#### Subscribe

Tap Subscribe ($99/mo via Stripe) or enter an access code with `/code PTA-XXXXXXXX`

#### Connect wallet

Go to Settings, paste your public Polymarket address: `/wallet 0xYour...`

#### Start researching

Paste any Polymarket link in the chat — the bot auto-detects it and runs AI analysis

## Subscription

### Standard Plan — $99/month

Everything included: AI market analysis, strategy signals, copy trading, whale alerts, portfolio management, risk controls, backtesting, and full accuracy dashboard. Cancel anytime.

### Access Codes

If you have an access code (format: `PTA-XXXXXXXX`), send `/code` and enter it when prompted. Each code is single-use.

## Main Menu

Send `/menu` to open the main menu. All buttons are full-width:

🔬 Event Research

📊 Portfolio

📈 Strategies

🔬 Research

⚙️ Settings

| Button             | Description                                               |
| ------------------ | --------------------------------------------------------- |
| **Event Research** | Paste a Polymarket link for full AI analysis              |
| **Portfolio**      | Positions, P\&L, risk scorecard, closed trades            |
| **Strategies**     | NO Theta and Scalping AI signals                          |
| **Research**       | Trending, new markets, whale alerts, breaking news, stats |
| **Settings**       | Wallet, sizing, notifications, risk limits                |

**Tip:** Paste a Polymarket link anywhere in the chat — Event Research triggers automatically.

## Event Research

Polytragent's flagship feature. Paste any Polymarket event URL and receive comprehensive AI analysis in 30-60 seconds.

### How to Use

**Option 1:** Tap **Event Research** from the menu and paste a link when prompted.

**Option 2 (recommended):** Simply paste a Polymarket URL anywhere in the chat. The bot auto-detects it.

### What You Get

| Section             | Details                                        |
| ------------------- | ---------------------------------------------- |
| Market Analysis     | YES/NO prices, 24h volume, liquidity, deadline |
| AI Recommendation   | Buy YES / Buy NO / SKIP with confidence level  |
| Edge Detection      | Expert vs market pricing, divergence analysis  |
| Whale Activity      | Smart money flow, top wallet positions         |
| News Context        | Recent developments, catalyst timeline         |
| Entry/Exit Strategy | Price range, take profit, stop-loss, sizing    |

**Cross-platform:** When available, Polytragent compares Polymarket pricing with Kalshi for additional edge detection.

## Portfolio

Full portfolio management with live wallet data, risk assessment, and performance tracking.

### Sub-Menu

📋 Dashboard

📂 Open Positions

📜 Closed Trades

🛡 Risk Scorecard

⚠️ Attention Items

📁 Events Categories

### Dashboard

**With wallet:** Live portfolio value, open positions, unrealized P\&L, AI performance stats, copy trading overview.

**Without wallet:** Manual position tracking, AI performance, and a prompt to connect for live data.

### Risk Scorecard

Diversification score (Good/Moderate/Low), max concentration percentage, category breakdown, and risk limit compliance.

### Wallet Connection

For the best experience, connect your Polymarket wallet in Settings. It's read-only and completely safe — only your public address is used.

## Strategies

AI-powered trading strategy signals based on quantitative analysis.

🎯 NO Theta Signals

⚡ Scalping Signals

### NO Theta Decay — "Sell the Fear"

Buy NO on deadline events where the outcome is unlikely. Harvest the fear premium as it decays over 14-28 days.

| Parameter       | Value                 |
| --------------- | --------------------- |
| Win Rate Target | 88%                   |
| Monthly Return  | 12-18%                |
| NO Price Range  | $0.55 — $0.90         |
| Min Edge        | 5 points above market |
| Position Sizing | Half-Kelly (max $30)  |
| Hold Period     | 14-28 days            |

### Scalping NO Theta — "Quick Harvest"

In the final 3-14 days before deadline, theta decay accelerates. Harvest 3-5 cent gains with high frequency.

| Parameter       | Value              |
| --------------- | ------------------ |
| Win Rate Target | 85-95%             |
| Monthly Return  | 5-12%              |
| NO Price Range  | $0.88 — $0.96      |
| Take Profit     | Entry + 3 cents    |
| Position Sizing | Fixed 2% (max $20) |
| Hold Period     | 2-7 days           |

**Risk Warning:** All trading involves risk. Past performance does not guarantee future results. Never trade more than you can afford to lose.

## Research

Your market intelligence hub with live data from Polymarket.

📈 Trending Events

🆕 New Markets

🐋 Whale Alerts

📰 Breaking News

📊 Global Stats

### Trending Events

Top 10 events on Polymarket by **24-hour trading volume**. Shows title, volume, YES price, and direct link. Refreshed live.

### New Markets

Markets **created within the past 24 hours**. Get in early before the crowd.

### Whale Alerts

Track top Polymarket wallets and receive **push notifications** when followed whales trade.

🏆 Monthly Leaderboard

➕ Add Whale Wallet

👤 My Follows

**Monthly Leaderboard** ranks wallets by 30-day P\&L. **Add Whale Wallet** lets you follow any address. **My Follows** shows your tracked wallets.

### Breaking News

Latest high-volume events from Polymarket — what's trending in prediction markets right now.

### Global Stats

Polymarket-wide dashboard: active events, active markets, total volume, plus Polytragent user stats and AI performance.

## Settings

👛 Connect Wallet

📐 Bet Sizing

🔔 Notifications

🛡 Risk Limits

🔑 API Keys

📥 Export Data

### Wallet Connection

Connect your Polymarket wallet for live portfolio tracking. **100% read-only** — no private keys needed.

Send `/wallet 0xYourAddress` to connect. Find your address at polymarket.com → Profile → Settings → Funding.

### Bet Sizing

| Method               | Description                       |
| -------------------- | --------------------------------- |
| Half-Kelly (default) | Math-optimal sizing based on edge |
| Fixed Amount         | Same dollar amount every trade    |
| % of Portfolio       | Scales with account size          |
| Vol-Adjusted         | Scales with market volatility     |

### Risk Limits

| Limit              | Default          |
| ------------------ | ---------------- |
| Max Position Size  | 25% of portfolio |
| Daily Loss Limit   | 10% of portfolio |
| Max Drawdown       | 25% from peak    |
| Max Open Positions | 6                |
| Cash Reserve       | 15% minimum      |

## Bot Commands

### Menu Commands

| Command      | Description        |
| ------------ | ------------------ |
| `/menu`      | Open the main menu |
| `/subscribe` | Subscribe — $99/mo |
| `/code`      | Redeem access code |

### Portfolio & Trading

| Command                    | Description               |
| -------------------------- | ------------------------- |
| `/wallet <address>`        | Connect Polymarket wallet |
| `/wallet_label <name>`     | Label your wallet         |
| `/research <url>`          | Research a market         |
| `/add <id> <entry> <size>` | Track a position          |
| `/performance`             | AI prediction stats       |
| `/manage`                  | Manage subscription       |

### Copy Trading

| Command             | Description            |
| ------------------- | ---------------------- |
| `/ct_leaderboard`   | Top trader leaderboard |
| `/ct_follow <addr>` | Follow a wallet        |
| `/ct_following`     | Your followed wallets  |
| `/ct_signals`       | Recent copy signals    |

## FAQ

### Is my wallet safe?

Yes. Only your public address is stored. No private keys, no signing, no custody. Same as viewing your wallet on Polygonscan.

### Can Polytragent trade for me?

No. Polytragent provides research, signals, and alerts. You execute trades on Polymarket directly.

### How do Whale Alerts work?

Follow wallets from the Monthly Leaderboard or add addresses manually. When a followed wallet trades, you get an instant Telegram notification.

### Are strategies guaranteed to profit?

No. All trading involves risk. Strategies are based on quantitative analysis and historical patterns. Never trade more than you can afford to lose.

### How do I cancel?

Send `/manage` in the bot to get your Stripe subscription management link. Cancel anytime.

### The bot isn't responding

Wait 30 seconds and try again. If it persists, the bot may be restarting. Try `/menu` after a few minutes.

Polytragent v11.2 — Built by [LuvKaizen.com ](https://luvkaizen.com)

[polytragent.com](https://polytragent.com/)