Since the https://polygon-rpc.com RPC endpoint has ceased free operation, please upgrade to the latest version of the code immediately. Otherwise, you will be unable to perform a proper merge operation, resulting in data loss.

English | 中文

A Rust arbitrage bot for Polymarket crypto “Up or Down” 5‑minute markets (UTC). It monitors order books, detects YES+NO spread arbitrage opportunities, executes trades via the CLOB API, and can periodically merge redeemable positions.

1. Download the trial package from the release: poly_5min_bot.zip
2. Place it on a cloud server, ensuring your region is allowed to trade by PolyMarket.
3. Configure the first few blank parameters in the .env file. These parameters are exported from the PolyMarket website.
4. Run in the foreground: ./poly_5min_bot
5. Run in the background: nohup ./poly_5min_bot > /dev/null 2>&1 &

# 1. Install Rust (if needed), clone project, enter directory
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
git clone https://github.com/rvenandowsley/Polymarket-crypto-5min-arbitrage-bot.git && cd Polymarket-crypto-5min-arbitrage-bot

# 2. Place license.key in project root, copy and edit .env
cp .env.example .env
# Edit .env: set POLYMARKET_PRIVATE_KEY (required)

# 3. Build and run
cargo build --release && cargo run --release

• Market discovery: Fetches “Up/Down” 5-minute markets (e.g. btc-updown-5m-1770972300) from Gamma API by symbol and 5-min UTC window.
• Order book monitoring: Subscribes to CLOB order books, detects when yes_ask + no_ask < 1 (arbitrage opportunity).
• Arbitrage execution: Places YES and NO orders (GTC/GTD/FOK/FAK), with configurable slippage, size limits, and execution threshold.
• Risk management: Tracks exposure, enforces RISK_MAX_EXPOSURE_USDC, and optionally monitors hedges (hedge logic currently disabled).
• Merge task: Periodically fetches positions, and for markets where you hold both YES and NO, runs merge_max to redeem (requires POLYMARKET_PROXY_ADDRESS and MERGE_INTERVAL_MINUTES).

• Rust 1.70+ (2021 edition)
• License: Valid license.key in project root
• Environment: .env in project root (see Configuration)

If Rust is not installed:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
rustc --version   # Verify: 1.70 or higher

git clone https://github.com/rvenandowsley/Polymarket-crypto-5min-arbitrage-bot.git
cd Polymarket-crypto-5min-arbitrage-bot

Or download and extract the project archive.

Place the license.key file in the project root. The program will not run without a valid license.

Optional: set POLY_15MIN_BOT_LICENSE=/path/to/license.key to use a custom path.

cp .env.example .env
# Edit .env and fill in required variables (see Configuration below)

cargo build --release

Create a .env file (copy from .env.example). Required and optional variables:

After completing Installation:

# Build release binary
cargo build --release

# Run the bot
cargo run --release

Or run the built binary directly:

./target/release/poly_15min_bot

Logging: Set RUST_LOG in .env or before running (e.g. RUST_LOG=info or RUST_LOG=debug).

Run in background (Linux/macOS):

nohup ./target/release/poly_15min_bot > bot.log 2>&1 &

Run with:

cargo run --release --bin test_merge
cargo run --release --bin test_positions
# etc.

src/
├── main.rs           # Entrypoint, merge task, main loop (order book + arb)
├── config.rs         # Config from env
├── lib.rs            # Library root (merge, positions)
├── merge.rs          # Merge logic
├── positions.rs      # Position fetching
├── market/           # Discovery, scheduling
├── monitor/          # Order book, arbitrage detection
├── risk/             # Risk manager, hedge monitor, recovery
├── trading/          # Executor, orders
└── bin/              # test_merge, test_order, test_positions, ...

This bot interacts with real markets and real funds. Use at your own risk. Ensure you understand the config, risk limits, and Polymarket’s terms before running.