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 |
ARD.md
View on GitHub# ARD: Arbitrage Opportunity Finder
> Part of [Tons of Skills](https://tonsofskills.com) by [Intent Solutions](https://intentsolutions.io) | [jeremylongshore.com](https://jeremylongshore.com)
## Architecture
```text
arb_finder.py command line, console tables, JSON envelope
├── spot_venues.py nine top-of-book adapters → Quote (bid, ask, sizes, fee + source)
├── spreads.py cross-venue spread arithmetic; triangular search on one venue
└── http_client.py urllib requests, failure reasons with error bodies, record/replay
```
## Decisions
| Decision | Choice | Why |
|----------|--------|-----|
| Data source | Public order-book and ticker endpoints, no keys | Traceable to a URL; nothing to configure |
| Pair matching | Exact pair only | USD, USDT and USDC markets differ by stablecoin rates, which are not arbitrage |
| Fees | Published base-tier taker fee per venue with source; Gate read live; unknown left unknown | A guessed fee would make the net column look precise when it is not |
| Size | Smaller of ask size and bid size at the best prices | A spread on 0.0002 BTC is not the same finding as one on 1 BTC |
| Not-listed detection | Read error bodies (Bitfinex returns 500, Gate and Binance 400 for unknown symbols) | Distinguishes "no market" from "exchange down" |
| HTTP | Standard library + thread pool | No install step; a scan takes about a second |
| Demo and tests | Replay recorded real responses through the same parsers | Exercises real parsing offline |
| Removed | DEX, cross-chain, execution code, flash loans, `MOCK_PRICES` | No keyless source for DEX quotes; execution is out of scope for a research tool |
## Security
- Read-only GET requests; no credentials accepted.
- `tests/test_arb_finder.py::TestReadOnly` fails if any script references order, account, withdrawal, private or signing endpoints, or makes a POST request.
## Testing
`python3 -m unittest discover -s tests -v` replays `assets/demo-recording.json` (real responses from a US network) and `tests/fixtures/binance-bybit-recording.json` (real Binance and Bybit responses recorded from a network they serve), plus hand-built quotes for the spread and triangle arithmetic.
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 |