Binance SM Indicators Webhook Tool

# 🧪 Binance SM Indicators Webhook Tool – Documentation

A backend webhook processor that performs **real-time indicator calculations** for 15m, 1h, 4h, and 1d Binance candlestick data. This workflow powers all the indicator sub-agents and is essential for maintaining modular and scalable logic across timeframes.

---

## 🎯 Purpose

* Accepts HTTP POST requests from the 15m, 1h, 4h, or 1d sub-agents
* Pulls raw OHLCV kline data for the symbol and interval
* Calculates technical indicators:

  * RSI, MACD, Bollinger Bands, SMA, EMA, ADX
* Returns structured JSON with labeled values (e.g., `"MACD_Cross": "Bullish"`)

This tool ensures **centralized logic reuse** across all timeframe agents while improving speed and maintainability.

---

## ⚙️ Key Components

| Node Name              | Description                                               |
| ---------------------- | --------------------------------------------------------- |
| `Webhook Trigger`      | Handles POST at `/15m-indicators`, `/1h-indicators`, etc. |
| `Extract Symbol`       | Validates input payload (must include `symbol`)           |
| `Fetch Binance Klines` | Gets latest 100 candles using `/api/v3/klines`            |
| `RSI Calculator`       | Computes 14-period RSI from closing prices                |
| `MACD Calculator`      | Computes 12, 26, 9 MACD with signal and histogram         |
| `BBANDS Calculator`    | Calculates 20-period bands using std. deviation           |
| `SMA/EMA Node`         | Computes 20-period simple and exponential MAs             |
| `ADX Calculator`       | Computes 14-period trend strength (DI+/DI− included)      |
| `Prepare Output`       | Returns JSON with all labeled indicators                  |

---

## 📥 Expected Input (from sub-agent)

```json
{
  "symbol": "BTCUSDT"
}
```

Must be a valid Binance Spot trading pair. Interval is auto-routed based on webhook endpoint:

| Endpoint Path     | Interval |
| ----------------- | -------- |
| `/15m-indicators` | 15m      |
| `/1h-indicators`  | 1h       |
| `/4h-indicators`  | 4h       |
| `/1d-indicators`  | 1d       |

---

## 📊 Sample Output JSON

```json
{
  "symbol": "BTCUSDT",
  "interval": "4h",
  "rsi": 65.1,
  "macd": {
    "value": 24.3,
    "signal": 21.7,
    "histogram": 2.6,
    "cross": "Bullish"
  },
  "bb": {
    "basis": 62600,
    "upper": 63500,
    "lower": 61700,
    "status": "Expanding"
  },
  "sma": 62000,
  "ema": 62400,
  "adx": {
    "value": 32.8,
    "strength": "Strong"
  }
}
```

---

## 🧩 Use Case Scenarios

| Scenario                                   | Result                                                   |
| ------------------------------------------ | -------------------------------------------------------- |
| 15m tool POSTs to `/15m-indicators`        | Webhook responds with 15m indicator set                  |
| Financial Analyst Tool requests 1h signals | This workflow handles the actual math for each indicator |
| 1d tool needs RSI + MACD + ADX             | Centralized logic avoids duplication across agents       |

---

## 🛠️ Installation Instructions

### 1. Import & Activate

* Import JSON into n8n
* Ensure webhook is live and accessible
* Test each endpoint (e.g., `/1h-indicators`) via POST

### 2. Connect to Binance API

* Public API: no credentials required
* Ensure the HTTP request node for klines uses:

  ```
  https://api.binance.com/api/v3/klines
  ```

### 3. Link to Sub-Agent Workflows

* 15m, 1h, 4h, 1d tools all depend on this for logic
* Must POST `symbol` to the correct interval endpoint

---

## 📦 Example Workflow Integration

All the following tools rely on this:

* `Binance SM 15min Indicators Tool`
* `Binance SM 1hour Indicators Tool`
* `Binance SM 4hour Indicators Tool`
* `Binance SM 1day Indicators Tool`

This acts as the math engine behind each.

---

## 🔐 Licensing & Support

🔗 **Don Jayamaha – LinkedIn**
[http://linkedin.com/in/donjayamahajr](http://linkedin.com/in/donjayamahajr)

© 2025 Treasurium Capital Limited Company. All rights reserved.
The design, architecture, and indicator calculation code within this system are proprietary. Reuse, resale, or modification without license is strictly prohibited.