# 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/)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://polytragent.gitbook.io/polytragent-docs/polytragent-documentation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.