binance-signal-engine

# Binance Signal Engine

Multi-timeframe technical analysis signal generator for cryptocurrency markets. Layers three timeframes into a single weighted score and outputs a structured trade plan with position sizing.

## When to Use

Use this skill when the user wants to:

- Analyze any Binance-listed crypto pair technically
- Get a directional bias or trading signal (bullish/bearish/neutral)
- Generate entry, stop-loss, and take-profit levels for a trade
- Check trend regime (1D), momentum (4H), and entry timing (15m)
- Size a position based on account risk parameters
- Scan multiple symbols in one pass
- Get a backtest-ready data row for a symbol

## How It Works

The engine scores three independent timeframe layers and combines them:

**1D — Trend Regime**
EMA structure (9/21/50), ADX with directional indicators (DI+/DI−). Determines whether the macro environment is bullish, bearish, or neutral. This is the directional anchor — momentum and trigger signals are interpreted relative to this regime.

**4H — Momentum**
MACD line vs signal crossovers, histogram direction, and Stochastic Oscillator crosses. Stochastic signals are weighted asymmetrically depending on the regime (e.g. a bullish stoch cross from oversold in a bullish regime scores higher than in a bearish one).

**15m — Entry Trigger**
RSI oversold/overbought reclaims, Bollinger Band re-entries, volume spikes relative to the 20-period moving average, and RSI divergence detection over a 20-bar lookback. This layer determines whether *right now* is a valid entry moment.

Each component contributes a configurable weighted score. The composite maps to a five-tier bias scale: STRONG BULLISH → BULLISH → NEUTRAL → BEARISH → STRONG BEARISH, with corresponding action recommendations (BUY, WATCH LONG, WAIT, WATCH SHORT, SELL/SHORT).

When conditions align, the trade planner generates a full plan using rolling support/resistance levels, ATR-based stops, and configurable risk-reward targets. The position sizer respect...

# Binance Signal Engine

> Multi-timeframe crypto technical analysis signal generator for OpenClaw / ClawHub.

[![ClawHub](https://img.shields.io/badge/ClawHub-binance--signal--engine-blue)](https://clawhub.ai/eplt/binance-signal-engine)
[![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

## What It Does

Binance Signal Engine layers three timeframes (1D / 4H / 15m) into a single weighted technical analysis score for any Binance-listed crypto pair. When conditions align, it generates a complete trade plan with entry, stop-loss, take-profit, and position sizing.

```
═══════════════════════════════════════════════════
  BTC/USDT  |  SPOT  |  Score: 37.0
═══════════════════════════════════════════════════
  Regime : bullish
  Bias   : STRONG BULLISH
  Action : BUY
  Trend  : +25.0  |  Momentum: +7.0  |  Trigger: +5.0

  Signal Reasons:
    • Price > EMA50 (1D)
    • EMA9 > EMA21 (1D)
    • ADX=32.4 strong bullish trend
    • MACD > Signal (4H)
    • MACD histogram rising (4H)
    • RSI reclaimed above oversold (38.2)
    ...

  Trade Plan (READY):
    Side       : long
    Entry_type : market
    Entry      : 97432.10
    Stop_loss  : 95891.30
    Take_profit: 100514.70
    Effective_risk_reward: 2.00

  Position Size:
    Units      : 0.00648
    Notional   : $631.48
    Risk Budget: $100.00
═══════════════════════════════════════════════════
```

## Installation

### Via ClawHub (recommended)

```bash
npx clawhub@latest install binance-signal-engine
```

### Manual

```bash
# Clone into your OpenClaw skills directory
git clone https://github.com/eplt/binance-signal-engine.git \
  ~/.openclaw/skills/binance-signal-engine

# Install Python dependencies
pip install ccxt pandas numpy ta
```

## Usage

### From OpenClaw Chat

Just ask naturally:

- *"Analyze BTC/USDT"*
- *"What's the signal on ETH?"*
- *"Give me a trade setup for SOL/USDT...