Crypto Market

核心功能

crypto 是一款基于 CCXT 库的加密货币市场数据工具，提供多维度行情监控能力。核心功能包括：实时价格查询（ticker）、历史K线数据获取（ohlcv）、订单簿深度查看（orderbook）、持续价格监控（watch）以及多条件价格预警系统（alert-add/check/remove）。

显著优点

1. 多交易所聚合：原生支持 Binance、OKX、Bybit、Gate.io、KuCoin、Coinbase、Kraken 等 9+ 主流交易所，便于跨平台比价
2. 灵活的预警机制：支持价格突破（above/below）、涨跌幅百分比（up/down_percent）两类触发条件，覆盖关键价位监控和波动率追踪场景
3. 零门槛使用：纯公共 API 调用，无需注册 API Key 即可获取行情数据
4. 配置持久化：预警规则存储于 ~/.config/crypto/alerts.json，支持手动批量管理
5. 开源生态依托：基于成熟的 CCXT 库（GitHub 30k+ stars），交易所接口维护活跃

局限性与风险

1. 功能边界：仅提供行情读取，不支持交易执行、资产查询或账户操作，无法替代完整交易工具
2. 数据延迟：公共 API 存在请求频率限制，实时监控 --interval 最低 5 秒，非真正的 WebSocket 流式推送
3. 预警非实时：依赖轮询机制（需手动或定时运行 alert-check），可能错过瞬间价格波动
4. 网络依赖：部分地区访问 Binance、OKX 等交易所 API 需翻墙
5. 无移动端/通知：仅命令行输出，无邮件/短信/Push 等外部通知渠道

适合人群

• 轻度持币者：快速查看持仓币种价格
• 短线交易者：设置关键支撑/阻力位突破提醒
• 套利观察者：跨交易所比价监控
• 自动化爱好者：结合 cron/systemd 实现定时巡检

常规风险

• 市场风险：加密货币价格波动剧烈，预警触发不代表交易建议
• 技术风险：CCXT 版本更新可能导致交易所接口变动，需及时升级
• 隐私风险：配置文件中可能记录关注的交易对，注意文件权限保护

核心用法

crypto 是一款命令行加密货币行情工具，基于 Python 的 CCXT 库实现。核心功能覆盖三类场景：

1. 行情查询：支持 ticker（实时价格/涨跌幅）、ohlcv（K线历史数据）、orderbook（买卖盘深度）三种数据模式，默认 Binance，可切换 OKX、Bybit、KuCoin 等 9 家主流交易所。

2. 实时监控：watch 命令以 5-10 秒间隔轮询价格，适合盯盘场景。

3. 智能预警：alert-add 支持四种条件——价格突破（above/below）、涨跌幅百分比（up_percent/down_percent），预警配置持久化存储于 ~/.config/crypto/alerts.json，通过 alert-check 手动触发检测。

显著优点

• 交易所覆盖广：集成 9 家主流交易所，便于跨所比价
• 零配置上手：无需 API Key 即可查询公开行情数据
• 预警机制灵活：支持绝对价格与百分比双维度监控
• 依赖成熟可靠：CCXT 为加密货币领域标准库（GitHub 40k+ stars），API 封装完善
• 数据本地存储：预警配置仅写入本地 JSON，无隐私泄露风险

潜在局限

• 无自动推送：预警仅通过命令行输出，无邮件/短信/推送通知
• 需手动轮询：alert-check 需用户主动执行或配合 cron 定时任务
• T3 来源可信度：个人开发者项目，无 GitHub 历史可追溯，长期维护存疑
• 无交易功能：仅限行情监控，不支持下单、资产管理等交易操作
• API 限流敏感：高频监控可能触发交易所频率限制

适合人群

• 轻度持币者或定投用户，需简单价格提醒
• 多交易所套利者，需快速比价
• 技术型投资者，习惯命令行工具且熟悉 cron 自动化

常规风险

1. 市场波动风险：预警触发时价格可能已大幅偏离，不构成交易建议
2. API 可用性风险：交易所 API 变更或维护可能导致数据中断
3. 配置权限风险：预警文件以默认 umask 权限创建，多用户环境需注意隔离
4. 依赖更新滞后：CCXT 版本过旧可能导致新交易对或 API 端点不支持

安全认证摘要

安全等级 S（得分 85），静态与动态分析均无高危发现。网络流量仅限 HTTPS 加密的主流交易所 API，无危险函数调用。主要注意事项：CCXT 需用户自行安装并定期更新；配置文件建议设置 600 权限加固。