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 max | 10% stop-loss | $10M min volume
══════════════════════════════════════════════════════════════════════
Signal Coin Rate 24h Vol($M) Score Annual(3x)
────────────────────────────────────────────────────────────────
🟢 STRONG DOGE -0.0125% 2.34% 145.2 72.3 41%
🟡 MODERATE SOL -0.0089% -1.12% 89.5 48.7 29%
⚪ WATCH XRP -0.0056% -2.45% 67.3 35.2 18%
🏆 推荐操作:
DOGE: 开多 3x | 止损 10% | 费率 -0.0125% | 年化 41%
══════════════════════════════════════════════════════════════════════
📁 历史记录: data/funding-monitor/scan_history.jsonl
```
## Safety Rules
Based on real trading experience:
- **Max Leverage**: 3x (reduces liquidation risk)
- **Position Sizing**: ≤30% per coin (diversification)
- **Stop Loss**: 10% minimum (capital preservation)
- **Volume Filter**: Only liquid markets ($10M+)
- **Trend Check**: Prefer positive 24h momentum
- **No Panic Trading**: Skip during extreme volatility
## Data Storage
Scan results are saved to:
```
~/.openclaw/workspace/data/funding-monitor/scan_history.jsonl
```
Each line contains:
```json
{
"timestamp": "2026-02-26T06:21:00.000Z",
"results": [...],
"config": {...}
}
```
## Command-Line Options
```bash
node scan.js [options]
Options:
--max-leverage <n> Maximum leverage (default: 3)
--min-volume <n> Minimum 24h volume in USD (default: 10000000)
--stop-loss <n> Stop-loss percentage (default: 0.10)
--min-rate <n> Minimum absolute funding rate (default: 0.0005)
--max-coins <n> Maximum simultaneous positions (default: 5)
--coins <list> Comma-separated coin list (default: built-in list)
--output <path> Custom output directory
```
## Integration Examples
### Telegram Alert
```bash
node scan.js | grep "🟢 STRONG" && openclaw message send --target @me --message "Strong funding opportunity detected!"
```
### Discord Webhook
```bash
RESULT=$(node scan.js)
curl -X POST $DISCORD_WEBHOOK -H "Content-Type: application/json" -d "{\"content\":\"$RESULT\"}"
```
### Custom Script
```javascript
const { exec } = require('child_process');
exec('node scan.js', (err, stdout) => {
const lines = stdout.split('\n');
const strong = lines.filter(l => l.includes('🟢 STRONG'));
if (strong.length > 0) {
// Your custom logic here
console.log('Opportunities found:', strong);
}
});
```
## Disclaimer
This tool is for informational purposes only. Cryptocurrency trading involves substantial risk of loss. Always:
- Do your own research
- Never invest more than you can afford to lose
- Use proper risk management
- Test strategies with small amounts first
- Understand funding rate mechanics before trading
## Requirements
- Node.js 14+
- Internet connection
- No API keys needed for scanning
## Support
For issues or feature requests, visit the ClawHub repository or contact the skill author.
## License
MIT
## Keywords
crypto, trading, funding-rate, binance, futures, arbitrage, defi, scanner, alert, monitoring, negative-funding, long-position, risk-management, automated-trading, cryptocurrency
标签
skill
ai
