用途
该技能用于检测和分析加密货币交易所与 DeFi 协议之间的套利机会。它从多个来源聚合价格，扣除手续费与成本后计算净利润，并识别直接套利与三角套利路径。
主要能力
- 快速价差扫描：针对特定交易对扫描各交易所价格、价差百分比、扣除手续费后的预估利润及建议操作。
- 多交易所对比：在指定交易所之间比较价格，输出买价、卖价、价差与净利润。
- DEX 价格比较：比较 Uniswap V3、SushiSwap、Curve、Balancer 等去中心化交易所的价格，并包含链上执行的 gas 成本估算。
- 三角套利发现：在单一交易所内寻找可盈利的循环路径，例如 ETH → BTC → USDT → ETH，并展示毛利、手续费与净利。
- 跨链机会：比较不同区块链（如 ethereum、polygon、arbitrum）上的价格，展示各链价格、跨链桥费用与时间、扣除跨链成本后的净利润。
- 实时监控：持续监控机会，当价差超过阈值时发出提醒。
- 利润计算器：针对具体交易计算毛利、双方交易手续费、提现费、净利润与盈亏平衡价差。
- JSON 导出：将机会导出为 JSON，便于机器人集成。
使用方式
前置条件：Python 3.9+，并安装 httpx、rich、networkx 包；需要联网进行 API 调用（基础使用无需 API 密钥）；可选提供交易所 API 密钥以获取实时订单簿；需理解套利概念与交易手续费。
步骤 1：在 {baseDir}/config/settings.yaml 中配置数据源，例如启用 coingecko 并设置 base_url 与 rate_limit，列出 exchanges（binance、coinbase、kraken、kucoin、okx）。也可通过环境变量设置 API 密钥，如 export BINANCE_API_KEY="your-key"、export COINBASE_API_KEY="your-key"。
步骤 2：快速价差扫描：python {baseDir}/scripts/arb_finder.py scan ETH USDC
步骤 3：多交易所对比：python {baseDir}/scripts/arb_finder.py scan ETH USDC --exchanges binance,coinbase,kraken,kucoin,okx
步骤 4：DEX 价格比较：python {baseDir}/scripts/arb_finder.py scan ETH USDC --dex-only
步骤 5：三角套利发现：python {baseDir}/scripts/arb_finder.py triangular binance --min-profit 0.5
步骤 6：跨链机会：python {baseDir}/scripts/arb_finder.py cross-chain USDC --chains ethereum,polygon,arbitrum
步骤 7：实时监控：python {baseDir}/scripts/arb_finder.py monitor ETH USDC --threshold 0.5 --interval 5
步骤 8：利润计算：python {baseDir}/scripts/arb_finder.py calc --buy-exchange binance --sell-exchange coinbase --pair ETH/USDC --amount 10
步骤 9：JSON 导出：python {baseDir}/scripts/arb_finder.py scan ETH USDC --output json > opportunities.json
输出模式
- 快速模式（默认）：最佳机会及利润估算、买卖建议、风险等级指示。
- 详细模式（--detailed）：所有交易所价格、费用明细、滑点估算、历史价差背景。
- 监控模式：实时更新、阈值提醒、趋势指标。
支持的交易所
中心化交易所（CEX）及其挂单/吃单手续费：Binance 0.10%/0.10%；Coinbase 0.40%/0.60%；Kraken 0.16%/0.26%；KuCoin 0.10%/0.10%；OKX 0.08%/0.10%。提现费用均为 Variable（浮动）。
去中心化交易所（DEX）：Uniswap V3 费率 0.01-1%，gas（ETH）约 150k，支持 ETH、Polygon、Arbitrum；SushiSwap 费率 0.30%，gas 约 150k，多链；Curve 费率 0.04%，gas 约 200k，支持 ETH、Polygon、Arbitrum；Balancer 费率 0.01-10%，gas 约 180k，支持 ETH、Polygon、Arbitrum。
错误处理
详见 {baseDir}/references/errors.md。常见问题包括：Rate Limited（降低轮询频率或使用 API 密钥）、Stale Prices（数据超过 10 秒会标记警告）、No Spread（所有交易所价格相近，市场有效）、Insufficient Liquidity（交易规模超过订单簿深度）。
示例
详见 {baseDir}/references/examples.md，包含 ETH/USDC CEX 套利扫描、DEX 三角套利发现、跨链 USDC 机会、自动化监控设置等。
限制与风险
官方声明：仅供教育用途。套利交易涉及显著风险：机会可能在执行前消失；价格数据可能延迟或不准确；小额交易中手续费可能超过利润；市场状况变化迅速。该工具仅提供分析，不理解风险请勿交易。
资源
CoinGecko API（免费价格数据）、CCXT Library（统一交易所 API）、Uniswap Subgraph（DEX 数据）、Gas Tracker（以太坊 gas 价格）。