find-xemm-opps — Claude Code skill: find XEMM pairs
Compares order book depth across exchanges and ranks pairs where one venue suits quoting and another suits hedging.
npx skills add hummingbot/skills --skill find-xemm-opps -a claude-codeWhat find-xemm-opps does
This skill hunts for cross-exchange market making setups. It reads order books from your connected venues and picks pairs where one exchange shows a wide spread over a thin book — room to quote — while another shows a tight spread over a deep book, which keeps hedging cheap. The gap between mid prices on the two sides is part of the ranking too.
The work happens in scripts/find_xemm_opps.py. You name the pair with --base and --quote, and comma-separated lists work for fungible tokens (--base ETH,WETH). Use --connectors to narrow the venues, --depth for the number of book levels, --min-spread to drop pairs whose mid-price gap is too small, and --json for machine-readable output. Results come as a market table plus a numbered list of pairs, each with a maker side, a hedge side, and the spread and depth ratios between them.
You need a running Hummingbot API and at least two exchange connectors with API keys. Credentials and the endpoint come from HUMMINGBOT_API_URL, API_USER and API_PASS; the script looks for .env in ./hummingbot-api/.env, then ~/.hummingbot/.env, then the current directory. With no API up and no connectors configured, the script has nothing to scan.
What it helps with
- spot a pair worth quoting on a thin book and hedging on a deep one
- line up spreads and book depth from several exchanges in one table
- filter out pairs whose mid-price gap falls under a threshold
- compare maker and taker spread ratios for shortlisted pairs
- export the opportunity list as JSON for a closer look
Example prompts for the agent
- Use find-xemm-opps to scan for XEMM opportunities on SOL/USDT
- Run
python scripts/find_xemm_opps.py --base ETH,WETH --quote USDT,USDCand show me the top pairs - Compare books on binance, kraken and okx for BTC/USDT with a minimum spread of 0.05
How to install find-xemm-opps
1Skills CLI (Vercel)
npx skills add hummingbot/skills --skill find-xemm-opps -a claude-code2Manually: put the files in place
~/.claude/skills/find-xemm-opps/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/find-xemm-opps/
1Skills CLI (Vercel)
npx skills add hummingbot/skills --skill find-xemm-opps -a codex2Manually: put the files in place
.agents/skills/find-xemm-opps/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hummingbot/skills --skill find-xemm-opps -a cursor2Manually: put the files in place
.cursor/skills/find-xemm-opps/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hummingbot/skills find-xemm-opps2Manually: put the files in place
.github/skills/find-xemm-opps/SKILL.md1Skills CLI (Vercel)
npx skills add hummingbot/skills --skill find-xemm-opps -a gemini-cli2Platform CLI
gemini skills install https://github.com/hummingbot/skills --path skills/find-xemm-oppsManually: put the files in place
.devin/skills/find-xemm-opps/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add hummingbot/skills --skill find-xemm-opps -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about find-xemm-opps
How do I install find-xemm-opps in Claude Code?
Run npx skills add hummingbot/skills --skill find-xemm-opps -a claude-code. The skill lands at ~/.claude/skills/find-xemm-opps/SKILL.md.
What does find-xemm-opps do?
It compares order book depth and liquidity across your connected exchanges, then ranks pairs for cross-exchange market making — which venue to quote on and which to hedge on.
What do I need before running it?
A running Hummingbot API and at least two exchange connectors with API keys. Set HUMMINGBOT_API_URL, API_USER and API_PASS for the endpoint and credentials.
