PredictiveFlow-Labs

PredictiveFlow-Labs / polymarket-btc-5min-15min-up-down-arbitrage-bot

Public

polymarket arbitrage bot polymarket arbitrage bot polymarket arbitrage bot polymarket arbitrage bot polymarket arbitrage bot polymarket arbitrage bot polymarket arbitrage bot polymarket arbitrage bot polymarket arbitrage bot polymarket arbitrage bot polymarket arbitrage bot polymarket arbitrage bot polymarket arbitrage bot polymarket arbitrage bot

polymarket-5min-15min-market-bot polymarket-5min-bot polymarket-arbitrage-bot polymarket-arbitrage-trading-bot polymarket-bt
302
3,487
69% credibility
Found May 31, 2026 at 302 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

This is an open-source trading bot that automates buying and selling on Polymarket's short-duration crypto prediction markets. The bot monitors 5-minute or 15-minute markets for Bitcoin, Ethereum, Solana, or XRP, watches price movements, and executes trades based on configurable rules. It connects to your Polygon wallet, places real orders on the Polymarket order book, handles errors gracefully with automatic retries, and redeems payouts when markets resolve. The project includes two trading strategies: a simple exit-based approach and a more sophisticated entry-with-emergency-swap approach. While marketed as an 'arbitrage bot,' it does not guarantee risk-free profits—it's a rule-based automation tool for active trading that requires careful configuration and carries real financial risk.

How It Works

1
🔍 Discovering the Bot

You search online for ways to automate trading on Polymarket prediction markets and find this open-source project.

2
📋 Reading the Instructions

The clear documentation explains this bot watches short-duration crypto markets (5 or 15 minutes) and makes trades based on price movements.

3
🔐 Connecting Your Wallet

You connect your Polygon wallet that holds USDC, giving the bot permission to make trades on your behalf.

4
⚙️ Choosing Your Settings

You pick which crypto to track (Bitcoin, Ethereum, Solana, or XRP), how long each market window lasts, and how much money to risk per trade.

5
Two Trading Strategies
📈
Strategy 1: Simple Exit Rules

Automatically sells when price moves too far from center or when time is almost up.

🔄
Strategy 2: Smart Entry & Swap

Waits for the right moment to buy, then can immediately switch to the opposite side if conditions change.

6
🚀 Launching the Bot

The bot starts polling prices every second, watching for opportunities that match your chosen strategy.

✅ Watching Your Trades

The bot executes trades automatically, logs everything clearly, and redeems your winnings when markets settle.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 302 to 302 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is polymarket-btc-5min-15min-up-down-arbitrage-bot?

This is a TypeScript trading bot for Polymarket's short-duration crypto prediction markets. It watches 5-minute and 15-minute windows for BTC, ETH, SOL, and XRP, then executes rule-based trades when your configured conditions hit. The bot connects via the official CLOB client, polls prices every second, and places market orders with retry logic and cooldowns. Configuration lives in a TOML file where you set your trade size, entry/exit thresholds, and which coin/period to target.

Why is it gaining traction?

Short-horizon prediction market bots are hot right now, and this one ships with two ready-made strategies you can swap via config. The setup is genuinely developer-friendly: Zod validates your environment variables at startup, credentials derive automatically from your wallet, and error messages stay human-readable instead of dumping raw stack traces. It supports proxy wallets and gnosis safe signing, which matters if you're running this seriously. The polling loop with staleness checks and position tracking gives you operational visibility out of the box.

Who should use this?

Developers who want to experiment with Polymarket CLOB automation in TypeScript without wiring everything from scratch. Traders comfortable with rule-based systems who can tolerate debugging a relatively young codebase. NOT suitable for production trading capital until you've exhaustively tested the order execution and balance reconciliation logic in a non-production environment.

Verdict

At 302 stars with a credibility score of 0.7%, this is clearly an early-stage, experimental project. The documentation is thorough and the architecture is readable, but there's no test suite visible, the interactive CLI prompts on every run (inquirer), and the "arbitrage" branding glosses over the fact that it trades one market window per process, not the synchronized cross-window strategy the name implies. Start paper-trading with minimal USD exposure and verify fills and balances match your expectations before scaling up.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.