alpha

Binance Alpha 新币上线监控

通过 WebSocket 实时监听 Binance 所有交易对行情，第一时间发现新上线的加密货币。

工作原理

1. WebSocket 连接 - 连接 Binance 流式 API (!miniTicker@arr)
2. Symbol 检测 - 维护 known_symbols 集合，检测新出现的交易对
3. 价格验证 - 通过 REST API 确认交易对已有有效开盘价
4. 实时报警 - 立即输出新币上线信息

功能特性

• ⚡ 实时检测 - WebSocket 流式数据，毫秒级延迟
• 🎯 精准过滤 - 自动过滤系统 symbol 和无效数据
• ✅ 价格确认 - 双重验证确保交易对已开放交易
• 💾 状态持久化 - 保存已知交易对和历史报警记录
• 🔄 自动重连 - 断线自动重连，确保监控不中断

前提条件

安装依赖

pip3 install websocket-client --user

使用方法

启动监控

python3 scripts/alpha.py monitor

输出示例：

🚀 Binance Alpha 新币上线监控
==================================================
📂 已加载 1847 个已知交易对
✅ WebSocket 连接成功
📊 开始监控... 已知交易对: 1847 个
⏳ 等待新币上线...

======================================================================
🚀🚀🚀 新币上线 detected! 🚀🚀🚀
======================================================================
⏰ 检测时间: 2024-02-03T15:42:18.123456
🪙 交易对: BTCUSDT
💰 当前价格: 43250.50
📊 开盘价: 43100.00
📈 24h涨跌: 150.50 (0.35%)
📦 24h成交量: 15234.56
💵 24h成交额: 658923456.78
======================================================================

查看历史报警

# 查看最近 20 条
python3 scripts/alpha.py history

# 查看最近 50 条
python3 scripts/alpha.py history --limit 50

输出示例：

📜 历史报警记录 (最近 3 条):

⏰ 2024-02-03T15:42:18.123456
🪙 BTCUSDT
💰 价格: 43250.50
📊 涨跌: 0.35%
--------------------------------------------------
⏰ 2024-02-03T14:30:22.654321
🪙 ETHUSDT
💰 价格: 2650.30
📊 涨跌: 1.20%
--------------------------------------------------

查看状态

python3 scripts/alpha.py status

输出：

📊 当前状态:

  已知交易对数量: 1847
  历史报警数量: 15
  状态文件位置: /Users/xxx/.config/alpha

  最近报警:
    时间: 2024-02-03T15:42:18.123456
    交易对: BTCUSDT

重置监控

如果需要重新开始监控（清除所有历史记录）：

python3 scripts/alpha.py reset

⚠️ 警告：这将清除所有已知交易对和历史报警记录！

技术实现

WebSocket 数据源

连接地址：wss://stream.binance.com:9443/ws/!miniTicker@arr

数据格式：

[
  {
    "e": "24hrMiniTicker",
    "E": 1234567890123,
    "s": "BTCUSDT",
    "c": "43250.50",
    "o": "43100.00",
    "h": "43500.00",
    "l": "42800.00",
    "v": "15234.56",
    "q": "658923456.78"
  },
  ...
]

字段说明：

• s - Symbol (交易对)
• c - 最新价格
• o - 开盘价
• h - 最高价
• l - 最低价
• v - 成交量
• q - 成交额

新币检测逻辑

1. 接收 !miniTicker@arr 推送的所有交易对数据
2. 提取每个数据包中的 s (symbol) 字段
3. 检查 symbol 是否在 known_symbols 集合中
4. 如果不在集合中，通过 REST API 确认价格有效性
5. 确认有效后触发报警，并加入 known_symbols

价格验证

通过 Binance REST API 二次确认：

GET /api/v3/ticker/price?symbol=XXX

确保交易对已有有效开盘价（价格 > 0）。

配置文件

状态文件存储位置：~/.config/alpha/

• known_symbols.json - 已知的交易对集合
• alerts_history.json - 历史报警记录（最近100条）

命令参考

命令	功能	示例
monitor	启动监控	alpha.py monitor
history	查看历史	alpha.py history --limit 50
status	查看状态	alpha.py status
reset	重置数据	alpha.py reset

运行环境

• Python 3.7+
• 网络连接（能访问 Binance）
• 无需 API Key（使用公开 WebSocket 流）

使用场景

场景1：第一时间发现新币

# 保持监控运行
python3 scripts/alpha.py monitor

# 当有新币上线时，立即在终端看到报警

场景2：追踪历史新币表现

# 查看最近发现的新币
python3 scripts/alpha.py history --limit 10

场景3：定期清理数据

# 每周重置一次，重新统计
python3 scripts/alpha.py reset

常见问题

错误：websocket-client 库未安装 → 运行: pip3 install websocket-client --user

连接断开 → 程序会自动重连，无需手动干预

误报（显示已存在的币） → 运行 alpha.py reset 重置数据

没有报警 → 确认 Binance 确实有新币上线，检查网络连接

如何集成到通知系统 → 修改 alert_new_coin 函数，添加邮件/短信/钉钉等通知逻辑

注意事项

1. 网络要求 - 需要能访问 Binance 的 WebSocket 服务
2. 内存占用 - 维护的 symbol 集合约占用几 MB 内存
3. 误报可能 - 偶尔可能因为网络问题产生重复报警
4. 仅限现货 - 监控的是现货交易对，不包含合约

参考

• Binance WebSocket API: https://binance-docs.github.io/apidocs/spot/en/#websocket-market-streams
• miniTicker 文档: references/binance_ws.md