obsidian-trades/polymarket-copy-trading-bot

This is an automated trading bot for Polymarket, a prediction market platform where users bet real money on questions like whether Bitcoin's price will go up or down in the next five minutes. The bot runs on your computer, connects to your crypto wallet, and places trades automatically according to rules you configure. The bot has two main modes. The first is an arbitrage mode: it watches Polymarket's short-duration Bitcoin markets and looks for moments when you can buy both the Up token and the Down token for a combined price below one dollar. Because those two tokens together always settle at exactly one dollar regardless of which way Bitcoin moves, buying both at a discount locks in a profit. The second mode is copy trading, where you give the bot a target wallet address and it mirrors whatever trades that wallet makes on Polymarket. Setup requires Node.js installed on your computer, a Polygon network crypto wallet, USDC stablecoin on Polygon to fund the trades, and a small amount of MATIC to pay network fees. Configuration happens through a .env file where you set your wallet private key, spending limits per trade, hourly loss limits, and how aggressively to trade. The README strongly advises using a separate dedicated wallet for this bot and starting with very small amounts. The README is detailed and written for beginners, with step-by-step installation instructions, a full table explaining every configuration option, and screenshots showing the bot's trade history. It includes multiple safety guardrails: a maximum loss per hour, a maximum spend per market, and inventory imbalance limits that stop the bot if one side of a position grows too large. The README is clear that this places real money trades and that losses are possible.