Finding Arbitrage Opportunities

What it does

When your agent uses it

• Scanning for price spreads
• Finding arbitrage paths
• Comparing exchange prices
• Analyzing triangular arbitrage opportunities

Example prompts

• “find arbitrage”
• “scan for arb”
• “price spread”
• “/finding-arbitrage-opportunities”

Requirements

• Python 3
• A credential in BINANCE_API_KEY
• A credential in COINBASE_API_KEY
• Pre-approved tools (allowed-tools): Read, Write, Edit, Grep, Glob, Bash(crypto:arbitrage-*)

Workflow steps

9 steps, taken from the step headings in SKILL.md.

1. 1Configure Data Sources
2. 2Quick Spread Scan
3. 3Multi-Exchange Comparison
4. 4DEX Price Comparison
5. 5Triangular Arbitrage Discovery
6. 6Cross-Chain Opportunities
7. 7Real-Time Monitoring
8. 8Profit Calculator
9. 9JSON Export

What it can do on your machine

Read from SKILL.md and the folder at commit 7cefd81. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Write
  • Edit
  • Grep
  • Glob
  • Bash(crypto:arbitrage-*)

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 6 files in scripts/ (Python), which the agent can run.

  Shell commands in SKILL.md call:

  • python

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • api.coingecko.com

  Also links to:

  • coingecko.com
  • github.com
  • thegraph.com
  • etherscan.io

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • BINANCE_API_KEY
  • COINBASE_API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Finding Arbitrage Opportunities loads about 1.6k tokens when it runs, and up to ~9.4k if it reads all its reference files. Until then it costs about 148 tokens; SKILL.md has 494 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~148

When it runs · the whole SKILL.md, loaded when a task matches

~1.6k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~9.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from aAAaqwq/AGI-Super-Team at commit 7cefd81, republished under its MIT licence (© aAAaqwq). 494 words, ~1,639 tokens.

name

finding-arbitrage-opportunities

description

This skill detects and analyzes arbitrage opportunities across cryptocurrency exchanges and DeFi protocols. It aggregates prices from multiple sources 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-*)

version

1.0.0

author

Jeremy Longshore <jeremy@intentsolutions.io>

license

MIT

# Primary data sources
data_sources:
  coingecko:
    enabled: true
    base_url: "https://api.coingecko.com/api/v3"
    rate_limit: 10  # calls per minute (free tier)

exchanges:
  - binance
  - coinbase
  - kraken
  - kucoin
  - okx

export BINANCE_API_KEY="your-key"
export COINBASE_API_KEY="your-key"

python {baseDir}/scripts/arb_finder.py scan ETH USDC

python {baseDir}/scripts/arb_finder.py scan ETH USDC \
  --exchanges binance,coinbase,kraken,kucoin,okx

python {baseDir}/scripts/arb_finder.py scan ETH USDC --dex-only

python {baseDir}/scripts/arb_finder.py triangular binance --min-profit 0.5

Path: ETH → BTC → USDT → ETH
Gross: +0.82%
Fees:  -0.30% (3 × 0.10%)
─────────────────────────────
Net:   +0.52%

python {baseDir}/scripts/arb_finder.py cross-chain USDC \
  --chains ethereum,polygon,arbitrum

python {baseDir}/scripts/arb_finder.py monitor ETH USDC \
  --threshold 0.5 \
  --interval 5

[ALERT] ETH/USDC spread 0.62% (Binance → Coinbase)
        Buy: $2,541.20 | Sell: $2,556.98
        Net Profit: +$12.34 (after fees)

python {baseDir}/scripts/arb_finder.py calc \
  --buy-exchange binance \
  --sell-exchange coinbase \
  --pair ETH/USDC \
  --amount 10

python {baseDir}/scripts/arb_finder.py scan ETH USDC --output json > opportunities.json

© aAAaqwq, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 12 other files (scripts, references) in skills/arbitrage-opportunity-finder of aAAaqwq/AGI-Super-Team.

• SKILL.md
• ARD.md
• PRD.md
• config/settings.yaml
• references/errors.md
• references/examples.md
• references/implementation.md
• scripts/arb_finder.py
• scripts/formatters.py
• scripts/opportunity_scanner.py
• scripts/price_fetcher.py
• scripts/profit_calculator.py
• scripts/triangular_finder.py

Open the folder on GitHubat commit 7cefd81