Documenti Scaricamento
Home / Docs / Caratteristiche principali e utilizzo / Guida all’integrazione RedisMarketBridge | Architettura di trading crypto multi-bot senza limiti

Guida all’integrazione RedisMarketBridge | Architettura di trading crypto multi-bot senza limiti

MagicTradeBot v6.0 — Guida all'integrazione di RedisMarketBridge

Dati di mercato in tempo reale. Zero chiamate API per bot. Nessun rischio di limitazione della velocità.

Prodotto MagicTradeBot v6.0
Modulo Integrazione RedisMarketBridge
Livello Gratuito (3 exchange) · Pro (12 exchange)
Supporto discord.gg/magictradebot · support@magictradebot.com

Indice

  1. Introduzione
  2. Panoramica dell'architettura
  3. Prerequisiti
  4. Installazione & Configurazione
  5. Attivazione di Redis in MagicTradeBot
  6. Esecuzione di bot multipli
  7. Schema delle chiavi Redis
  8. Modelli di distribuzione
  9. Configurazione del motore dei segnali
  10. Risoluzione dei problemi
  11. Passaggio alla versione Pro
  12. Riferimento rapido

1. Introduzione

MagicTradeBot v6.0 introduce l'integrazione nativa con Redis, consentendo un'architettura fondamentalmente nuova per l'esecuzione simultanea di più bot. Connettendosi a RedisMarketBridge come livello di dati di mercato condiviso, ogni bot della tua flotta legge i dati di mercato live da Redis invece di chiamare direttamente le API degli exchange — indipendentemente dal numero di bot in esecuzione.

Perché è importante

Senza Redis: 10 bot su Binance = consumo di limiti di velocità 10 volte superiore. 100 bot = throttling quasi certo.

Con Redis: 1.000 bot su Binance = lo stesso singolo slot di limite di velocità usato da RedisMarketBridge. I tuoi bot sono invisibili all'exchange.

RedisMarketBridge è l'unica fonte di verità. Tutti i bot consumano i dati da esso in microsecondi — senza round trip di rete, nessuna chiave API necessaria per bot.

1.1 Cos'è RedisMarketBridge?

RedisMarketBridge è una pipeline di dati di mercato self-hosted, open source (MIT) che:

  • Si connette a 12 exchange simultaneamente utilizzando un worker parallelo dedicato per exchange
  • Recupera e normalizza i dati di mercato: ticker, kline, tassi di funding, movimento del book degli ordini, spread tra exchange
  • Elabora i dati attraverso una pipeline a 6 fasi — dal tick grezzo al segnale strutturato con gestione TTL
  • Scrive tutto in Redis utilizzando uno schema di chiavi coerente leggibile da qualsiasi linguaggio
  • Calcola i segnali — RSI, MACD, Bande di Bollinger, VWAP, CVD, OFI — e li memorizza insieme ai dati grezzi

1.2 Come MagicTradeBot v6.0 Lo Usa

Quando la modalità Redis è abilitata in MagicTradeBot, ogni istanza del bot cambia la sua strategia di recupero dei dati:

Modalità Fonte dei dati
Redis disabilitato (comportamento v5) Ogni bot chiama direttamente le API dell'exchange ad ogni tick
Redis abilitato (v6.0) Tutti i bot leggono dall'istanza Redis condivisa popolata da RedisMarketBridge

La logica di trading, l'elaborazione dei segnali, il piazzamento degli ordini e la gestione del rischio sono invariati. Cambia solo il livello di acquisizione dei dati — e la differenza di prestazioni è drammatica.


2. Panoramica dell'architettura

2.1 Lo Stack Completo

API Binance   ──→  Thread worker RMB  ──┐
API Bybit     ──→  Thread worker RMB  ──┤
API Gate.io   ──→  Thread worker RMB  ──┤
API HTX       ──→  Thread worker RMB  ──┤  →  Redis  (unica fonte di verità)
API KuCoin    ──→  Thread worker RMB  ──┤
API Kraken    ──→  Thread worker RMB  ──┤
… 12 in totale ──→  Thread worker RMB  ──┘
                                             ↓
                          ┌──────────────────────────────┐
                          │  MagicTradeBot Bot 1          │
                          │  MagicTradeBot Bot 2          │  Tutti leggono da Redis
                          │  MagicTradeBot Bot 3          │  Zero chiamate dirette agli exchange
                          │  MagicTradeBot Bot N  (∞)     │
                          └──────────────────────────────┘

Tutti i bot leggono da Redis. Zero chiamate API dirette agli exchange dal codice del bot. L'exchange parla solo con RedisMarketBridge.

2.2 Pipeline a 6 Fasi

RedisMarketBridge elabora i dati di mercato attraverso sei fasi sequenziali prima che raggiungano i tuoi bot:

Fase Nome Cosa viene scritto in Redis TTL
01 Sincronizzazione Simboli Tutti i simboli futures negoziabili: tick size, step size, quantità min, precisione prezzo Nessuno
02 Dati Kline Candele OHLCV storiche + live per tutti i simboli su tutti gli intervalli configurati 600s
03 Dati Tick Prezzo live, volume, bid/ask. Tre varianti: per simbolo, aggregato tutti i prezzi, cross-exchange 15s
04 Tassi di Funding Tasso di funding attuale per simbolo per exchange. Divario cross-exchange calcolato. Flag di anomalia sollevati 3600s
05 Movimento Percentuale di movimento del prezzo smussata su finestre 5m/10m/20m. Tendenza aggregata del mercato per exchange 90s
06 Segnali RSI, MACD, Bande di Bollinger, VWAP, CVD, OFI per simbolo e intervallo. Punteggio opportunità arbitraggio + classifica top-N 300s

3. Prerequisiti

3.1 Software Richiesto

Componente Versione / Note
MagicTradeBot v6.0 o successiva (richiesta per la modalità Redis)
RedisMarketBridge v1.0+ (open source, gratuito) o binario Pro v1.5
Redis 7.x raccomandato — Supportati anche Redis Stack o Upstash
Docker / Docker Compose Opzionale ma fortemente raccomandato per l'installazione di Redis
Toolchain Rust Necessaria solo se si compila RedisMarketBridge dai sorgenti

3.2 Chiavi API degli Exchange

RedisMarketBridge utilizza solo endpoint pubblici per i dati di mercato — non sono richieste chiavi API per ticker, kline o tassi di funding. Le chiavi API sono opzionali e necessarie solo per:

  • Limiti di velocità più elevati su alcuni exchange (Binance, OKX)
  • Accesso a dati privati (non utilizzato nella pipeline dei dati di mercato)
  • Funzionalità di trading future se abilitate

⚠️ IMPORTANTE — Chiavi API dei Bot

MagicTradeBot richiede ancora le chiavi API degli exchange per il piazzamento degli ordini. Solo l'acquisizione dei dati di mercato viene scaricata su RedisMarketBridge. Le chiavi API dei tuoi bot sono utilizzate esclusivamente per piazzare, monitorare e cancellare ordini.


4. Installazione & Configurazione

4.1 Passo 1 — Avviare Redis

Il modo più semplice è Docker Compose. Crea docker-compose.yml:

version: '3.8'
services:
  redis:
    image: redis:7-alpine
    container_name: rmb-redis
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data
    command: redis-server --maxmemory 2gb --maxmemory-policy allkeys-lru
    restart: unless-stopped

volumes:
  redis-data:
docker compose up -d redis
# Verifica:
redis-cli ping   # → PONG

4.2 Passo 2 — Scaricare RedisMarketBridge

Livello gratuito (open source, MIT):

git clone https://github.com/magictradebot/redis-market-bridge
cd redis-market-bridge
cargo build --release
# Binario: ./target/release/redis-market-bridge

Livello Pro (download del binario):

Dopo aver acquistato una licenza Pro su magictradebot.com, scarica il binario pre-compilato per il tuo sistema operativo. Nessun passaggio di build richiesto. Lo stesso binario funziona per le funzionalità gratuite — la tua chiave di licenza attiva le funzionalità Pro istantaneamente.

4.3 Passo 3 — Configurare RedisMarketBridge

Tutta la configurazione risiede nella directory settings/:

File Scopo
application.yaml Modalità motore, chiave di licenza, modalità debug
connection.yaml Host Redis, porta, password, impostazioni TLS
exchanges.yaml Quali exchange connettere, credenziali
market_data.yaml Intervalli Kline, frequenze di aggiornamento, dimensioni dei chunk, limiti di velocità
signal_engine.yaml Attiva/disattiva singoli segnali, regola i periodi degli indicatori
excluded_symbols.yaml Liste di esclusione simboli per exchange
notifications.yaml Webhook Discord / Telegram per allerte di salute

connection.yaml — Connessione Redis

Redis:
  Host: "127.0.0.1"    # o l'IP del tuo server Redis
  Port: 6379
  Password: ""          # Imposta se l'autenticazione Redis è abilitata
  TLS: false
  Database: 0
  PoolSize: 20          # Aumenta per un numero elevato di bot

exchanges.yaml — Configurazione degli Exchange

Decommenta ogni exchange che vuoi abilitare. Tutti gli endpoint dei dati di mercato sono pubblici — le chiavi API sono opzionali:

Exchanges:

  - Name: "binance"
    Credentials:
      ApiKey: ""        # Opzionale — per limiti di velocità più elevati
      ApiSecret: ""
    Proxy:
      Enabled: false

  - Name: "bybit"
    Credentials:
      ApiKey: ""
      ApiSecret: ""

  # Livello Pro — decommenta per attivare:
  #- Name: "okx"
  #  Credentials:
  #    ApiKey: ""
  #    ApiSecret: ""
  #    Passphrase: ""   # RICHIESTO per OKX

  #- Name: "gateio"
  #- Name: "htx"
  #- Name: "kucoin"    # Passphrase richiesta
  #- Name: "kraken"
  #- Name: "bingx"
  #- Name: "phemex"
  #- Name: "mexc"      # ⚠️ Attenzione: rilanciato a marzo 2026 — monitorare attentamente
  #- Name: "hyperliquid"

⚠️ Attenzione MEXC

L'API Futures di MEXC è stata offline dal 2022 al 2026 e rilanciata a marzo 2026. RedisMarketBridge mostrerà un avviso all'avvio e ad ogni scrittura di dati MEXC. Monitorare attentamente i dati MEXC durante il periodo iniziale di stabilizzazione.

application.yaml — Modalità del Motore

Engine: "Both"   # MarketBridge | SignalBridge | Both

License:
  Key: ""         # La tua chiave di licenza Pro (lascia vuoto per il livello gratuito)

General:
  DebugMode: false
  RenderDashboard: true
Modalità Motore Cosa fa
MarketBridge Solo acquisizione dati (Fasi 1–5). CPU più bassa. Ideale per nodi dati dedicati.
SignalBridge Solo calcolo segnali (Fase 6). Legge i dati Redis esistenti. Eseguire su una macchina separata.
Both (predefinito) Pipeline completa — tutte e 6 le fasi in un unico processo. Ideale per distribuzioni a nodo singolo.

4.4 Passo 4 — Avviare RedisMarketBridge

# Avvia il bridge:
./redis-market-bridge

# O con Docker Compose — aggiungi a docker-compose.yml:
# services:
#   rmb:
#     image: magictradebot/redis-market-bridge:latest
#     volumes:
#       - ./settings:/app/settings
#     depends_on: [redis]
#     restart: unless-stopped

Output di avvio previsto:

[RMB] Avvio di RedisMarketBridge v1.0
[RMB] Modalità motore: Both
[RMB] Redis: 127.0.0.1:6379 connesso ✓
[RMB] Avvio worker: binance
[RMB] Avvio worker: bybit
[RMB] Avvio worker: bitget
[Fase 1] Sincronizzazione simboli: BINANCE=665 BYBIT=542 BITGET=544
[Fase 1] Sincronizzazione simboli completata — 1.751 simboli in Redis
[Fase 3] Streaming dati tick — ciclo 5s
[Fase 6] Motore segnali attivo — RSI MACD BB VWAP

5. Attivazione di Redis in MagicTradeBot

5.1 Configurazione Redis

Apri la tua configurazione di MagicTradeBot e individua la sezione Redis (nuova nella v6.0):

# MagicTradeBot v6.0 — settings/connection.yaml

Redis:
  Enabled: true                    # Imposta su true per attivare la modalità Redis
  Host: "127.0.0.1"               # Stessa istanza Redis di RedisMarketBridge
  Port: 6379
  Password: ""
  TLS: false
  Database: 0
  ConnectionPool: 10               # Dimensione del pool per istanza del bot

  # Comportamento di fallback quando Redis non è disponibile:
  FallbackToDirectApi: true        # Ricorre a chiamate API dirette se la chiave Redis manca
  FallbackWarningLog: true         # Registra un avviso ad ogni fallback
  FallbackStaleThresholdMs: 30000  # Considera i dati come obsoleti se più vecchi di 30s

5.2 Cosa Cambia Quando Redis è Abilitato

Tipo di dato Comportamento in modalità Redis Prezzo corrente / ticker Lettura da tick:{exchange}:{symbol} — TTL 15s, protezione auto-obsoleta Dati Kline / candela Lettura da kline:{exchange}:{symbol}:{interval} — cronologia OHLCV completa Tassi di funding Lettura da funding:{exchange}:{symbol} — aggiornato da RMB ogni ciclo Movimento mercato % Lettura da movement:{exchange}:{symbol}:{window} — pre-calcolato RSI / MACD / segnali Lettura da signal:{exchange}:{symbol}:{interval} — costo di calcolo zero per bot Info simbolo (tick/step size) Lettura da symbol:{exchange}:{symbol} — caricato all'avvio del bot, nessun TTL Punteggio opportunità arbitraggio Lettura da arb:signal:{symbol} o arb:signal:__top__ — top-N pre-classificati Piazzamento ordini Chiamata API diretta all'exchange — invariato. I bot piazzano ancora gli ordini direttamente.

Protezione di Fallback

Se una chiave Redis manca o è scaduta (es. RedisMarketBridge è giù), MagicTradeBot ricorre automaticamente a una chiamata API diretta all'exchange per quel punto dati specifico. Questo garantisce che i bot non si fermino mai a causa di un'interruzione del livello dati. Imposta FallbackToDirectApi: false per disabilitare (non raccomandato in produzione).


6. Esecuzione di bot multipli

6.1 Il Vantaggio Principale

v5 — API diretta (Senza Redis) v6.0 — Modalità Redis
10 bot, chiamate API 10 × 10 chiamate/min = 100 chiamate/min 10 × 0 chiamate/min dai bot
100 bot Throttling quasi certo su Binance Rischio di limitazione velocità zero
Avvio bot Lento — sincronizzazione simboli dall'API dell'exchange Istantaneo — dati già in Redis
Segnali Calcolati per bot, per ciclo Calcolati una volta da SignalBridge, letti da tutti
Aggiungere un bot Aumenta il carico sull'exchange Aggiunge zero carico sull'exchange

6.2 Singolo Exchange — Bot Multipli

Esecuzione di 20 bot di strategia diversi che puntano tutti ai perpetual USDT di Binance:

# bot-1-btc.yaml  (Long/Short BTC, segnale 15m)
Exchange: "binance"
Symbol: "BTCUSDT"
Strategy: "momentum"
Redis:
  Enabled: true
  Host: "127.0.0.1"

# bot-2-eth.yaml  (Long/Short ETH, segnale 30m)
Exchange: "binance"
Symbol: "ETHUSDT"
Strategy: "mean_reversion"
Redis:
  Enabled: true
  Host: "127.0.0.1"

# ... ripeti per tutti i bot necessari
# Tutti leggono dallo stesso Redis — Binance vede SOLO la singola connessione di RMB

6.3 Multi-Exchange — Bot Multipli

Esecuzione di bot su 5 exchange diversi simultaneamente. Senza Redis questo richiederebbe la gestione di 5 budget di limiti di velocità separati su tutti i bot. Con Redis:

# bot-binance-sol.yaml
Exchange: "binance"
Symbol: "SOLUSDT"
Redis: { Enabled: true, Host: "127.0.0.1" }

# bot-bybit-sol.yaml  (stesso simbolo, exchange diverso — confronto arbitraggio)
Exchange: "bybit"
Symbol: "SOLUSDT"
Redis: { Enabled: true, Host: "127.0.0.1" }

# bot-gateio-arb.yaml  (legge il segnale di arbitraggio cross-exchange da Redis)
Exchange: "gateio"
Symbol: "SOLUSDT"
Strategy: "funding_arb"
Redis:
  Enabled: true
  Host: "127.0.0.1"
  UseArbSignals: true       # Legge il segnale pre-calcolato arb:signal:SOLUSDT da Redis

💡 Bot di Arbitraggio Cross-Exchange

ArbEdgeBot (il modulo di arbitraggio di funding di MagicTradeBot) trae il massimo beneficio da Redis. Legge i punteggi di divergenza di funding cross-exchange pre-calcolati da arb:signal:__top__ — una singola chiave contenente le opportunità top-N classificate per spread + momentum + peso della liquidità. Zero chiamate API richieste.


7. Schema delle chiavi Redis

MagicTradeBot legge i dati da Redis utilizzando uno schema di chiavi coerente scritto da RedisMarketBridge.

7.1 Riferimento delle chiavi

Pattern chiave TTL Contenuto
symbol:{exchange}:{sym} Nessuno Tick size, step size, quantità minima, precisione prezzo — caricato all'avvio del bot
tick:{exchange}:{sym} 15s Prezzo corrente, volume 24h, bid, ask, % variazione prezzo
tick:{exchange}:__all__ 15s Tutti i prezzi come mappa JSON — una chiave per tutti i simboli
tick:{exchange}:__price__ 15s Solo simbolo → prezzo, payload minimo per dashboard
kline:{exchange}:{sym}:{interval} 600s Array di candele OHLCV (fino a max_kline_length candele)
funding:{exchange}:{sym} 3600s Tasso, tempo del prossimo funding, tasso previsto
funding:cross_exchange:spreads 3600s Maggiori differenze di funding tra coppie di exchange
movement:{exchange}:{sym}:{win} 90s % variazione prezzo, direzione, momentum smussato
movement:{exchange}:market_trend:{win} 90s Direzione aggregata del mercato su tutti i simboli
signal:{exchange}:{sym}:{interval} 300s Valori RSI, MACD, BB, VWAP, ATR, CVD, OFI
arb:signal:{sym} 120s Punteggio opportunità arbitraggio, spread, coppia di exchange, direzione
arb:signal:__top__ 120s Opportunità di arbitraggio top-N pre-classificate — pronte per il consumo del bot

7.2 Esempio di ispezione con Redis CLI

redis-cli

# Verificare se il bridge sta scrivendo:
> KEYS tick:binance:*
1) "tick:binance:BTCUSDT"
2) "tick:binance:ETHUSDT"
... 665 risultati

# Ottenere il prezzo corrente del BTC:
> GET tick:binance:BTCUSDT
{"price":67284.1,"vol24h":1842311490,"bid":67283.5,"ask":67284.7}

# Ottenere il tasso di funding per SOLUSDT:
> GET funding:bybit:SOLUSDT
{"rate":-0.00871,"next":1734567890000,"anomaly":true}

# Ottenere l'RSI per ETHUSDT 30m:
> GET signal:binance:ETHUSDT:30m
{"rsi":42.3,"macd":-12.4,"bb_pct":0.31,"cvd":-184200}

# Ottenere i migliori segnali di arbitraggio (letti da ArbEdgeBot):
> GET arb:signal:__top__
{"count":66,"signals":[{"symbol":"SOLUSDT","score":8.22,...},...]}

# Controllare il TTL sui dati tick:
> TTL tick:binance:BTCUSDT
12

7.3 Lettura da Redis nel codice del bot

MagicTradeBot gestisce tutte le letture Redis internamente quando Redis.Enabled: true. Tuttavia, puoi anche leggere direttamente da Redis in script personalizzati o dashboard:

# Python
import redis, json

r = redis.Redis(host='127.0.0.1', port=6379)

# Ottenere il prezzo
tick = json.loads(r.get('tick:binance:BTCUSDT'))
price = tick['price']

# Ottenere l'RSI
signal = json.loads(r.get('signal:binance:BTCUSDT:30m'))
rsi = signal['rsi']

# Ottenere le migliori opportunità di arbitraggio
top = json.loads(r.get('arb:signal:__top__'))
best = top['signals'][0]  # {'symbol': 'SOLUSDT', 'score': 8.22, 'spread': 1.42, ...}
// Rust — Integrazione ArbEdgeBot
let price = get_last_price("binance", "BTCUSDT").await?.unwrap_or(0.0);
let signals: Vec<ArbSignal> = get_top_arb_signals().await?;
let funding_rates = get_all_funding_rates("bybit").await?;
// JavaScript / Node.js
const client = createClient({ url: 'redis://127.0.0.1:6379' });
const tick = JSON.parse(await client.get('tick:binance:BTCUSDT'));
const allPrices = JSON.parse(await client.get('tick:binance:__price__'));
// → { BTCUSDT: 67284.1, ETHUSDT: 3412.0, SOLUSDT: 184.2, ... 665 simboli }

8. Modelli di distribuzione

8.1 Modello A — Nodo Singolo (Principiante)

Tutto su una macchina. Ideale per uso personale, test o una flotta di bot a strategia singola.

Macchina: 1 VPS (4 CPU, 8 GB RAM raccomandati)

┌─────────────────────────────────────────┐
│  RedisMarketBridge  (Engine: Both)       │  ← Sincronizza tutti gli exchange in parallelo
│  Redis 7.x                               │  ← Archivio dati condiviso
│  MagicTradeBot Bot 1                     │  ← Legge Redis, piazza ordini
│  MagicTradeBot Bot 2                     │
│  MagicTradeBot Bot N                     │
└─────────────────────────────────────────┘

Quando usarlo: Per iniziare, eseguendo meno di 50 bot, o se la semplicità è più importante delle massime prestazioni.

8.2 Modello B — Bridge e Bot Separati (Consigliato)

RedisMarketBridge su un nodo dati vicino ai server degli exchange, i bot su un nodo di calcolo separato.

Nodo A (Dati — VPS a bassa latenza vicino all'exchange):
  RedisMarketBridge  (Engine: MarketBridge)
  Redis 7.x

             ←→  (rete)  ←→

Nodo B (Calcolo — dove si trovano i tuoi bot):
  MagicTradeBot Bot 1..N
  Tutti si connettono a Redis del Nodo A

Posizioni raccomandate per i nodi:

Exchange Regione ideale
Binance Tokyo / Singapore Bybit Singapore / Hong Kong OKX Hong Kong / Singapore Kraken Francoforte / Londra HTX Singapore / Tokyo

Quando usarlo: Esecuzione di 50+ bot, o quando la latenza dei dati tick è importante per la tua strategia.

8.3 Modello C — Distribuito (Avanzato)

Un nodo MarketBridge per regione di exchange, un cluster Redis condiviso e un nodo di calcolo SignalBridge dedicato.

Nodo 1 (Tokyo):          Nodo 2 (Singapore):      Nodo 3 (Francoforte):
  Engine: MarketBridge     Engine: MarketBridge      Engine: MarketBridge
  Exchange: binance         Exchange: bybit            Exchange: kraken, gateio

                ↓                  ↓                       ↓
          Cluster Redis  (condiviso, replicato tra le regioni)
                               ↓
Nodo 4 (Calcolo):    SignalBridge — calcola RSI/MACD/CVD/OFI per tutti i simboli
                               ↓
Nodo 5..N:           Flotta di bot MagicTradeBot — legge Redis, piazza ordini

📋 Licenza Studio Richiesta

Il modello C richiede una licenza Studio (79 $/mese) che consente fino a 5 istanze RedisMarketBridge simultanee. Ogni nodo funziona in modo indipendente — un guasto di un nodo influisce solo sui dati di quell'exchange, non sull'intera flotta.


9. Configurazione del motore dei segnali

Tutti i segnali sono configurati in settings/signal_engine.yaml. Si applica solo quando Engine: SignalBridge o Engine: Both.

9.1 Segnali disponibili

Segnale Costo CPU Predefinito Descrizione
RSI Basso ✅ Abilitato (periodo: 14) Relative Strength Index — oscillatore di momentum ipercomprato/ipervenduto
MACD Basso ✅ Abilitato (12/26/9) Moving Average Convergence Divergence — tendenza + momentum
ATR Basso ✅ Abilitato (periodo: 14) Average True Range — misura della volatilità
Bande di Bollinger Medio ✅ Abilitato (20, 2σ) Involucro di prezzo basato sulla deviazione standard mobile
VWAP Medio ✅ Abilitato Volume-weighted average price — livello di riferimento istituzionale
Analisi del volume Medio ✅ Abilitato (periodo: 20) Rilevamento picchi di volume e punteggio anomalie
CVD Medio ✅ Abilitato (periodo: 10) Cumulative Volume Delta — pressione netta acquisto vs vendita nel tempo
OFI Elevato ✅ Abilitato (periodo: 5) Order Flow Imbalance — pressione bid/ask dalle variazioni del book degli ordini Momentum prezzo Basso ✅ Abilitato Momentum direzionale personalizzato con smussatura Velocità prezzo Basso ✅ Abilitato Tasso di variazione del momentum — accelerazione / decelerazione Multi-Timeframe Molto elevato ❌ Disabilitato Punteggio di allineamento tendenza intervallare (richiede 3+ intervalli) Nuvola Ichimoku Molto elevato ❌ Disabilitato Sistema Ichimoku completo — calcolo span avanzato a 52 periodi

9.2 Configurazione di esempio

# settings/signal_engine.yaml

rsi:
  enabled: true
  period: 14

macd:
  enabled: true
  fast_period: 12
  slow_period: 26
  signal_period: 9

atr:
  enabled: true
  period: 14

bollinger_bands:
  enabled: true
  bb_period: 20
  bb_deviation: 2.0

vwap:
  enabled: true
  std_dev_multiplier: 2.0

cumulative_volume_delta:
  enabled: true
  period: 10

order_flow_imbalance:
  enabled: true
  period: 5

# Pesante — disabilitare su macchine con poca CPU o nodi ad alta frequenza:
multi_timeframe_analysis:
  enabled: false
  short_term_period: 10
  medium_term_period: 30
  long_term_period: 50

ichimoku_cloud:
  enabled: false

9.3 Linee guida per le prestazioni

  • Macchine con poca CPU / nodi con intervallo 1m: Disabilitare OFI, Multi-Timeframe, Ichimoku
  • Nodo SignalBridge dedicato: Abilitare tutto — scaricare il calcolo dal nodo MarketBridge
  • Configurazione minima (più veloce): Solo RSI + MACD + ATR — copre la maggior parte delle strategie basate su segnali

10. Risoluzione dei problemi

10.1 Le chiavi Redis sono vuote / I bot segnalano dati obsoleti

# Verificare che RedisMarketBridge sia in esecuzione:
ps aux | grep redis-market-bridge

# Verificare la connessione Redis:
redis-cli ping   # → PONG

# Verificare se le chiavi esistono:
redis-cli KEYS 'tick:binance:*' | wc -l   # Dovrebbe essere 665 per Binance

# Verificare che il TTL sia sano:
redis-cli TTL 'tick:binance:BTCUSDT'   # Dovrebbe essere 1–15 (non -2 = mancante, non -1 = nessun TTL)

Se le chiavi mancano, controlla i log RMB con DebugMode: true in application.yaml per vedere gli errori di connessione agli exchange.

10.2 I bot colpiscono ancora le API dell'exchange nonostante la modalità Redis

  1. Verifica che Redis.Enabled: true nella configurazione di MagicTradeBot
  2. Conferma che Redis.Host e Redis.Port in MagicTradeBot corrispondano all'istanza Redis in cui RMB scrive
  3. Controlla FallbackWarningLog: true — se vedi avvisi di fallback, RMB è in esecuzione ma una chiave specifica manca o è scaduta
  4. Conferma che i nomi degli exchange corrispondano esattamente (sensibili alle maiuscole: "binance" non "Binance")

10.3 I dati MEXC mancano o sono incoerenti

⚠️ Problema noto MEXC

L'API Futures di MEXC è stata offline dal 2022 al 2026 e rilanciata a marzo 2026. I dati potrebbero essere inaffidabili durante la stabilizzazione. Se vedi avvisi [MEXC CAUTION] nei log RMB, questo è un comportamento previsto. Considera di disabilitare MEXC in exchanges.yaml fino a quando l'API non si dimostrerà stabile.

10.4 Errori di limitazione della velocità che compaiono nonostante la modalità Redis

  • Gli errori di limitazione della velocità dal piazzamento degli ordini sono normali — i bot piazzano ancora gli ordini direttamente. Solo le letture dei dati sono scaricate su Redis.
  • Se vedi limiti di velocità sulle letture dei dati, significa che FallbackToDirectApi si è attivato ripetutamente. Verifica perché RMB non sta scrivendo le chiavi previste.

10.5 Errore frase di accesso KuCoin / Bitget / OKX

Questi exchange richiedono una frase di accesso nelle credenziali del bot per il piazzamento degli ordini. Questo è un requisito di trading lato bot, non correlato a Redis o RedisMarketBridge. Imposta la frase di accesso nella sezione delle credenziali dell'exchange di ogni bot — è separata dalle credenziali RMB exchanges.yaml (che sono opzionali per i dati pubblici).

10.6 Monitoraggio dello stato di salute

Configura avvisi Discord o Telegram in settings/notifications.yaml:

Notifications:
  Discord:
    Enabled: true
    WebhookUrl: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"
    AlertOn:
      - ExchangeDisconnect
      - RedisConnectionLost
      - HighLatencyWarning
      - MexcCaution

  Telegram:
    Enabled: false
    BotToken: ""
    ChatId: ""

11. Passaggio alla versione Pro

I livelli Gratuito (3 exchange, 1.751 simboli) e Pro (12 exchange, 4.081+ simboli) utilizzano lo stesso binario. L'upgrade è istantaneo — nessuna reinstallazione, nessuna modifica alla configurazione oltre alla chiave di licenza.

Passi:

  1. Acquista una licenza Pro su magictradebot.com
  2. Ricevi la tua chiave di licenza via email
  3. Apri settings/license.yaml e imposta:
License:
  Key: "YOUR-LICENSE-KEY-HERE"
  1. Riavvia RedisMarketBridge
  2. Decommenta gli exchange aggiuntivi in exchanges.yaml
  3. Riavvia di nuovo RedisMarketBridge — tutti i 12 worker degli exchange si avvieranno

Cosa attiva la versione Pro:

  • ✅ OKX, Hyperliquid, Gate.io, KuCoin, Kraken, HTX, BingX, Phemex, MEXC
  • ✅ 12 worker exchange paralleli (ogni exchange completamente indipendente)
  • ✅ 4.081+ simboli perpetual USDT
  • ✅ 66 coppie di arbitraggio cross-exchange (contro 3 nel livello gratuito)
  • ✅ Punteggio segnale arbitraggio v2 (spread + funding + ponderazione liquidità)
  • ✅ Segnali CVD e OFI sbloccati
  • ✅ Copertura completa dei tassi di funding su tutti i 12 exchange

12. Riferimento rapido

Lista di controllo all'avvio

Comandi chiave

# Avviare Redis
docker compose up -d redis

# Avviare RedisMarketBridge
./redis-market-bridge

# Verificare che i dati fluiscano
redis-cli KEYS 'tick:binance:*' | wc -l    # → 665 (livello gratuito Binance)
redis-cli GET 'tick:binance:BTCUSDT'        # → {"price":...}
redis-cli GET 'arb:signal:__top__'          # → {"count":66,"signals":[...]}

# Verificare che i TTL siano sani (dovrebbero essere > 0)
redis-cli TTL 'tick:binance:BTCUSDT'        # → 1–15
redis-cli TTL 'signal:binance:BTCUSDT:30m'  # → 1–300

# Monitorare l'output di RMB in tempo reale
redis-cli MONITOR

# Contare il totale delle chiavi in Redis
redis-cli DBSIZE

Riepilogo livelli exchange

Livello Exchange Worker Paralleli Simboli Coppie Arbitraggio
Gratuito Binance, Bybit, Bitget 3 1.751 3
Pro + OKX, Hyperliquid, Gate.io, KuCoin, Kraken, HTX, BingX, Phemex, MEXC 12 4.081+ 66

Supporto

Canale Dettagli Documentazione docs.magictradebot.com Community Discord discord.gg/magictradebot — canale #redis-bridge Supporto Prioritario Pro Discord @Priority-Support o support@magictradebot.com Segnalazione Bug github.com/magictradebot/redis-market-bridge/issues Gestione Licenze magictradebot.com/account/license
Ready to trade? Download MagicTradeBot free and test in paper mode before going live.