S
SkillNav

binance-alert

by cnwpdb

Binance smart alert system. Monitors price/change alerts, new listings, Alpha airdrop opportunities, and HODLer announcements via Telegram. No Binance API Key required.

View Chinese version with editor review

安装

claude skill add --url github.com/openclaw/skills/tree/main/skills/cnwpdb/binance-alert

文档

BinanceAlert

Monitors Binance market events and pushes real-time alerts via Telegram.

Required Environment Variables

VariableDescription
TG_BOT_TOKENTelegram Bot Token (from @BotFather)
TG_CHAT_IDTelegram target Chat ID

The script reads these from /data/freqtrade/user_data/.secrets.env automatically, or from system environment variables directly.

Price Alert

bash
python3 {baseDir}/scripts/binance_alert.py price <SYMBOL> <target_price> [above|below]

Example: alert when BTC breaks $100,000

bash
python3 {baseDir}/scripts/binance_alert.py price BTCUSDT 100000 above

Change Alert (24h %)

bash
python3 {baseDir}/scripts/binance_alert.py change <SYMBOL> <threshold_pct>

Example: alert when ETH moves more than 8% in 24h

bash
python3 {baseDir}/scripts/binance_alert.py change ETHUSDT 8

New Listing Monitor

bash
python3 {baseDir}/scripts/binance_alert.py listing

Alpha Airdrop Scanner

bash
python3 {baseDir}/scripts/binance_alert.py alpha

Scans Binance Web3 Alpha tokens, scores by KYC holders, alpha points multiplier, and market cap.

Announcement Monitor (HODLer Airdrops)

bash
python3 {baseDir}/scripts/binance_alert.py announcement

Run All Checks (for cron/timer)

bash
python3 {baseDir}/scripts/binance_alert.py run

Status

bash
python3 {baseDir}/scripts/binance_alert.py status

Notes

  • Requires TG_BOT_TOKEN and TG_CHAT_ID (read from .secrets.env or system env)
  • State persisted to /data/freqtrade/user_data/binance_alert_state.json
  • Price/change alerts auto-mark as triggered after firing, no duplicate pushes
  • New listing monitor initializes baseline on first run, no push
  • Recommended: run via systemd timer every 5 minutes using the run command