telegram-alerts

通过 Telegram 发送格式化的交易提醒、投资组合更新和市场信号。支持价格警报、止损通知、盈利/亏损报告和计划摘要。当您需要 Telegram 交易通知、价格提醒、投资组合更新或自动交易报告时使用。

# Telegram Alerts — Trading Notification System

Send rich trading alerts to Telegram for any crypto event or portfolio update.

## Alert Types
- **Trade alerts**: entry/exit with P&L, entry price, stop, target
- **Price alerts**: trigger when asset crosses threshold
- **Portfolio summaries**: NAV, daily P&L, positions
- **Stop-loss warnings**: drawdown approaching limit
- **Win/loss streaks**: celebration + tilt prevention
- **Scheduled reports**: daily 18:00, weekly Monday

## Usage
```
Use telegram-alerts to send a trade entry notification for BTC LONG at $68,000

Use telegram-alerts to send my daily portfolio summary

Use telegram-alerts to alert me when SOL breaks $90
```

## Format Example
```
🟢 TRADE OPENED
Asset: BTC/USDT | LONG
Entry: $68,247 | Stop: $67,200 | Target: $70,000
Risk: $0.38 (0.05% NAV) | R:R = 1:2.6
```

## Setup
Requires TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID in your .env file.

---

## 中文说明

# Telegram Alerts — 交易通知系统

针对任何加密货币事件或投资组合更新，向 Telegram 发送丰富的交易提醒。

## 提醒类型
- **交易提醒**：进场/出场，附带盈亏、进场价格、止损、目标
- **价格提醒**：当资产突破阈值时触发
- **投资组合摘要**：净值（NAV）、当日盈亏、持仓
- **止损警告**：回撤接近限额
- **连胜/连败**：庆祝 + 防止情绪失控
- **计划报告**：每日 18:00，每周一

## 用法
```
Use telegram-alerts to send a trade entry notification for BTC LONG at $68,000

Use telegram-alerts to send my daily portfolio summary

Use telegram-alerts to alert me when SOL breaks $90
```

## 格式示例
```
🟢 TRADE OPENED
Asset: BTC/USDT | LONG
Entry: $68,247 | Stop: $67,200 | Target: $70,000
Risk: $0.38 (0.05% NAV) | R:R = 1:2.6
```

## 设置
需要在你的 .env 文件中设置 TELEGRAM_BOT_TOKEN 和 TELEGRAM_CHAT_ID。