> For the complete documentation index, see [llms.txt](https://etherdrops.gitbook.io/etherdrops-bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://etherdrops.gitbook.io/etherdrops-bot/core-features/polymarket-1.md).

# Polymarket

### 👀 Overview

Drops Bot delivers instant real-time alerts for Polymarket activity on Polygon straight to your Telegram. It reads public on-chain data without needing a Polymarket account, signing transactions, or touching your funds.

Track any Polymarket event or whale wallet in real time and get instant alerts on price movements, odds changes, volume, and smart-money bets.

{% hint style="warning" %}
The Bot does **not** trade for you. It only monitors Polymarket activity and reports it via Telegram — what you do with that information is up to you.
{% endhint %}

| What you track        | What you get                                                   |
| --------------------- | -------------------------------------------------------------- |
| **Polymarket events** | One specific market, regardless of who trades on it            |
| **Whale wallets**     | One wallet's Polymarket trades, across every market it touches |

### ⚡ Quickstart

{% stepper %}
{% step %}

#### Open **Main Menu → 🟦 Polymarket** or just type `/polymarket`

If you are not tracking anything yet, you will see:

<div align="center"><figure><img src="https://2854945133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE1xatl7EJgINFUiyMW2P%2Fuploads%2FcCm42hmFzxfK9o1FfObJ%2Fimage_2026-05-15_01-43-21.png?alt=media&amp;token=856e6e96-8583-48cc-843c-eb67238d6dda" alt="" width="471"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Use **➕ Add Event/Wallet** button to start tracking:

* a specific **Polymarket event**
* or a specific **wallet**
  {% endstep %}

{% step %}

#### Discover 🔥Trending Events

Browse and add this month’s **Polymarket Trending Events by 24h vol**.

<div align="left"><figure><img src="https://2854945133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE1xatl7EJgINFUiyMW2P%2Fuploads%2F3LdjQnolJm5OSVIfwXK5%2Fimage.png?alt=media&amp;token=6e84467b-7549-4dec-9fc5-97ad7b44ee25" alt="" width="428"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Review your dashboard

Open `/polymarket` again and review both tracking areas:

* **🟦 Your current events list**

<div align="left"><figure><img src="https://2854945133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE1xatl7EJgINFUiyMW2P%2Fuploads%2FUQ98X7obntpqq4Dq3yya%2Fimage.png?alt=media&amp;token=e9b89437-521f-4ab0-9a7a-f7abf6cddb64" alt="" width="474"><figcaption></figcaption></figure></div>

* **🔵 Polymarket Wallets**

<div align="left"><figure><img src="https://2854945133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE1xatl7EJgINFUiyMW2P%2Fuploads%2FgL1QbpG8kHGEJAwcQEuC%2Fimage.png?alt=media&amp;token=7ac488e0-4381-4f56-bcf7-e8c0a98dd7fe" alt="" width="335"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### ⚙️ Alerts & Management

Tap the **“✏️”** button next to any event or wallet that you track.

The settings menu opens here:

<div align="left"><figure><img src="https://2854945133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE1xatl7EJgINFUiyMW2P%2Fuploads%2FvGZX7WKVsAzrqLDeCsQI%2Fimage.png?alt=media&amp;token=d24a4a76-7370-4e57-9e95-d5e27e477809" alt="" width="454"><figcaption></figcaption></figure></div>

| Setting           | What it does                                                                                                      |
| ----------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Notifications** | Turn alerts **On** or **Off** for the specific event                                                              |
| **Price Change**  | Set a **¢ price change**. Example: **10¢**. You are notified each time the price changes by that amount or more   |
| **Price Target**  | Set a **¢ price target**. Example: **100¢**. You are notified when the price reaches this target                  |
| **Swaps Alert**   | Set a **swap alert threshold**. Example: **$10K**. You are notified when someone trades for more than this amount |
| **Volume Target** | Set a **$ volume target**. Example: **$100K**. You are notified when **total odd volume** reaches it              |
| **Delete**        | Remove the event from your tracking list                                                                          |

{% hint style="warning" %}
Settings apply to the specific tracked event or odd you edit.
{% endhint %}

<details>

<summary><strong>🖼️ See setting examples</strong></summary>

**Price Change**

<div align="left"><figure><img src="https://2854945133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE1xatl7EJgINFUiyMW2P%2Fuploads%2FYCDbePy75kq3lEgDiaMG%2Fimage.png?alt=media&amp;token=109944c6-6f4f-4e85-bb3e-0397a294cc2d" alt="" width="467"><figcaption></figcaption></figure></div>

**Price Target**

<div align="left"><figure><img src="https://2854945133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE1xatl7EJgINFUiyMW2P%2Fuploads%2FFFQNAQNthwjv0oqzVi9S%2Fimage.png?alt=media&amp;token=10e77897-8b01-4a2a-9dbb-793692bd26d7" alt="" width="398"><figcaption></figcaption></figure></div>

**Swaps Alert**

<div align="left"><figure><img src="https://2854945133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE1xatl7EJgINFUiyMW2P%2Fuploads%2FQqXaK29NRQQVIKZsoyqy%2Fimage.png?alt=media&amp;token=4b9daebd-451d-4112-92c2-f2084fda428d" alt="" width="441"><figcaption></figcaption></figure></div>

**Volume Target**

<div align="left"><figure><img src="https://2854945133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE1xatl7EJgINFUiyMW2P%2Fuploads%2FhkAjGNJJcrhuhSC33nax%2Fimage.png?alt=media&amp;token=b330ff23-85fc-4f38-b646-fb7a33c0f0ac" alt="" width="410"><figcaption></figcaption></figure></div>

</details>

### 📘 Glossary

| Term           | Meaning                                                                                                             |
| -------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Wallet**     | One public wallet you track across every Polymarket market it touches                                               |
| **Event**      | One specific Polymarket market you track                                                                            |
| **Odd**        | A tracked outcome inside a market                                                                                   |
| **Outcome**    | A specific possibility within an event                                                                              |
| **Share**      | A position unit on Polymarket. A `YES` share pays `$1` if the outcome resolves true, `$0` otherwise                 |
| **Price (¢)**  | Per-share price in cents. Equivalent to the market's implied probability — e.g., `23.4¢` ≈ 23.4 % chance            |
| **Resolution** | The moment an event's outcome is finalized and shares pay out. Tracking stops automatically at resolution           |
| **Share-swap** | A trade where shares change hands directly between users on the order book — the data source for **♻️ Swaps Alert** |

### 📦 Plan Limits

Your Polymarket tracking capacity depends on your active subscription.

| Plan              | Wallets | Events | Messages per hour | Swap alert |
| ----------------- | ------- | ------ | ----------------- | ---------- |
| **Free/Basic**    | 20      | 20     | 100               | ≥$1000     |
| **Advanced**      | 100     | 100    | 500               | >$0        |
| **Pro**           | 500     | 500    | 1000              | >$0        |
| **Wallet Sniper** | 2000    | 500    | 2000              | >$0        |
| **Custom**        | Custom  | Custom | Custom            | >$0        |

#### What happens when you reach a limit

When you hit a plan limit, the bot notifies you and suggests one of two actions:

1. **Edit** your current list.
2. **Upgrade** your subscription plan.

If you hit your **hourly notification cap**, the bot also sends a warning.

{% hint style="warning" %}
Plan limits apply to tracked items and message volume. They do not change how Polymarket monitoring works.
{% endhint %}

#### Upgrade path

Drops Bot offers several subscription plans to expand your tracking limits and unlock advanced features. You can subscribe via the **website** or using **Telegram Stars** inside the bot.

For detailed plan comparison (price, all quotas, payment methods), see the [main Subscription docs.](https://etherdrops.gitbook.io/etherdrops-bot/core-features/subscriptions)

### 🔧 Troubleshooting & FAQ

#### General

<details>

<summary><strong>What networks does Polymarket tracking support?</strong></summary>

**Polygon only.** Polymarket itself runs on Polygon PoS, so all event tracking and wallet Polymarket activity is scoped to Polygon. Wallet activity on Ethereum, Base, Solana, or any other chain — even on the same wallet address — does not produce Polymarket-flavoured alerts.

</details>

<details>

<summary><strong>Do I need a Polymarket account or to connect a wallet?</strong></summary>

No. Tracking is read-only. You provide the bot with public event URLs and/or watched wallet addresses; nothing in your own funds is ever touched.

</details>

<details>

<summary><strong>What should I do if a specific event URL does not work?</strong></summary>

Open the exact market page on `polymarket.com` and copy that URL again. Category pages are not accepted.

</details>

<details>

<summary><strong>Is there a shortcut command for Polymarket?</strong></summary>

Yes — **`/polymarket`** opens your watchlist directly.

</details>

#### Tracking & Limits

<details>

<summary><strong>What's the difference between event tracking and wallet activity tracking?</strong></summary>

**Event tracking** watches one specific Polymarket market regardless of which wallet trades on it. \
**Wallet activity tracking** watches one wallet across all the Polymarket markets it touches.

</details>

<details>

<summary><strong>Can I track multiple outcomes of a multi-outcome market?</strong></summary>

Yes. A multi-outcome market is tracked as a single event, and alerts fire on movement in any of its outcomes.

</details>

<details>

<summary><strong>How many events can I edit at once?</strong></summary>

Bulk edit applies a change to your entire Polymarket Events list in a single operation. There is no separate per-batch cap beyond your plan limit.

</details>

<details>

<summary><strong>What happens when a market resolves?</strong></summary>

Tracking stops automatically. The event remains in your list as a historical record but no longer fires alerts. Periodically clean resolved events out via bulk-remove to keep slots free.

</details>

<details>

<summary><strong>Will I lose my settings if I remove and re-add an event?</strong></summary>

Yes. Removing an event clears its per-event settings. Re-adding it starts with fresh defaults.

</details>

#### Notifications

<details>

<summary><strong>Can I route Polymarket alerts to a Telegram group instead of my private chat?</strong></summary>

Yes. Connect a profile to a group via [Bot for Groups and Channels](https://etherdrops.gitbook.io/etherdrops-bot/advanced-tools/bot-for-groups-and-channels) and configure that profile to handle Polymarket events.

</details>

<details>

<summary><strong>Can I disable Polymarket alerts without removing events?</strong></summary>

Yes. Set the global Alert frequency to **Off**, or mute individual events. Tracking remains intact; only the notifications stop.

</details>

#### Account & Data

<details>

<summary><strong>What happens to my Polymarket Events when I delete my account?</strong></summary>

All tracked Polymarket Events are removed permanently as part of account deletion.

</details>

<details>

<summary><strong>Can I export my event list?</strong></summary>

Export follows the same pattern as wallet and coin export, if it is available in your bot menu. If the option is not present, it is not available for Polymarket Events yet.

</details>

<details>

<summary><strong>Does the bot store my Polymarket trading history?</strong></summary>

The bot only stores **what you ask it to track** (event references, wallet addresses) and the alerts it has sent. It does not aggregate or republish your trading positions.

</details>