Polymarket Crypto Assistant Tool

Real-time terminal dashboard that combines live Binance order flow with Polymarket prediction market prices to surface actionable crypto signals.

Screenshots

Quick Start

Without Python

Installation

1. Go to: https://github.com/FiatFiorino/polymarket-assistant-tool/releases/
2. Download PolymarketAssistant.exe
3. Double-click PolymarketAssistant.exe

• A console window will open and the dashboard will start
• First launch may take 10–60 seconds (normal — it's unpacking files)

Important notes:

Windows Defender / SmartScreen may show a warning

• Click More info
• Run anyway
• If your antivirus blocks the file completely - add an exception for it
• The program requires internet access to connect to Binance and Polymarket WebSockets

Advanced

Requirements

• Python 3.10 or higher (recommended: 3.11 / 3.12)
  → https://www.python.org/downloads/

Installation

1. Clone the repository

   git clone https://github.com/FiatFiorino/polymarket-assistant-tool.git
   cd polymarket-assistant-tool

2. Install dependencies

pip install -r requirements.txt

3. Run the tool

python main.py

What it does

• Streams live trades and orderbook from Binance
• Fetches Up/Down contract prices from Polymarket via WebSocket
• Calculates 11 indicators across orderbook, flow, and technical analysis
• Aggregates everything into a single BULLISH / BEARISH / NEUTRAL trend score
• Renders the full dashboard in the terminal with live refresh
• Sends notifications to a Telegram bot about a trend change and about a strong bullish/bearish trend.

Why It's Useful – Benefits for Traders

This tool bridges two powerful data sources that rarely get combined in real time:

1. Binance Order Flow
   Real institutional/retail pressure visible in live order book, aggressive trades (CVD, delta), imbalances → helps spot momentum before price moves.

2. Polymarket Prediction Markets
   Crowd wisdom priced in Up/Down contracts → often leads spot price in short-term sentiment (especially on volatile coins like SOL or during news).

By merging them you get:

• Early detection of directional bias (order flow confirms / contradicts Polymarket odds)
• Higher-confidence entries on Polymarket binary bets (Up/Down in 5–60 min windows)
• Better spot/futures trading decisions (e.g. avoid fighting strong CVD against you)
• Reduced emotional trading — clear aggregated score + visual indicators
• Timely alerts → no need to stare at screen 24/7

Who benefits most:

• Polymarket traders looking for an edge on short-term markets
• Spot/day traders who want prediction-market sentiment as a filter
• Crypto enthusiasts experimenting with order-flow + prediction arbitrage
• Anyone building their own bots — this is a solid real-time data foundation

In short: more data → better-informed decisions → potentially higher win rate in fast-moving crypto markets.

Supported coins & timeframes

All 16 coin × timeframe combinations are supported on Polymarket.

Indicators

Order Book

• OBI (Order Book Imbalance)
• Buy / Sell Walls
• Liquidity Depth (0.1% / 0.5% / 1.0%)

Flow & Volume

• CVD (Cumulative Volume Delta) — 1m / 3m / 5m
• Delta (1m)
• Volume Profile with POC

Technical Analysis

• RSI (14)
• MACD (12/26/9) + Signal + Histogram
• VWAP
• EMA 5 / EMA 20 crossover
• Heikin Ashi candle streak

Roadmap (planned features)

• Web version (Streamlit / Dash)
• Paper trading & real exchange integration
• Additional indicators: Bollinger Bands, Funding Rates, Liquidation data

License

MIT License — see the LICENSE file.