← Back to Skills Marketplace
Crypto Arbitrage Monitor
by
OceanKing57
· GitHub ↗
· v1.0.0
· MIT-0
141
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install crypto-arb-monitor
Description
加密货币跨交易所套利监控器 - 实时监控BTC/ETH/SOL等主流币种在不同交易所的价差,发现套利机会并发送飞书/Telegram预警。支持自动计算手续费后净利润。
README (SKILL.md)
Crypto Arbitrage Monitor 🔍💰
跨交易所加密货币套利机会监控器
实时监控主流加密货币在不同交易所之间的价格差异,发现套利机会并推送预警。
功能特性
- ✅ 支持 Binance / OKX / Bybit / Huobi 等主流交易所
- ✅ 监控 BTC / ETH / SOL / XRP / DOGE 等热门币种
- ✅ 自动计算扣除手续费后的净利润
- ✅ 飞书/Telegram实时预警推送
- ✅ 可配置价差阈值和监控频率
- ✅ 历史套利机会记录和统计
快速开始
1. 安装依赖
pip install ccxt requests python-dotenv
2. 配置
# config.py
CONFIG = {
"exchanges": ["binance", "okx", "bybit"],
"symbols": ["BTC/USDT", "ETH/USDT", "SOL/USDT", "XRP/USDT", "DOGE/USDT"],
"min_spread_percent": 0.5, # 最小价差百分比(扣除手续费后)
"trading_fee_percent": 0.1, # 单边手续费百分比
"check_interval_seconds": 60, # 检查间隔
"alert_channels": {
"feishu_webhook": "", # 飞书机器人webhook地址
"telegram_bot_token": "", # Telegram Bot Token
"telegram_chat_id": "", # Telegram Chat ID
}
}
3. 运行
python monitor.py
使用场景
| 场景 | 说明 |
|---|---|
| 手动套利 | 发现价差后手动在两个交易所分别买卖 |
| 网格交易辅助 | 配合网格策略,在价差扩大时增加仓位 |
| 市场监控 | 了解不同交易所的流动性差异 |
| 量化策略输入 | 将价差数据作为量化交易信号 |
套利计算公式
净利润 = (高价交易所卖出价 - 低价交易所买入价) / 低价交易所买入价 × 100% - 2 × 手续费%
只有当净利润 > 阈值时才触发预警。
风险提示
- ⚠️ 价差可能在执行过程中消失(执行风险)
- ⚠️ 需要两个交易所都有资金(资金效率)
- ⚠️ 提币/转账需要时间(时间风险)
- ⚠️ 交易所可能有提币限制(流动性风险)
- ⚠️ 本工具仅供监控参考,不构成投资建议
文件结构
crypto-arb-monitor/
├── SKILL.md # 技能说明
├── monitor.py # 主监控脚本
├── config.py # 配置文件
├── alerts.py # 预警推送模块
├── requirements.txt # Python依赖
└── README.md # 使用说明
版本历史
- v1.0.0 (2026-03-21): 初始版本,支持多交易所价差监控
Usage Guidance
This skill appears to implement cross‑exchange price monitoring and alerting as claimed, but there are several red flags to address before running it with real credentials:
- Documentation/code mismatch: SKILL.md and README reference files (config.py, alerts.py) and use of dotenv that are not present; the shipped monitor.py embeds Config. Review the full monitor.py to confirm what it does (the provided snippet was truncated here).
- Secret handling: The instructions lead you to paste Feishu webhook and Telegram bot token/chat_id into the config/source file. Do NOT commit secrets to source control. Prefer environment variables or a secrets manager and avoid plain-text credentials in files.
- Network behavior: The program makes outbound calls to exchange public APIs (via ccxt) and to Feishu/Telegram endpoints — this is expected, but verify the webhook URLs you provide and use test/dummy webhooks first.
- Logging: The script writes arb_monitor.log in the working directory; logs may contain sensitive timestamps/prices — store logs securely or rotate them.
- Dependency trust: It uses common PyPI packages (ccxt, requests). Install from PyPI only and consider pinning versions.
- Operational risks: The tool is monitoring-only (no trading). Do not assume it will execute trades. Be aware of race/latency and execution risks described in the README.
Actions before installing: inspect the complete monitor.py source (ensure there is no hidden exfiltration or obfuscated code), clarify where/how to store secrets safely, run first with dummy webhooks, and run in an isolated environment (container/VM) if you plan to add real credentials. If you want, I can list specific lines to inspect or suggest a safer config pattern using environment variables.
Capability Analysis
Type: OpenClaw Skill
Name: crypto-arb-monitor
Version: 1.0.0
The skill bundle is a legitimate cryptocurrency arbitrage monitor that uses the industry-standard 'ccxt' library to track price differences across exchanges. The code in monitor.py and the instructions in SKILL.md are consistent with the stated purpose, containing no evidence of data exfiltration, hardcoded malicious endpoints, or prompt injection. It requires users to provide their own alert webhooks/tokens and does not request sensitive exchange API keys.
Capability Assessment
Purpose & Capability
The code uses ccxt to fetch tickers and requests to post Feishu/Telegram alerts, which matches the stated purpose. Nothing in the code requires unrelated cloud credentials. Minor mismatches: SKILL.md / README mention additional files (config.py, alerts.py) and more exchanges than the included Config, but the single monitor.py implements the functionality.
Instruction Scope
SKILL.md instructs installing python-dotenv and shows a config.py-based workflow, but the shipped package contains no config.py or alerts.py — Config is embedded in monitor.py. The docs encourage pasting webhook/bot tokens into a file (monitor.py or config), which risks secret leakage (e.g., accidental commits). The instructions do not ask to read unrelated files or system secrets, but the mismatch between docs and code is confusing and unsafe in practice.
Install Mechanism
No install spec is provided (instruction-only), and dependencies are standard PyPI packages (ccxt, requests, python-dotenv). This is typical and low-risk, but SKILL.md/README recommend installing python-dotenv even though the provided monitor.py does not use dotenv; this inconsistency should be clarified.
Credentials
No environment variables or external credentials are declared by the registry metadata. The tool requires webhook URLs and Telegram bot token/chat_id to send alerts, which is proportional to its purpose. However, the code/documentation encourage placing these secrets directly in source/config files instead of using secure env vars or secret stores, increasing risk of accidental exfiltration or repository leakage.
Persistence & Privilege
The skill does not request elevated privileges or persistent platform-wide presence (always:false). It writes a local log file ('arb_monitor.log') and runs continuously if invoked; this is consistent with a monitoring tool and not excessive.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install crypto-arb-monitor - After installation, invoke the skill by name or use
/crypto-arb-monitor - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Crypto Arbitrage Monitor v1.0.0
- 首次发布,支持 BTC/ETH/SOL/XRP/DOGE 等币种的跨 Binance、OKX、Bybit、Huobi 等主流交易所的实时套利监控
- 支持自动扣除手续费后净利润计算与套利机会预警
- 集成飞书和 Telegram 实时推送功能
- 支持灵活配置币种、交易所、价差阈值及监控频率
- 提供历史套利机会记录和统计功能
Metadata
Frequently Asked Questions
What is Crypto Arbitrage Monitor?
加密货币跨交易所套利监控器 - 实时监控BTC/ETH/SOL等主流币种在不同交易所的价差,发现套利机会并发送飞书/Telegram预警。支持自动计算手续费后净利润。 It is an AI Agent Skill for Claude Code / OpenClaw, with 141 downloads so far.
How do I install Crypto Arbitrage Monitor?
Run "/install crypto-arb-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Crypto Arbitrage Monitor free?
Yes, Crypto Arbitrage Monitor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Crypto Arbitrage Monitor support?
Crypto Arbitrage Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Crypto Arbitrage Monitor?
It is built and maintained by OceanKing57 (@oceanking57); the current version is v1.0.0.
More Skills