World Cup Arbitrage Trading Bot

A professional CLI trading bot for Polymarket FIFA World Cup 2026 markets. It discovers World Cup events, shows live market state on startup, and continuously scans for arbitrage opportunities.

Features

• WORLD CUP branded terminal UI with live market tables
• Real Polymarket data via Gamma API (discovery) + CLOB API (live prices)
• Arbitrage strategies
• Binary YES+NO bundle: buy both sides when total cost < $1.00
• Neg-risk bundles: buy all outcome YES tokens when combined cost < $1.00
• Configurable settings after trading starts — change edge, position size, scan interval, and more without restarting
• Dry-run mode by default (safe simulation)
• Redis caching (optional) — persist settings, markets, stats, and market state

Quick Start

Prerequisites

• Node.js 18+
• npm

Install

npm install

Run

npm start

The bot will:

1. Show the WORLD CUP banner
2. Load World Cup markets from Polymarket
3. Display current market state (YES/NO prices, sums, liquidity)
4. Start scanning for arbitrage opportunities

CLI Commands

While the bot is running, type commands and press Enter:

Arbitrage Settings

Configure via .env or the in-app settings command:

Copy .env.example to .env to customize defaults:

cp .env.example .env

Redis (Optional)

Enable Redis to cache market discovery, persist arbitrage settings across restarts, and store bot stats:

REDIS_ENABLED=true
REDIS_URL=redis://127.0.0.1:6379

If Redis is unavailable, the bot continues without cache. Use the markets command to force a fresh API refresh.

Live Trading

Live mode requires wallet credentials and the Polymarket CLOB V2 SDK. The bot ships with dry-run as the safe default.

To prepare for live trading:

1. Set TRADING_MODE=live in .env
2. Add PRIVATE_KEY and DEPOSIT_WALLET_ADDRESS
3. Install @polymarket/clob-client-v2 and viem
4. Implement order execution in src/arbitrage/executor.ts

Note: Polymarket has geographic restrictions. Ensure you comply with their terms of service.

How Arbitrage Works

On Polymarket binary markets, YES + NO tokens always pay out exactly $1.00 combined at resolution. If you can buy both for less than $1.00 (minus fees), you lock in risk-free profit.

For neg-risk multi-outcome events (e.g. World Cup Winner), buying YES on every outcome has the same property when the full set costs less than $1.00.

Project Structure

src/
├── index.ts              # Entry point
├── config.ts             # Environment settings
├── types.ts              # Type definitions
├── api/
│   ├── gamma.ts          # Market discovery
│   └── clob.ts           # Live prices
├── arbitrage/
│   ├── scanner.ts        # Opportunity detection
│   └── executor.ts       # Trade execution
└── cli/
    ├── app.ts            # Main CLI application
    ├── banner.ts         # WORLD CUP display
    ├── display.ts        # Tables and output
    └── settings-menu.ts  # Interactive settings

License

MIT