Polymarket-Telegram-Bot README

🐋 Whale Alerts — Polymarket Trading Bot

A Telegram bot for Polymarket, built by an enthusiast for enthusiasts.
Catches large whale trades in real time and lets you enter the market in one tap — no clunky confirmation chains, no delays.

_{Use the bot for free — until 10.10.2026}

_{Subscribe to the channel}

_{📋 For more on how it works, how to connect your wallet to Polymarket, and security — see the "Terms" section right inside the bot (button in the pinned menu after /start)}

Why

Normally, spotting a big whale trade on Polymarket and following it means manually watching the market, then clicking through a confirmation flow while the price already moves — and on Polymarket itself that confirmation popup can lag, glitch, or just not show up, so the trade signs late or not at all. This bot removes both problems:

It catches whale trades for you — plugged directly into Polymarket's live trade feed, reacts within seconds.
It signs instantly, every time — the wallet lives inside the bot, so a bet signs the moment you tap, with no confirmation popup to wait on or glitch out. No menu-hopping, no missed entries because the UI froze.

Features

🐋 Whale Alerts — personal alerts for big trades: your own minimum amount ($) and probability range (%), Start/Stop with one button.
⚡ Instant, glitch-free signing — the "Place bet" button comes right inside the alert; the trade signs in a single tap with no confirmation popup to wait on. Unlike Polymarket's own UI, where that popup can lag, glitch, or fail to appear, delaying or blocking the signature — here it just goes through.
💸 Fast deposits & withdrawals — the wallet in the bot is your real Polymarket account, so it doesn't matter where you top up or withdraw — through the Polymarket website or through the bot, it's the same balance. Balance activation and signing go straight through the official Polymarket API, without extra proxy steps — so it's faster than going through the website's own UI.
🔒 Keys locked behind your own PIN — every private key and seed phrase is automatically encrypted and stored on the server tied to your account. Access is locked behind a personal PIN code you set yourself — without it, no one can see them.
🤖 Copy Trading — follow a specific trader: the bot automatically mirrors their trades with a set budget, fixed amount, or multiplier.
🌐 The whole market, live — prices, odds, and event status stream straight over WebSocket, not on a refresh timer. No stale numbers, no reloading — you're always looking at what's happening right now, in an interface built to be fast and simple to act on.
🎾 Live Sports — a dedicated section with real-time score/status updates (tennis, football, etc.), including spread/handicap markets with clearly labeled lines.
🔍 Market Search — instantly find any event by name.
👛 Built-in Wallet — bet straight from the chat, no jumping between apps.
📊 Trade History — every bet with outcome, entry price, and P&L.
🌍 10 interface languages — en, ru, es, pt, zh, ar, fr, de, tr, uk.
📢 Public Alerts Channel — large trades ($100k+) are also posted to an open Telegram channel.

How it works

The bot is subscribed to Polymarket's live WebSocket feeds (activity / orders_matched, plus live prices and sports scores) and sees every trade and price move as it happens.
Each trade is checked against every active user's filters (min. amount, probability range).
Matching users get an alert with a bet button — one tap, no confirmation form.
If copy trading is enabled, the bot automatically opens a position mirroring the followed trader.

See demo/live-feed-example.js for a small standalone example of the WebSocket connection itself — subscribing to the live trade feed and the zombie-connection heartbeat that keeps it alive.

Note: this is just a demo file illustrating the connection technique — it is not the actual bot and does not contain its business logic, filters, or Telegram integration.

Screenshots

_{Alert settings — min amount, probability range, live status}	_{A whale alert in action}
_{Market section — browse by category}	_{Live Sports — a match in progress}
_{Placing a bet on a live match}	_{Crypto Live — 1-hour round}

Tech Stack

Node.js, node-telegram-bot-api (polling)
Polymarket Gamma API / Data API / CLOB
WebSocket live feeds (trades, live sports)
Express (landing page)

Disclaimer

This is an independent enthusiast project, not affiliated with Polymarket. Trading on prediction markets carries risk of loss — use at your own risk.

170 ·GitHub

Polymarket-Telegram-Bot

What is this?

A Telegram bot for Polymarket that watches the live trade feed for large whale trades and lets you copy them into your own bet with a single tap, no confirmation popup needed.

Is the bot's full source code included in this repo?

No. The repo only ships a small standalone demo file showing how the WebSocket connection to Polymarket's live feed works; the actual bot's business logic, filters, and Telegram integration are not published here.

How do I start using it?

There's nothing to install; you open the bot on Telegram and send /start, then check the 'Terms' section in the pinned menu to learn how to connect to Polymarket.

Do I need to bring my own Polymarket wallet?

No, the bot gives you a built-in wallet that is your real Polymarket account, so deposits and withdrawals work the same whether you use the Polymarket website or the bot.

Is it really free, and is there a catch?

It's free to use only until 10.10.2026; after that a subscription seems implied. It's also an independent fan project, not affiliated with Polymarket, and trading carries risk of loss.

Is my wallet's private key safe with this bot?

Private keys and seed phrases are encrypted and stored on the bot's server tied to your account, unlocked only by a personal PIN you set yourself.

What does Copy Trading do?

You pick a specific trader to follow, and the bot automatically mirrors their trades using a budget, fixed amount, or multiplier you set.

What is the Live Sports feature?

A dedicated section with real-time score and status updates for sports like tennis and football, including spread/handicap markets with clearly labeled lines.

How many languages does the bot support?

Ten interface languages: English, Russian, Spanish, Portuguese, Chinese, Arabic, French, German, Turkish, and Ukrainian.

Why does Polymarket's own confirmation popup matter here?

On Polymarket's own site that popup can lag, glitch, or fail to appear, delaying or blocking a trade; this bot signs the trade instantly in one tap without any confirmation step.

What are similar projects?

robinhood-lp-bot, Trpjan-solana-trading-toolkit, Crucix, pons-copy-trading-bot, pons-sniper-bot, stellar-trade, fragment-api-dev, solana-meme-tool

Which topics is it in?

crypto-trading, news, telegram-bot, wallet, trading-bot, bot, express, web3, blockchain, telegram, finance, websocket

Creator: Cleverfuxaqo1668
Size: 4.8 MB
Stars: 170
Updated: CommitOct 18
Age: 1mo
Commits · 90 Days