hummingbot find-xemm-opps
Find Cross-Exchange Market Making (XEMM) opportunities by analyzing order book depth and liquidity across connected exchanges.
XEMM involves quoting on one exchange (the maker side) while hedging fills on another (the taker/hedge side). The best opportunities exist where:
- One exchange has a wide spread and thin book (maker side — room to quote profitably)
- Another has a tight spread and deep book (taker side — cheap to hedge)
- A mid-price difference exists between them
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)
Workflow
Step 1: Define Token Pair
# Scan for SOL/USDT XEMM opportunities
python scripts/find_xemm_opps.py --base SOL --quote USDT
# Include fungible equivalents
python scripts/find_xemm_opps.py --base ETH,WETH --quote USDT,USDC
# Filter to specific connectors
python scripts/find_xemm_opps.py --base BTC --quote USDT --connectors binance,kraken,coinbase,okx
# Minimum mid-price spread between exchanges (default: 0.0%)
python scripts/find_xemm_opps.py --base SOL --quote USDC --min-spread 0.05
Step 2: Interpret Results
The script outputs a market overview table and ranked XEMM opportunity pairs:
====================================================================
XEMM Opportunities — SOL / USDC
Order book depth: 20 levels | Sources: 18
====================================================================
Exchange Pair Mid Spread Bid Depth Ask Depth B/A
---------------------- -------------- ---------- -------- ------------ ------------ ------
bitstamp SOL-USDC $87.45 0.120% $23.4K $18.9K 1.24
binance SOL-USDT $87.51 0.015% $412.0K $389.0K 1.06
okx SOL-USDT $87.56 0.023% $287.0K $301.0K 0.95
...
Top XEMM Opportunities (MAKER → hedge on TAKER):
----------------------------------------------------------------
#1 Score: 8.42
MAKER bitstamp $87.45 spread 0.120% depth $42.3K
TAKER binance $87.51 spread 0.015% depth $801.0K
Mid-price gap: 0.0686% | Spread ratio: 8.0x | Depth ratio: 18.9x
Columns explained:
| Column | Description |
|---|---|
| Mid | Mid-price between best bid and ask |
| Spread | Bid-ask spread as % of mid |
| Bid/Ask Depth | Total quote value of top-N order book levels |
| B/A | Bid-to-ask depth ratio (>1 = more buy pressure) |
| Spread ratio | Maker spread ÷ taker spread — higher = better maker edge |
| Depth ratio | Taker depth ÷ maker depth — higher = better hedge liquidity |
Script Options
| Option | Description |
|---|---|
--base |
Base token(s), comma-separated (e.g., ETH,WETH) |
--quote |
Quote token(s), comma-separated (e.g., USDT,USDC) |
--connectors |
Filter to specific connectors (optional) |
--depth |
Order book depth per exchange (default: 20) |
--min-spread |
Minimum mid-price spread % between exchanges (default: 0.0) |
--include-btc-markets |
Include btc_markets (Australian residents only) |
--include-ndax |
Include ndax (Canadian residents only) |
--json |
Output as JSON |
Environment Variables
export HUMMINGBOT_API_URL=http://localhost:8000
export API_USER=admin
export API_PASS=admin
Scripts check for .env in: ./hummingbot-api/.env → ~/.hummingbot/.env → .env
Requirements
- Hummingbot API running
- At least 2 exchange connectors configured with API keys