Skip to content

tirth707/Poly-Bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 

Repository files navigation

PolyBot - Autonomous Polymarket Trading Terminal

Version License Tech Stack Web3

πŸ“– Overview

PolyBot is a high-performance, user-hosted algorithmic trading bot designed specifically for Web3 prediction markets via Polymarket. Built entirely on the MERN stack, it operates exclusively on the client's local machine or personal cloud. This decentralized architecture guarantees absolute privacy, ultra-low latency, and total user custody over their funds, API keys, and proprietary trading logic.

The system acts as a rapid-execution bridge between off-chain market data and on-chain trade execution, ingesting real-time data streams via WebSockets and receiving precise trade signals via TradingView webhooks.

✨ Core Features

  • 100% Local Execution: No centralized company servers. Total privacy and ownership of your API keys and trading logic.
  • Ultra-Low Latency: Utilizes WebSockets and Node.js worker_threads to process live data and execute trades instantly on the Polymarket CLOB.
  • TradingView Integration: Seamlessly accepts POST webhook signals directly from your custom TradingView alerts.
  • Advanced Analytics Dashboard: Real-time React frontend featuring:
    • Live P&L charting (TradingView Lightweight Charts)
    • Segmented trade distribution (Recharts pie charts)
    • Calendar-based profit/loss heatmap (Nivo)
    • Real-time metrics: Sharpe ratio, profitable trade ratio, open position value, and total fees spent.

πŸ› οΈ Technology Stack

  • Frontend: React.js, Zustand (State Management), Socket.io-client
  • Backend: Node.js, Express.js, WebSockets (ws), Worker Threads
  • Database: MongoDB (Local instance), Mongoose
  • Web3 Integration: ethers.js (v6), @polymarket/clob-client

πŸš€ Getting Started

Prerequisites

  • Node.js (v18+)
  • Local MongoDB instance or Docker Desktop
  • A funded Polymarket (Polygon) wallet and API credentials
  • TradingView account (for webhook signals)

Installation (Local Development)

  1. Clone the repository:
    git clone [https://github.com/tirth707/poly-bot.git](https://github.com/tirth707/poly-bot.git)
    cd poly-bot

About

High-performance, low-latency MERN trading engine for Polymarket. Features local-first execution, direct TradingView/WebSocket integration, and comprehensive quantitative analytics (Sharpe Ratio, Calendar P&L, Live Growth Tracking). Designed for total user sovereignty with no central server requirements.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors