arb-scanner
starsforks
How to install arb-scanner?
draguris/dragonclaw/arb-scanner
$npx -y skills add draguris/dragonclaw --skill arb-scannerMonitor token prices across Binance, Aster, PancakeSwap, Four.meme, and GMGN simultaneously. Detect price gaps and auto-trade or alert when spread exceeds threshold. Use when user asks about arbitrage, price differences between exchanges, cross-exchange comparison, or mentions 套利
SKILL.md
| 1 | # Cross-Exchange Arbitrage Scanner |
| 2 | |
| 3 | ## When to Use |
| 4 | |
| 5 | - User asks about price differences between exchanges |
| 6 | - User wants arbitrage opportunities between DEX and CEX |
| 7 | - User asks to compare a token price across platforms |
| 8 | - User mentions 套利, 价差, 搬砖, arbitrage, or spread |
| 9 | |
| 10 | ## DragonClaw Exclusive |
| 11 | |
| 12 | Nobody else has visibility into 5 platforms at once. Binance spot, Aster futures, PancakeSwap DEX, Four.meme, and GMGN — all checked simultaneously, every 5 seconds, for every token you configure. |
| 13 | |
| 14 | ## How It Works |
| 15 | |
| 16 | 1. **Configure tokens**: Provide the same token's identifiers across platforms |
| 17 | 2. **Parallel price fetch**: All 5 platforms queried simultaneously every 5 seconds |
| 18 | 3. **Spread calculation**: Find cheapest and most expensive price |
| 19 | 4. **Threshold check**: Alert if spread exceeds configured minimum (default 2%) |
| 20 | 5. **Auto-trade** (optional): Buy on cheap platform, sell on expensive one |
| 21 | 6. **History tracking**: Record spread data for pattern analysis |
| 22 | |
| 23 | ## Commands |
| 24 | |
| 25 | ### Add Token to Monitor |
| 26 | |
| 27 | ```tool |
| 28 | {"tool": "arb_scanner", "action": "addToken", "params": { |
| 29 | "symbol": "PEPE", |
| 30 | "binanceSymbol": "PEPEUSDT", |
| 31 | "asterSymbol": "PEPEUSDT", |
| 32 | "pancakeAddress": "0x...", |
| 33 | "pancakeChain": "bsc", |
| 34 | "gmgnAddress": "...", |
| 35 | "gmgnChain": "sol" |
| 36 | }} |
| 37 | ``` |
| 38 | |
| 39 | Not all platforms needed — the scanner uses whatever you provide. |
| 40 | |
| 41 | ### Quick Price Check (one-shot) |
| 42 | |
| 43 | ```tool |
| 44 | {"tool": "arb_scanner", "action": "checkPrice", "params": { |
| 45 | "symbol": "BTC", |
| 46 | "binanceSymbol": "BTCUSDT", |
| 47 | "asterSymbol": "BTCUSDT" |
| 48 | }} |
| 49 | ``` |
| 50 | |
| 51 | ### Start Scanner |
| 52 | |
| 53 | ```tool |
| 54 | {"tool": "arb_scanner", "action": "start", "config": { |
| 55 | "minSpreadPercent": 2.0, |
| 56 | "autoTrade": false, |
| 57 | "pollIntervalMs": 5000 |
| 58 | }} |
| 59 | ``` |
| 60 | |
| 61 | ### Stop Scanner |
| 62 | |
| 63 | ```tool |
| 64 | {"tool": "arb_scanner", "action": "stop"} |
| 65 | ``` |
| 66 | |
| 67 | ### View Active Alerts |
| 68 | |
| 69 | ```tool |
| 70 | {"tool": "arb_scanner", "action": "alerts"} |
| 71 | ``` |
| 72 | |
| 73 | ### View Spread History |
| 74 | |
| 75 | ```tool |
| 76 | {"tool": "arb_scanner", "action": "history", "params": {"symbol": "PEPE", "limit": 20}} |
| 77 | ``` |
| 78 | |
| 79 | ### Status |
| 80 | |
| 81 | ```tool |
| 82 | {"tool": "arb_scanner", "action": "status"} |
| 83 | ``` |
| 84 | |
| 85 | ## Config Options |
| 86 | |
| 87 | | Option | Default | Description | |
| 88 | |--------|---------|-------------| |
| 89 | | pollIntervalMs | 5000 | Price check frequency (5s) | |
| 90 | | minSpreadPercent | 2.0 | Min gap to trigger alert | |
| 91 | | autoTrade | false | Auto-execute arb trades | |
| 92 | | tradeAmountUsdt | 50 | USDT equivalent per arb | |
| 93 | | maxTradesPerHour | 5 | Rate limit | |
| 94 | | cooldownPerPairMs | 300000 | 5 min cooldown per pair | |
| 95 | | trackHistory | true | Record spread data | |
| 96 | |
| 97 | ## Example Conversations |
| 98 | |
| 99 | ``` |
| 100 | 用户: 帮我监控 PEPE 在各个平台的价差 |
| 101 | 龙爪: 已添加 PEPE 到套利监控: |
| 102 | |
| 103 | Binance: PEPEUSDT ✓ |
| 104 | Aster: PEPEUSDT ✓ |
| 105 | PancakeSwap: 0x... (BSC) ✓ |
| 106 | GMGN: ... (Solana) ✓ |
| 107 | Four.meme: 未配置 |
| 108 | |
| 109 | 最低价差阈值: 2% |
| 110 | 扫描频率: 每 5 秒 |
| 111 | |
| 112 | 开始监控... |
| 113 | ``` |
| 114 | |
| 115 | ``` |
| 116 | [套利机会通知] |
| 117 | |
| 118 | 套利机会检测 |
| 119 | |
| 120 | 代币: $PEPE |
| 121 | 价差: 3.47% |
| 122 | |
| 123 | 最低: PancakeSwap @ $0.00001234 |
| 124 | 最高: Binance @ $0.00001277 |
| 125 | |
| 126 | 全平台报价: |
| 127 | PancakeSwap $0.00001234 |
| 128 | GMGN-sol $0.00001241 |
| 129 | Aster $0.00001268 |
| 130 | Binance $0.00001277 |
| 131 | |
| 132 | 发送 "执行套利 PEPE" 手动操作 |
| 133 | ``` |
| 134 | |
| 135 | ``` |
| 136 | 用户: BTCUSDT 在 Binance 和 Aster 差多少？ |
| 137 | 龙爪: BTC 跨平台价格: |
| 138 | |
| 139 | Binance: $67,234.50 |
| 140 | Aster: $67,198.20 |
| 141 | |
| 142 | 价差: 0.054% ($36.30) |
| 143 | 低于 2% 阈值，暂无套利机会。 |
| 144 | ``` |
| 145 | |
| 146 | ## Display Guidelines |
| 147 | |
| 148 | ### Price Comparison |
| 149 | ``` |
| 150 | $TOKEN 跨平台价格: |
| 151 | |
| 152 | Binance $X.XXXXXX |
| 153 | Aster $X.XXXXXX |
| 154 | PancakeSwap $X.XXXXXX |
| 155 | GMGN-sol $X.XXXXXX |
| 156 | Four.meme $X.XXXXXX |
| 157 | |
| 158 | 价差: X.XX% |
| 159 | 最低: PLATFORM @ $X.XX |
| 160 | 最高: PLATFORM @ $X.XX |
| 161 | ``` |
| 162 | |
| 163 | ### Arb Alert |
| 164 | ``` |
| 165 | 套利机会检测 |
| 166 | |
| 167 | 代币: $TOKEN |
| 168 | 价差: X.XX% |
| 169 | 买入: PLATFORM @ $X.XXXXXX |
| 170 | 卖出: PLATFORM @ $X.XXXXXX |
| 171 | 预估利润: $X.XX (per $50) |
| 172 | ``` |
| 173 | |
| 174 | ### Trade Execution |
| 175 | ``` |
| 176 | 套利交易完成 |
| 177 | |
| 178 | 代币: $TOKEN |
| 179 | 价差: X.XX% |
| 180 | 买入: PLATFORM @ $X.XX → 哈希: 0x... |
| 181 | 卖出: PLATFORM @ $X.XX |
| 182 | 预估利润: $X.XX |
| 183 | |
| 184 | 累计套利: X 次 · 总利润: $X.XX |
| 185 | ``` |
| 186 | |
| 187 | ## Safety Rules |
| 188 | |
| 189 | 1. Auto-trade is OFF by default |
| 190 | 2. 5 minute cooldown per token pair after each trade |
| 191 | 3. Max 5 trades per hour |
| 192 | 4. Spread must exceed configured threshold |
| 193 | 5. Does not account for gas fees, slippage, or withdrawal fees — user should factor these in |
| 194 | 6. CEX-DEX arb has withdrawal time risk — prices may change during transfer |
| 195 | |
| 196 | ## Cross-Skill Integration |
| 197 | |
| 198 | - **Binance**: Spot prices as baseline reference |
| 199 | - **Aster**: Futures prices for futures-spot basis analysis |
| 200 | - **PancakeSwap**: DEX price via subgraph |
| 201 | - **Four.meme**: New BSC meme token prices pre-graduation |
| 202 | - **GMGN**: Solana/BSC/Base DEX prices |
| 203 | - **Whale mirror**: When a whale causes price impact on one platform, arb opportunity opens on others |
| 204 | - **Douyin pipeline**: Viral trend → price spike on DEX before CEX → arb window |
| 205 | |
| 206 | ## Config (dragonclaw.yaml) |
| 207 | |
| 208 | ```yaml |
| 209 | arbScanner: |
| 210 | enabled: false |
| 211 | minSpreadPercent: 2.0 |
| 212 | autoTrade: false |
| 213 | tradeAmountUsdt: 50 |
| 214 | pollIntervalMs: 5000 |
| 215 | tokens |
People who liked this also viewed
6 picksType
- find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 2026
- grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026
- vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026
- improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026
- setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026
- triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026
