shinyatomitsuka/arbitrage-trading-bot — explained in plain English
Analysis updated 2026-05-18
Automate an exit-only position strategy on Polymarket UP/DOWN markets.
Run a configurable entry-and-exit trading strategy on crypto prediction markets.
Monitor live order book prices and on-chain portfolio value from the terminal.
| shinyatomitsuka/arbitrage-trading-bot | rasoir0591/crosshair-x | shadowspread/polymarket-auto-trading | |
|---|---|---|---|
| Stars | 251 | 251 | 252 |
| Language | TypeScript | TypeScript | TypeScript |
| Setup difficulty | moderate | easy | moderate |
| Complexity | 4/5 | 1/5 | 3/5 |
| Audience | developer | general | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires a funded Polymarket proxy wallet with USDC on Polygon and a signing private key.
This is an automated trading bot for Polymarket, a prediction market platform where users can bet on whether the price of a cryptocurrency will go up or down within a set time window. The bot is written in TypeScript and targets Polymarket's UP/DOWN markets for Bitcoin, Ethereum, Solana, and XRP, supporting windows from 5 minutes to 24 hours. The bot connects to Polymarket's order book, checks bid and ask prices every second, and executes one of two configurable trading strategies. It works with real on-chain balances: it reads the actual USDC and share balances from the Polygon blockchain rather than simulating a portfolio in memory. Orders are placed as fill-and-kill, meaning they either execute immediately at the best available price or are cancelled. The two strategies are configured through a TOML file. The first is an exit-only strategy that holds no new positions but closes any existing one when either the remaining time in the market window drops below a threshold or when the price moves far enough away from the midpoint. The second strategy adds entry logic: the bot buys the side (up or down) with the currently higher price when conditions are met, exits when price targets are hit, and can optionally execute an immediate swap to the opposite side after an exit if the price conditions suggest a reversal. Setup requires a private key for the wallet that signs orders and a funded Polymarket proxy wallet address holding USDC on the Polygon network. The strategy and market settings are set in the TOML configuration file, and the bot is started with a single command. During operation, it prints a live status line every few seconds showing the current price ratio, time remaining in the window, the position held, and portfolio value. The README includes a clear disclaimer that this is execution software for research purposes and that cryptocurrency derivatives carry high risk. The project is released under an ISC license.
An automated TypeScript bot that trades Polymarket's UP/DOWN crypto prediction markets using real on-chain wallet balances.
Mainly TypeScript. The stack also includes TypeScript, Node.js, Polygon.
Use, copy, and modify freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.