crypto-funding-alert

# Crypto Funding Rate Alert

Real-time cryptocurrency funding rate scanner that identifies profitable opportunities with negative funding rates on Binance futures markets.

## Features

- **Smart Scanning**: Monitors 40+ major cryptocurrencies for negative funding rates
- **Risk Management**: Built-in safety filters (volume, leverage limits, stop-loss)
- **Scoring System**: Combines funding rate, price trend, and trading volume
- **Signal Classification**: STRONG / MODERATE / WATCH alerts
- **No API Key Required**: Uses public Binance API endpoints
- **Historical Tracking**: Saves scan results to JSONL for analysis

## How It Works

When funding rates are negative, longs receive payments from shorts. This creates a profitable opportunity to:
1. Open a long position
2. Collect funding fees every 8 hours
3. Benefit from potential price appreciation

The scanner filters opportunities by:
- Minimum absolute funding rate (0.05%)
- Minimum 24h volume ($10M)
- Price trend analysis
- Composite scoring algorithm

## Usage

### Basic Scan

```bash
node scan.js
```

### With Custom Config

```bash
node scan.js --max-leverage 2 --min-volume 20000000 --stop-loss 0.15
```

### Automated Monitoring (Cron)

```bash
# Add to OpenClaw cron - scan every 4 hours
openclaw cron add "0 */4 * * *" "cd ~/.openclaw/workspace/skills/crypto-funding-alert && node scan.js"
```

## Configuration

Edit the `SAFE_CONFIG` object in `scan.js`:

```javascript
const SAFE_CONFIG = {
  maxLeverage: 3,          // Maximum leverage (1-5x recommended)
  maxPositionPct: 0.3,     // Max position size (30% of capital)
  stopLossPct: 0.10,       // Stop-loss percentage (10%)
  minVolume: 10000000,     // Minimum 24h volume ($10M)
  minAbsRate: 0.0005,      // Minimum funding rate (0.05%)
  maxCoins: 5,             // Max simultaneous positions
};
```

## Output Example

```
🔍 Safe Funding Rate Monitor | 2026-02-26T06:21:00.000Z
══════════════════════════════════════════════════════════════════════
Safety: 3x m...

# Crypto Funding Rate Alert

Real-time cryptocurrency funding rate scanner for Binance futures markets.

## Quick Start

```bash
node scan.js
```

## What It Does

Scans 40+ cryptocurrencies for negative funding rates (where longs get paid by shorts) and identifies profitable opportunities based on:
- Funding rate magnitude
- 24h price trend
- Trading volume
- Risk management filters

## Installation

```bash
cd ~/.openclaw/workspace/skills
clawhub install crypto-funding-alert
```

## Usage

See [SKILL.md](./SKILL.md) for full documentation.

## Safety First

- Max 3x leverage
- 10% stop-loss minimum
- Only liquid markets ($10M+ volume)
- Position sizing limits
- Trend-aware filtering

## License

MIT