Polymarket Sports Cross-Line Arbitrage Bot

A polymarket trading bot that detects temporary pricing inefficiencies across connected Polymarket sports markets.

Who-am-i on Polymarket -> sold-my-car-to-bet

How profitable this bot?

https://github.com/user-attachments/assets/df6a93c2-c9b8-4b50-8ff4-bb863e60443b

Connect

📧 hacki13128@gmail.com

📞 https://t.me/hackonmon

Features

• ⚡ Real-time Polymarket CLOB streaming
• 🧠 Cross-line arbitrage detection on sports market
• 📈 Kelly Criterion stake sizing
• 💰 Paper trading & Live trading
• 🛡 Risk management engine
• 📊 Beautiful terminal dashboard
• 🧩 Modular architecture
• 📝 Structured logging
• 🚀 Production-oriented TypeScript codebase

Strategy

Sports markets inside a single event should satisfy several no-arbitrage relationships.

Whenever one market reprices faster than another after new information arrives, temporary inefficiencies can appear.

The bot continuously:

Gamma API
      │
      ▼
Discover connected markets
      │
      ▼
Stream live CLOB orderbooks
      │
      ▼
Detect pricing violations
      │
      ▼
Risk evaluation
      │
      ▼
Kelly stake sizing
      │
      ▼
Submit limit orders
      │
      ▼
Track positions & PnL

Current arbitrage checks include:

• Complementary YES/NO pairs
• Totals ladder relationships
• Spread ladder relationships
• Moneyline vs Spread
• Three-way market sums
• BTTS relationships

Quick Start

git clone https://github.com/donoaccestag/polymarket-sports-trading-bot.git
cd polymarket-sports-trading-bot
cp .env.example .env
npm install
npm run start:sim

CLI

npm start -- --mode sim

npm start -- --mode live --confirm-live

npm start -- --event nba-lal-bos-2026-01-15

npm start -- --tag 100381

CLI Options

| Flag | Description | |------|-------------| | --mode sim | Simulation mode | | --mode live | Live trading | | --event | Watch specific event | | --tag | Filter Gamma tags | | --confirm-live | Required safety confirmation |

Terminal Dashboard

┌───────────────────────────────────────────────────────────────┐
│ Header                                                       │
│ Mode • WS Status • Balance • PnL • Uptime                    │
├───────────────────────────────────────────────────────────────┤
│ Tracked Markets            │ Opportunities                   │
├────────────────────────────┴──────────────────────────────────┤
│ PnL Chart                                           Exposure  │
├───────────────────────────────────────────────────────────────┤
│ Orders / Fills             │ Alerts                          │
└───────────────────────────────────────────────────────────────┘
[p] Pause
[f] Flatten
[q] Quit

Logs are written separately using Pino so they never corrupt the dashboard.

Configuration

See .env.example.

Important variables:

| Variable | Default | Description | |------------|------------|-----------------------------| | MODE | sim | sim or live | | MINNETEDGE_BPS | 50 | Minimum edge | | MAXPOSITIONUSD | 500 | Max Kelly stake | | KELLY_FRACTION | 0.5 | Half Kelly | | MINSTAKEUSD | 5 | Minimum trade | | MAXEVENTEXPOSURE_USD | 200 | Event exposure cap | | DAILYLOSSLIMIT_USD | 100 | Kill switch | | SIMINITIALBALANCE | 10000 | Paper balance |

Architecture

Gamma REST
                     │
                     ▼
               Event Graph
                     │
                     ▼
              Market Classifier
                     │
                     ▼
           CLOB REST / WebSocket
                     │
                     ▼
             OrderBook Store
                     │
                     ▼
            Arbitrage Detector
                     │
                     ▼
              Risk Management
                     │
        ┌────────────┴────────────┐
        ▼                         ▼
 Sim Executor              Live Executor
        │                         │
        └────────────┬────────────┘
                     ▼
            Portfolio + Dashboard

Live Trading

Live mode requires:

PRIVATE_KEY
CLOBAPIKEY
CLOBAPISECRET
CLOBAPIPASSPHRASE

and either

--confirm-live

or

CONFIRM_LIVE=true

Execution uses

@polymarket/clob-client-v2

against production endpoints.

Project Structure

src/
├── arb/ │   └── Arbitrage detection
├── config/ │   └── Zod configuration
├── core/ │   └── Engine
├── data/ │   ├── Gamma │   ├── CLOB REST │   └── WebSocket
├── exec/ │   ├── Simulation │   ├── Live │   └── Order Manager
├── model/ │   ├── Event Graph │   └── Classifier
├── portfolio/ │   └── PnL
├── risk/ │   └── Exposure controls
├── ui/ │   └── blessed-contrib dashboard
└── util/     ├── Logging     ├── Math     └── Rate limiting

Contributing

Contributions are welcome.

Whether you're interested in:

• quantitative trading
• prediction markets
• TypeScript
• market microstructure
• performance optimization

Built with ❤️ for the Polymarket developer community.

If this repository helped you learn something new, consider giving it a ⭐.