# flashbots/simple-arbitrage

Example arbitrage bot using Flashbots

Repository: https://github.com/flashbots/simple-arbitrage
Canonical: https://ross.abutalabs.com/products/simple-arbitrage
Language: TypeScript
License Family: other
Last push: 2024-02-03T18:32:10+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2079, "days_push": 942, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2111, forks 759 (observed 2026-08-28T04:06:14.268288+00:00)

## What it is
An example TypeScript arbitrage bot that discovers, evaluates, and submits arbitrage bundles to the Flashbots relay on Ethereum. It serves primarily as reference code for building custom Flashbots searchers rather than as a profitable production bot.

## Use cases
- learn how to submit bundles to the Flashbots relay
- build a custom MEV searcher bot on Ethereum
- run a simple DEX arbitrage bot
- integrate Flashbots into an existing trading bot
- understand bundle execution with a BundleExecutor contract

## When to choose
- you want a minimal working example of Flashbots searcher integration
- you are learning MEV and bundle submission mechanics
- you need a starting template for your own arbitrage bot

## When to avoid
- you expect profitable arbitrage out of the box
- you need a production-hardened, audited trading system
- you operate on chains other than Ethereum mainnet

## Facets
- artifact type: application
- maturity: maintenance
- function: trading, sdk, developer-tools
- domain: blockchain, fintech
- platform: cli
- tags: flashbots, mev, arbitrage-bot, ethereum, searcher, example-code, cryptocurrency, nodejs

## Member repositories
- flashbots/simple-arbitrage (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:14.268288+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:53:43.557177+00:00, confidence not recorded.
  - readme: https://github.com/flashbots/simple-arbitrage (fetched 2026-08-28T04:06:14.268288+00:00, sha d09c1a6a1e18)
- Data as of 2026-08-30T08:39:29.467469+00:00.