find-arbitrage-opps
Find arbitrage opportunities across exchanges by comparing prices for fungible token pairs like BTC/WBTC and USDT/USDC.
By hummingbot · 474 installs
npx skills add hummingbot/skills --skill find-arbitrage-opps
Source repository · Upstream listing
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:
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
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
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
Environment Variables
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