✓ Verified 💻 Development ✓ Enhanced Data

Alpha 1 0 0

Binance Alpha new coin launch detector.

Rating: 5 (159 reviews)
Downloads: 3,135 downloads
Version: 1.0.0

Overview

Binance Alpha new coin launch detector.

Complete Documentation

View Source →

Binance Alpha 新币上线监控

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

工作原理

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

功能特性

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

前提条件

安装依赖

bash

pip3 install websocket-client --user

使用方法

启动监控

bash

python3 scripts/alpha.py monitor

输出示例：

text

🚀 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
======================================================================

查看历史报警

bash

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

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

输出示例：

text

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

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

查看状态

bash

python3 scripts/alpha.py status

输出：

text

📊 当前状态:

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

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

重置监控

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

bash

python3 scripts/alpha.py reset

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

技术实现

WebSocket 数据源

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

数据格式：

json

[
  {
    "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 - 成交额

新币检测逻辑

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

价格验证

通过 Binance REST API 二次确认：

text

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：第一时间发现新币

bash

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

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

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

bash

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

场景3：定期清理数据

bash

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

常见问题

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

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

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

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

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

注意事项

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

参考

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

Installation

Terminal bash


openclaw install alpha-1-0-0

Copied!

💻Code Examples

pip3 install websocket-client --user

pip3-install-websocket-client---user.txt

## 使用方法

### 启动监控

交易对: BTCUSDT

--btcusdt.txt

### 重置监控

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

python3 scripts/alpha.py reset

python3-scriptsalphapy-reset.txt

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

## 技术实现

### WebSocket 数据源

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

**数据格式**：

]

.txt

字段说明：
- `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

get-apiv3tickerpricesymbolxxx.txt

确保交易对已有有效开盘价（价格 > 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：第一时间发现新币

example.txt

🚀 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
======================================================================

example.sh

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

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

example.txt

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

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

example.txt

📊 当前状态:

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

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

example.json

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