horus-flow-mcp

🛑 Deja de predecir velas. Empieza a medir la gravedad.

Los traders minoristas utilizan indicadores de seguimiento (RSI/MACD) para adivinar qué hará el mercado basándose en el pasado. Horus utiliza la física del libro de órdenes de Nivel 2, los desequilibrios de ticks y los deltas de flujo de 5 segundos para medir exactamente lo que están haciendo las ballenas institucionales en este momento.

Horus no pregunta "¿Estamos sobrecomprados?". Mide la fuerza gravitacional y te dice: "Las ballenas están manipulando la oferta (spoofing) y los tomadores agresivos están atravesando la demanda. La liquidez se está colapsando. Sal ahora".

⚡ Por qué los agentes de IA (Claude, Cursor) aman a Horus

Si conectas un agente de IA a un feed de indicadores técnicos básicos, se confunde con el ruido. Si alimentas a un agente de IA con Horus, obtiene una matriz de decisión de grado institucional.

Mira lo que Horus detecta en tiempo real durante un intento de Retirada de Liquidez / Flash Crash:

{
  "symbol": "BTCUSDT",
  "signal": "LIQUIDITY_EVENT",
  "confidence": 0.99,
  "market_state": "DISTRIBUTION",
  "risk": "EXTREME",
  "description": "Liquidity withdrawn under price. Aggressive taking.",
  "metrics": {
    "bid_ask_ratio": 7.934,
    "buy_sell_ratio": 0.393,
    "delta_5s": -83040.05,
    "whale_activity": true,
    "large_sell_count": 4,
    "delta_accel": 3.8,
    "wall_side": "BID",
    "wiseman_climate": {
      "market_mode": "CHOP",
      "health": "FRAGILE",
      "confidence": 0.85
    },
    "flags": [
      "GLOBAL_LIQUIDITY_EVENT",
      "SPOOFING_DETECTED(wall=BID)"
    ]
  },
  "timestamp": 1776107738.975
}

El Alfa Institucional:

1. bid_ask_ratio: 7.934 & wall_side: BID: Las ballenas colocan muros de compra masivos y falsos por debajo del mercado para crear un soporte artificial.

2. buy_sell_ratio: 0.393: Horus ve a través de la manipulación (bandera SPOOFING_DETECTED). Mide el flujo real de los tomadores y descubre que las ventas agresivas están devastando el libro de órdenes.

3. delta_accel: 3.8 & whale_activity: true: El impulso de venta se aceleró 3.8 veces, rastreando de forma nativa 4 grandes ventas de ballenas en milisegundos.

4. wiseman_climate: FRAGILE: Se integra perfectamente con el cerebro macro de Horus SaaS, verificando que el entorno holístico de Bitcoin es frágil antes de atacar.

5. El veredicto: Con un factor de confianza de 0.99, el motor de IA activa LIQUIDITY_EVENT. Se anticipa al crash de 1 minuto que sigue. Esto es de grado institucional.

🏗️ Arquitectura

graph TD
    %% Styling
    classDef crypto_stream fill:#F3BA2F,stroke:#000,color:#000,stroke-width:2px;
    classDef equity_stream fill:#000,stroke:#09b533,color:#09b533,stroke-width:2px;
    classDef compute fill:#1A1F36,stroke:#00D6FF,color:#fff,stroke-width:2px;
    classDef mcp fill:#632CA6,stroke:#fff,color:#fff,stroke-width:2px;
    classDef client fill:#FF3366,stroke:#fff,color:#fff,stroke-width:2px;

    %% Ingestion
    subgraph Data_Pipelines [Sub-Millisecond Websocket Ingestion]
        B[Binance WSS <br/> L1/L2 Book]:::crypto_stream
        A[Alpaca WSS <br/> SIP Equities]:::equity_stream
    end

    %% Engine
    subgraph Core_Engine [The Physics Engine]
        IC[Imbalance Calculator <br/> Bid/Ask Spread]:::compute
        FC[Flow Calculator <br/> Tape Deltas]:::compute
        Tkr[Prediction Tracker <br/> In-Memory Evaluator]:::compute
        BC[Behavioral Court <br/> Spoofing & Liquidity Rules]:::compute
    end

    %% Output
    subgraph Output_Layer [Data Shield & Delivery]
        MCP[AI Agent MCP Context <br/> Context-Aware Prompts]:::mcp
        API[FastAPI Client <br/> Safe Shielded Outputs]:::client
        Dash[Real-time Dashboard <br/> Live Edge Proof]:::client
    end

    B --> IC
    A --> IC
    B --> FC
    A --> FC
    
    IC --> BC
    FC --> BC
    
    BC --> Tkr
    Tkr -- "Validates 1M accuracy" --> BC
    
    BC --> MCP
    BC --> API
    BC --> Dash

🚀 Inicio rápido para bots de trading

Empezar con Horus toma menos de 60 segundos. ⚡ Prueba al instante: Descarga nuestra Colección de Postman para hacer ping a la API directamente desde tu navegador.

# 1. Install Dependencies
pip install -r requirements.txt

# 2. Fire up the Core Engine
uvicorn app.main:app --host 0.0.0.0 --port 8011

En tu bot / agente local, simplemente obtén el flujo en vivo para cualquier criptomoneda o acción de EE. UU.:

import requests

response = requests.get(
    "http://127.0.0.1:8011/v1/flow/crypto/BTCUSDT", 
    headers={"X-API-Key": "your_secure_api_key"}
)

flow_data = response.json()

# The Zero-Human Decision Loop:
if flow_data['signal'] in ['EMERGENCY_DUMP', 'BAILOUT', 'LIQUIDITY_EVENT']:
    print("Market gravity collapsing. Market selling all positions.")
    # execute_market_sell()

🌐 Panel de control en tiempo real

Horus viene con un impresionante panel de control WebSocket con diseño glass-morphism listo para usar (/dash/). Cuenta con un Rastreador de pruebas de borde local que mide estrictamente las predicciones direccionales de velas de 1 minuto generadas por el motor de física con una tasa de éxito abiertamente transparente.

Construido con absoluta precisión para aquellos que necesitan ver la Matrix. — HORUS INTELLIGENCE 👁️