whatisgithub

What is arbitrage-trading-bot?

shinyatomitsuka/arbitrage-trading-bot — explained in plain English

Analysis updated 2026-05-18

251TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

An automated TypeScript bot that trades Polymarket's UP/DOWN crypto prediction markets using real on-chain wallet balances.

Mindmap

mindmap
  root((repo))
    What it does
      Trades Polymarket UP DOWN markets
      Reads live order book prices
      Uses real on chain balances
    Tech stack
      TypeScript
      Polygon
      TOML config
    Use cases
      Exit only strategy
      Entry and exit strategy
    Audience
      Developers
      Crypto traders
    Setup
      Signer private key
      Funded proxy wallet

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automate an exit-only position strategy on Polymarket UP/DOWN markets.

USE CASE 2

Run a configurable entry-and-exit trading strategy on crypto prediction markets.

USE CASE 3

Monitor live order book prices and on-chain portfolio value from the terminal.

What is it built with?

TypeScriptNode.jsPolygonTOML

How does it compare?

shinyatomitsuka/arbitrage-trading-botrasoir0591/crosshair-xshadowspread/polymarket-auto-trading
Stars251251252
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity4/51/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires a funded Polymarket proxy wallet with USDC on Polygon and a signing private key.

Use, copy, and modify freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

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.

Copy-paste prompts

Prompt 1
Explain how the exit-only strategy in this Polymarket bot decides when to close a position.
Prompt 2
Walk me through setting up a funded Polymarket proxy wallet to run this bot.
Prompt 3
Help me adjust the TOML strategy file to change the price threshold for entering a trade.
Prompt 4
What risks should I understand before running an automated trading bot like this with real funds?

Frequently asked questions

What is arbitrage-trading-bot?

An automated TypeScript bot that trades Polymarket's UP/DOWN crypto prediction markets using real on-chain wallet balances.

What language is arbitrage-trading-bot written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Polygon.

What license does arbitrage-trading-bot use?

Use, copy, and modify freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is arbitrage-trading-bot to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is arbitrage-trading-bot for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.