SkillsAdd

hummingbot/skills

find-arbitrage-opps

Find arbitrage opportunities across exchanges by comparing prices for fungible token pairs like BTC/WBTC and USDT/USDC.

First seen Feb 25, 2026

Installation

$ npx skills add hummingbot/skills --skill find-arbitrage-opps
View on skills.sh ↗ GitHub repository ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

renaissance-statistical-arbitrage Similar name
copyleftdev/sk1llz

Build trading systems in the style of Renaissance Technologies, the most successful quantitativ…

112 installs

Also in this package

Other skills from hummingbot/skills · top by installs.

npx skills add hummingbot/skills
hummingbot-deploy 465 lp-agent 398 connectors-available 394 hummingbot 382 slides-generator 358 hummingbot-developer 343 hummingbot-heartbeat 342 find-xemm-opps 316 create-routine 66 executor-creator 5

Browse all from hummingbot/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 32
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

More metadata
author
hummingbot

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,866 B
  • docs SUMMARY.md 146 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 474 installs

SKILL.md

find-arbitrage-opps

Find arbitrage opportunities across all Hummingbot-connected exchanges by comparing prices for a trading pair, accounting for fungible tokens (e.g., BTC = WBTC, USDT = USDC).

Prerequisites

Hummingbot API must be running with exchange connectors configured:

bash <(curl -s https://raw.githubusercontent.com/hummingbot/skills/main/skills/lp-agent/scripts/check_prerequisites.sh)

DEX Support

By default the script queries CEX connectors via the Hummingbot API. Add --dex to also fetch prices from:

DEX Chain Default Network
Jupiter Solana mainnet-beta
Uniswap Ethereum mainnet
PancakeSwap Ethereum (BSC) bsc

DEX prices are fetched directly via the Hummingbot Gateway. Make sure Gateway is running on http://localhost:15888 (or set GATEWAY_URL).

⚠️ BTC markets are only available to Australian residents on some exchanges. A warning is printed automatically when BTC/WBTC/cbBTC is included in the search.

Workflow

Step 1: Define Token Mappings

User specifies the base and quote tokens, including fungible equivalents:

  • Base tokens: BTC, WBTC, cbBTC (all represent Bitcoin)
  • Quote tokens: USDT, USDC, USD (all represent USD)

Step 2: Find Arbitrage Opportunities

# Basic - CEX only
python scripts/find_arb_opps.py --base BTC --quote USDT

# Include fungible tokens
python scripts/find_arb_opps.py --base BTC,WBTC --quote USDT,USDC

# Include DEX prices (Jupiter + Uniswap via Gateway)
python scripts/find_arb_opps.py --base SOL --quote USDC --dex
python scripts/find_arb_opps.py --base ETH,WETH --quote USDT,USDC --dex

# Minimum spread filter
python scripts/find_arb_opps.py --base SOL --quote USDC --dex --min-spread 0.1

# Filter to specific CEX connectors
python scripts/find_arb_opps.py --base BTC --quote USDT --connectors binance,kraken,coinbase

Step 3: Analyze Results

The script outputs:

  • Prices from each CEX and DEX source
  • Best bid/ask across all sources
  • Arbitrage spread (buy low, sell high)
  • Recommended pairs for arbitrage

Script Options

python scripts/find_arb_opps.py --help
Option Description
--base Base token(s), comma-separated (e.g., BTC,WBTC)
--quote Quote token(s), comma-separated (e.g., USDT,USDC)
--connectors Filter to specific CEX connectors (optional)
--dex Include DEX prices via Gateway (Jupiter + Uniswap)
--min-spread Minimum spread % to show (default: 0.0)
--json Output as JSON

Output Example

============================================================
  SOL / USDC Arbitrage Scanner
  DEX: Jupiter (Solana mainnet-beta), Uniswap (Ethereum mainnet)
============================================================

  Lowest:  binance                   $132.4500
  Highest: jupiter (DEX)             $132.8900
  Spread:  0.332% ($0.4400)
  Sources: 5 prices from 5 sources

  Top Arbitrage Opportunities:
  --------------------------------------------------------
  1. Buy  binance                   @ $132.4500
     Sell jupiter (DEX)             @ $132.8900
     Profit: 0.332% ($0.4400)

Environment Variables

export HUMMINGBOT_API_URL=http://localhost:8000
export API_USER=admin
export API_PASS=admin
export GATEWAY_URL=http://localhost:15888   # for DEX prices

Scripts check for .env in: ./hummingbot-api/.env → ~/.hummingbot/.env → .env

Requirements

  • Hummingbot API running (for CEX prices)
  • Gateway running (for DEX prices with --dex flag)
  • Exchange connectors configured with API keys