jeremylongshore/tons-of-skills-marketplace / plugins/crypto/arbitrage-opportunity-finder/skills/finding-arbitrage-opportunities
finding-arbitrage-opportunities
VerifiedCompare live best bid and ask for one crypto pair across exchanges and report every cross-venue spread, gross and net of stated taker fees; search three-trade cycles within one exchange. Read-only, no API keys. Use when checking whether a coin trades at different prices on different exchanges, sizing a spread against fees, or looking for triangular price gaps on OKX, KuCoin or Gate. Trigger with phrases like "find arbitrage", "scan for arb", "price spread", "exchange price difference", "triangular arb", or "cross-exchange spread".
| File | Kind | Size |
|---|---|---|
| ARD.md | markdown | 2.2 KB |
| PRD.md | markdown | 2.4 KB |
| SKILL.md | skill md | 6.0 KB |
| assets/demo-recording.json | config | 42.6 KB |
| references/errors.md | markdown | 2.3 KB |
| references/examples.md | markdown | 12.8 KB |
| references/implementation.md | markdown | 4.4 KB |
| scripts/arb_finder.py | script | 17.7 KB |
| scripts/http_client.py | script | 6.4 KB |
| scripts/record_demo.py | script | 2.1 KB |
| scripts/spot_venues.py | script | 9.9 KB |
| scripts/spreads.py | script | 7.0 KB |
| tests/fixtures/binance-bybit-recording.json | config | 1.4 KB |
| tests/test_arb_finder.py | script | 9.9 KB |
references/errors.md
View on GitHub# Errors and Fixes
The finder never fills a gap with made-up prices. When a request fails, the venue appears under **Unavailable** with one of the reasons below and the remaining venues are still compared. The exit code is 2 when no venue returned a quote.
| Reason shown | Meaning | What to do |
|--------------|---------|------------|
| `refused from this network (HTTP 451, region restriction)` | Binance blocks your country or network | Expected from the US; other venues still report. |
| `refused from this network (HTTP 403, likely a region restriction)` | Bybit blocks your region or VPN exit | As above. |
| `{symbol} not listed` | That venue has no market for the exact pair | Try another quote asset: many venues list USDT but not USD, or the reverse. |
| `{symbol} book looks crossed or empty` | The venue returned a bid above its ask, or zero | Transient; retry. The venue is left out rather than trusted. |
| `rate limited (HTTP 429); wait and retry` | Too many requests | Wait a minute; use a longer `--interval` with `monitor`. |
| `timed out after Ns` | The venue did not answer in time | Retry or raise `--timeout`. |
| `network error: ...` | DNS, TLS or connection failure | Check your connection or proxy. |
| `unexpected response shape (...)` | The venue changed its API | Report it; that venue's adapter needs an update. |
| `no confirmed fee for kucoin; pass --fee kucoin=PERCENT` | Triangular search on a venue whose fee is unknown | Give your fee. |
| `could not read Gate's fee` | Gate's pair listing did not answer | Pass `--fee gate=PERCENT`. |
| `--fee okx=25 looks wrong` | A fee outside 0-5% | Give a percent such as `0.1`, not basis points. |
| `--interval must be at least 5 seconds` | `monitor` polling too fast | Public endpoints rate-limit; use 5 seconds or more. |
| `the bundled demo recording covers ...` | `--demo` with a pair or venue not recorded | Run without `--demo`. |
| `monitor needs live data` | `monitor --demo` | The recording is a single moment; run live. |
## Net shows n/a
The net column is `n/a` when either venue's fee is unknown (KuCoin and Coinbase by default). Pass `--fee kucoin=0.1` (or your actual rate) to fill it in.
## Checking a venue by hand
Every source URL is printed under **Sources** (console) or in `sources` (JSON):
```bash
curl -s "https://www.okx.com/api/v5/market/ticker?instId=BTC-USDT"
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |