finding-arbitrage-opportunities
Scans multiple crypto exchanges for price spreads and arbitrage opportunities.
Install
mkdir -p .claude/skills/finding-arbitrage-opportunities && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/1603" && unzip -o skill.zip -d .claude/skills/finding-arbitrage-opportunities && rm skill.zipInstalls to .claude/skills/finding-arbitrage-opportunities
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Detect profitable arbitrage opportunities across CEX, DEX, and cross-chainKey capabilities
- →Scan for price spreads on specific cryptocurrency pairs
- →Compare prices across multiple centralized exchanges
- →Compare prices across decentralized exchanges including gas costs
- →Discover triangular arbitrage opportunities within a single exchange
- →Identify cross-chain arbitrage opportunities for stablecoins
- →Monitor arbitrage opportunities in real-time with threshold alerts
How it works
The skill aggregates cryptocurrency prices from CEX and DEX sources, then calculates net profit after fees for direct, triangular, and cross-chain arbitrage paths. It provides real-time monitoring and export options for identified opportunities.
Inputs & outputs
When to use finding-arbitrage-opportunities
- →Scan for price spreads between exchanges
- →Calculate arbitrage profit after trading fees
- →Identify triangular arbitrage paths
- →Compare DEX and CEX prices in real-time
About this skill
Finding Arbitrage Opportunities
Overview
Compare one exact pair's best bid and ask across nine exchanges and compute every cross-venue spread, gross and net of stated taker fees. A triangular search checks three-trade cycles inside one venue.
Venues: Kraken, Coinbase, KuCoin, Gate, OKX, Bitfinex, Crypto.com, Binance, Bybit. Binance and Bybit refuse US networks (HTTP 451/403); the tool names them and carries on.
Pairs with different quote assets are never compared: BTC/USD against BTC/USDT measures the USDT/USD rate, not an arbitrage.
Prerequisites
- Python 3.9 or newer. Standard library only: no packages, no API keys.
- Network access to the exchanges' public endpoints.
Instructions
All commands run python3 ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py. Every command accepts --format json, --fee VENUE=PERCENT (the actual account taker fee), --demo (bundled recorded data, marked on every line) and --timeout SECONDS.
-
Scan one pair across venues:
python3 ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan BTC USDT python3 ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USD --venues kraken,coinbase,bitfinex,gate -
Set actual account fees (fees vary by tier, region and token discounts):
python3 ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan BTC USDT --fee coinbase=0.6 --fee kucoin=0.1 -
Express the best net spread in money for a trade size in base units:
python3 ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan SOL USDT --amount 25 # 25 = trade size in SOL -
Search triangles on one venue (okx, kucoin, gate), using pairs above a 24-hour volume floor:
python3 ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py triangular okx python3 ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py triangular kucoin --fee kucoin=0.1 --min-volume-usd 250000 # 250000 = USD volume floor -
Watch a pair for a few minutes (minimum interval 5 seconds):
python3 ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py monitor BTC USDT --interval 15 --count 8 --threshold 0 -
See fee assumptions and their sources:
arb_finder.py venues.
When reporting, give the spreads with the fee assumptions and the "not included" list below. Describe what the data shows; never recommend a trade.
Output
Console tables end with sources and the line "Research output only. Not financial advice. This tool places no trades." JSON output is one envelope with skill, version, command, generated_at, mode (live or demo), sources, failures, data, not_included and disclaimer.
Every spread excludes withdrawal and network fees, the time to move funds between venues, price moves in that time, and depth beyond the best bid and ask. A positive net spread at the top of the book is not a collectable amount.
Fee assumptions are base-tier spot taker fees taken from each venue's published schedule (dates and sources in arb_finder.py venues). Gate's is read live from its API. KuCoin and Coinbase do not show a base-tier fee without a login, so their net column reads n/a until --fee sets it. Details: references/implementation.md.
Error Handling
| Message | Cause | What to do |
|---|---|---|
refused from this network (HTTP 451/403 ...) | Binance or Bybit blocks the region | Nothing; other venues still report |
BTC-USD not listed (or similar) | The venue has no market for that exact pair | Try another quote asset (USD, USDT, USDC) |
no confirmed fee for kucoin | Triangular search needs a fee | Pass --fee kucoin=PERCENT |
rate limited (HTTP 429) | Too many requests | Raise --interval, wait a minute |
the bundled demo recording covers ... | --demo with something not recorded | Run without --demo |
| Exit code 2 | No venue returned data | Read the "Unavailable" list |
More in references/errors.md.
Examples
Cross-venue BTC/USDT check (an excerpt of captured live output; full runs with their capture time are in references/examples.md, and live figures change every minute):
python3 ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan BTC USDT --top 3
Buy Sell Gross Net of fees Size at best
bitfinex okx +0.0293% -0.3208% 1.35507 BTC
bitfinex coinbase +0.0291% n/a 0.0109 BTC
bitfinex cryptocom +0.0258% -0.4743% 0.3817 BTC
No venue pair stays positive after assumed taker fees.
Triangles on OKX as JSON:
python3 ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py triangular okx --format json
Try it offline:
python3 ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan BTC USDT --demo
Resources
references/implementation.md: endpoints, formulas, fee sources, what is not coveredreferences/examples.md: real output for every commandreferences/errors.md: error messages and fixes- Tests:
python3 -m unittest discover -s tests -v(offline) - Refresh the demo recording:
python3 scripts/record_demo.py
When not to use it
- →When the market is efficient and shows no spread
- →When trade size exceeds order book depth
Prerequisites
Limitations
- →Rate limits can occur with too many API requests
- →Prices may become stale if data is older than 10 seconds
- →Insufficient liquidity can prevent large trades
How it compares
This skill automates the aggregation of market data and calculation of net profits for various arbitrage strategies, unlike manual price comparison across multiple exchange interfaces.
Compared to similar skills
finding-arbitrage-opportunities side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| finding-arbitrage-opportunities (this skill) | 3 | 4mo | Review | Intermediate |
| quant-analyst | 103 | 6mo | No flags | Advanced |
| stock-analyzer | 71 | 5mo | Review | Beginner |
| google-analytics | 43 | 10mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by jeremylongshore
View all by jeremylongshore →You might also like
quant-analyst
zenobi-us
Expert quantitative analyst specializing in financial modeling, algorithmic trading, and risk analytics. Masters statistical methods, derivatives pricing, and high-frequency trading with focus on mathematical rigor, performance optimization, and profitable strategy development.
stock-analyzer
FrancyJGLisboa
Provides comprehensive technical analysis for stocks and ETFs using RSI, MACD, Bollinger Bands, and other indicators. Activates when user requests stock analysis, technical indicators, trading signals, or market data for specific ticker symbols.
google-analytics
davila7
Analyze Google Analytics data, review website performance metrics, identify traffic patterns, and suggest data-driven improvements. Use when the user asks about analytics, website metrics, traffic analysis, conversion rates, user behavior, or performance optimization.
data-engineering
pluginagentmarketplace
ETL pipelines, Apache Spark, data warehousing, and big data processing. Use for building data pipelines, processing large datasets, or data infrastructure.
math-tools
ananddtyagi
Deterministic mathematical computation using SymPy. Use for ANY math operation requiring exact/verified results - basic arithmetic, algebra (simplify, expand, factor, solve equations), calculus (derivatives, integrals, limits, series), linear algebra (matrices, determinants, eigenvalues), trigonometry, number theory (primes, GCD/LCM, factorization), and statistics. Ensures mathematical accuracy by using symbolic computation rather than LLM estimation.
crawl4ai
basher83
This skill should be used when users need to scrape websites, extract structured data, handle JavaScript-heavy pages, crawl multiple URLs, or build automated web data pipelines. Includes optimized extraction patterns with schema generation for efficient, LLM-free extraction.