finding-arbitrage-opportunities
Detect profitable arbitrage opportunities across CEX, DEX, and cross-chain markets in real-time. Use when scanning for price spreads, finding arbitrage paths, comparing exchange prices, or analyzing triangular arbitrage opportunities. Trigger with phrases like "find arbitrage", "scan for arb", "price spread", "exchange arbitrage", "triangular arb", "DEX price difference", or "cross-exchange opportunity".
- License 许可
- MIT
- 最近更新
- 2026-05-26
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- finding-arbitrage-opportunities
- author
- Jeremy Longshore <jeremy@intentsolutions.io>
- license
- MIT
- version
- 1.0.0
- description
- Detect profitable arbitrage opportunities across CEX, DEX, and cross-chain markets in real-time. Use when scanning for price spreads, finding arbitrage paths, comparing exchange prices, or analyzing triangular arbitrage opportunities. Trigger with phrases like "find arbitrage", "scan for arb", "price spread", "exchange arbitrage", "triangular arb", "DEX price difference", or "cross-exchange opportunity".
- allowed-tools
- Read, Write, Edit, Grep, Glob, Bash(crypto:arbitrage-*)
- compatible-with
- claude-code, codex, openclaw
02 资源文件 12
- 参考文档ARD.md15.1 KB
- 参考文档config/settings.yaml7.9 KB
- 参考文档PRD.md7.1 KB
- 参考文档references/errors.md6.1 KB
- 参考文档references/examples.md13.0 KB
- 参考文档references/implementation.md3.1 KB
- 脚本scripts/arb_finder.py12.0 KB
- 脚本scripts/formatters.py13.1 KB
- 脚本scripts/opportunity_scanner.py11.2 KB
- 脚本scripts/price_fetcher.py12.2 KB
- 脚本scripts/profit_calculator.py12.2 KB
- 脚本scripts/triangular_finder.py11.2 KB
03 SKILL.md 正文
Finding Arbitrage Opportunities
Overview
Detect and analyze arbitrage opportunities across cryptocurrency exchanges and DeFi protocols. Aggregates prices from CEX and DEX sources, calculates net profit after fees, and identifies direct, triangular, and cross-chain arbitrage paths.
Prerequisites
- Python 3.9+ with
httpx,rich, andnetworkxpackages - Internet access for API calls (no API keys required for basic use)
- Optional: Exchange API keys for real-time order book access
- Understanding of arbitrage concepts and trading fees
Instructions
-
Quick spread scan on a specific pair:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDCShows current prices per exchange, spread %, estimated profit after fees, and recommended action.
-
Multi-exchange comparison across specific exchanges:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC \ --exchanges binance,coinbase,kraken,kucoin,okx -
DEX price comparison across decentralized exchanges:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC --dex-onlyCompares Uniswap V3, SushiSwap, Curve, Balancer with gas cost estimates.
-
Triangular arbitrage discovery within a single exchange:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py triangular binance --min-profit 0.5 -
Cross-chain opportunities across different blockchains:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py cross-chain USDC \ --chains ethereum,polygon,arbitrum -
Real-time monitoring with threshold alerts:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py monitor ETH USDC \ --threshold 0.5 --interval 5 -
Export opportunities for bot integration:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC --output json > opportunities.json
Output
- Quick mode (default): Best opportunity with profit estimate, buy/sell recommendation, risk level
- Detailed mode (
--detailed): All exchange prices, fee breakdown, slippage estimates, historical spread context - Monitor mode: Real-time updates with threshold alerts and trend indicators
See ${CLAUDE_SKILL_DIR}/references/implementation.md for exchange fee tables and output format examples.
Error Handling
| Error | Cause | Fix |
|---|---|---|
| Rate limited | Too many API requests | Reduce polling frequency or add API key |
| Stale prices | Data older than 10s | Flagged with warning; retry |
| No spread | Efficient market pricing | Normal condition; try different pairs |
| Insufficient liquidity | Trade exceeds order book depth | Reduce trade size |
Examples
Quick ETH/USDC spread scan - Find best buy/sell across all CEX exchanges:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC
Sample detection output:
ARB OPPORTUNITY: ETH/USDC
Buy: Binance @ $3,198.50 | Sell: Coinbase @ $3,214.20
Spread: 0.49% | Net Profit (after fees): 0.29% ($9.27 per ETH)
Risk: LOW | Confidence: HIGH | Window: ~30s
Triangular arb on Binance - Discover circular paths with minimum 0.5% net profit:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py triangular binance --min-profit 0.5
Cross-chain USDC opportunities - Compare stablecoin prices across L1/L2 chains:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py cross-chain USDC --chains ethereum,polygon,arbitrum
Calculate exact profit - Detailed fee breakdown for a specific trade:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py calc \
--buy-exchange binance --sell-exchange coinbase --pair ETH/USDC --amount 10 # 10 = trade size in ETH
Resources
- CoinGecko API - Free price data
- CCXT Library - Unified exchange API
- Uniswap Subgraph - DEX data
${CLAUDE_SKILL_DIR}/references/implementation.md- Exchange fee tables, configuration, advanced arbitrage types, disclaimer
04 同仓库更多 Skills
zustand-store-ts
Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state/action separation. Use when building React state management, creating global stores, or implementing reactive state patterns with Zustand.
zustand-store-creator
Zustand Store Creator - Auto-activating skill for Frontend Development. Triggers on: zustand store creator, zustand store creator Part of the Frontend Development skill category.
zero-trust-config-helper
Zero Trust Config Helper - Auto-activating skill for Security Advanced. Triggers on: zero trust config helper, zero trust config helper Part of the Security Advanced skill category.
zapier-integration-helper
Zapier Integration Helper - Auto-activating skill for Business Automation. Triggers on: zapier integration helper, zapier integration helper Part of the Business Automation skill category.
zai-cli
Execute z.AI CLI providing vision, search, reader, and GitHub exploration via CLI and MCP. Use when user needs image/video analysis, OCR, UI-to-code conversion, error diagnosis, real-time web search, web page to markdown extraction, or GitHub code exploration. Trigger with phrases like "analyze this image", "search the web for", "read this page", "explore this repo", or "use zai". Requires Z_AI_API_KEY.
yt-research
Research competitor YouTube channels, niches, and trending topics for your content strategy. Use this skill whenever the user says "research channels", "analyze competitors", "find trending topics", "niche analysis", "competitive research", "what are other creators doing", "scrape YouTube channels", or wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.