Skip to main content

🦅 HORUS CORTEX & FLOW

The Cognitive Market Brain for Autonomous AI Trading Agents

Glama Verified Glama Score AI Agents Listing Verified

A-Tier FastMCP Latency Python License

Don't let your AI trading agents trade on lagging candlestick echoes. Give them the whale's eyes and an institutional cognitive mind.


🤖 The Zero-Human Decision Loop in Action

When you connect Claude Desktop, Cursor, or an autonomous LangChain / AutoGen agent to Horus Cortex, your agent stops hallucinating and begins executing with Wall Street risk rigor:

┌─────────────────────────────────────────────────────────────────────────────────────────────┐
│  Autonomous Quant Agent (Claude 3.5 Sonnet / Cursor IDE) 🤖                                │
│                                                                                             │
│  Prompt: "BTC is pumping. Should we execute a 3x breakout long entry?"                      │
│                                                                                             │
│  AI Calls Tool: `get_horus_cortex()`                                                        │
│  ◀  Horus Cortex Returns:                                                                   │
│     {                                                                                       │
│       "regime_state": "TRANSITION",                                                         │
│       "trust_score": 26.5,                                                                  │
│       "action_policy": {                                                                    │
│         "directive": "Deteriorating Transition: Capital Preservation Lock (0.0x)",          │
│         "trend_allowed": false,                                                             │
│         "ignition_allowed": false                                                           │
│       },                                                                                    │
│       "market_vitals": { "taker_ratio": 0.24, "global_ignition": 0.08 },                    │
│       "active_contradictions": [                                                            │
│         { "id": "BULLISH_PRICE_vs_HOLLOW_BREADTH", "severity": "MEDIUM" }                   │
│       ],                                                                                    │
│       "execution_boundaries": {                                                             │
│         "invalidation_support": 77052.0,                                                    │
│         "breakout_resistance": 78608.0                                                      │
│       }                                                                                     │
│     }                                                                                       │
│                                                                                             │
│  AI Final Output:                                                                           │
│  "⛔ TRADE ABORTED — CAPITAL PRESERVATION ENFORCED.                                        │
│   Although spot price is making local highs, Horus Cortex flags a severe divergence:        │
│   1. Taker Buy/Sell ratio collapsed to 0.24 (Aggressive seller absorption).                 │
│   2. Global market breadth is dormant (0.08) indicating an isolated, hollow squeeze.        │
│   3. Cortex Trust Score is 26.5/100 with active trend locks enabled.                        │
│   Action: Standing aside. Re-evaluating only if price confirms above $78,608 with volume."  │
└─────────────────────────────────────────────────────────────────────────────────────────────┘

🛑 Stop Predicting Candles. Start Measuring Gravity.

Retail traders rely on lagging indicators (RSI, MACD, Moving Averages) which calculate what has already happened.

Horus is predictive, not reactive:

  1. Level 1-2 Physics (The Eye): Measures sub-second limit orderbook depth, spoofed liquidity walls, and aggressive taker execution delta before candlesticks print.
  2. Level 3 Forensics (The Radar): Tracks Liquidation Cascades (Gravity Direction) and Spot vs. Futures Speculation Ratios.
  3. Level 4 Cortex (The Mind): Synthesizes 7 independent evidence families with a real-time Contradiction Engine to output machine-executable position sizing multipliers and USD invalidation boundaries.

🏗️ Architecture

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 level3 fill:#1A1F36,stroke:#FF6B00,color:#fff,stroke-width:2px;
    classDef cortex fill:#4A154B,stroke:#FFD700,color:#fff,stroke-width:3px;
    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
        BF[Binance Futures <br/> OI / Funding / Liquidations]:::crypto_stream
    end

    %% Level 1-2 Engine
    subgraph Core_Engine [Level 1-2: Microstructure Physics]
        IC[Imbalance Calculator <br/> Bid/Ask Walls]:::compute
        FC[Flow Calculator <br/> Tape Deltas]:::compute
        BC[Behavioral Court <br/> Spoofing & Absorption Rules]:::compute
    end

    %% Level 3 Intelligence
    subgraph L3_Engine [Level 3: Institutional Intelligence]
        LH[Liquidation Heatmap <br/> Gravity Zones]:::level3
        XF[Cross-Exchange Flow <br/> Spot ↔ Futures]:::level3
        CI[Composite Intelligence <br/> 4-Layer Verdict]:::level3
    end

    %% Level 4 Cognitive Cortex
    subgraph L4_Cortex [Level 4: The Sovereign Cognitive Cortex]
        HC[Horus Cortex Symphony 3.0 <br/> 7 Forensic Families + Contradiction Engine]:::cortex
        TS[Penalized Trust Score 0-100]:::compute
        EB[Execution Boundaries USD]:::compute
        AP[Action Policy Multipliers for Bots]:::compute
    end

    %% Output
    subgraph Output_Layer [Data Delivery & Agent Integration]
        MCP[AI Agent FastMCP Server <br/> 8 Sovereign Tools]:::mcp
        API[FastAPI REST Gateway <br/> 13 Endpoints]:::client
        Dash[Real-Time Portal <br/> Live Microstructure]:::client
    end

    B --> IC
    A --> IC
    B --> FC
    A --> FC
    BF --> LH
    BF --> XF

    IC --> BC
    FC --> BC
    LH --> CI
    XF --> CI
    BC --> CI

    CI --> HC
    HC --> TS
    HC --> EB
    HC --> AP

    HC --> MCP
    HC --> API
    BC --> Dash

📡 Complete API Catalog

Level 1-2: Orderflow Microstructure

Endpoint Method Description Tier
/v1/flow/crypto/{symbol} GET Real-time orderbook imbalance, taker flow, and whale intent Free / Trader
/v1/flow/crypto/{symbol}/history GET Flow history (1-60 min lookback) for backtesting Trader
/v1/flow/equity/{symbol} GET US Equity institutional tape (SIP) Trader
/v1/flow/equity/macro-blocks GET SPY macro block trades & sentiment Trader

Level 3: Forensic Market Intelligence

Endpoint Method Description Tier
/v1/intelligence/climate GET WiseMan macro market regime & health score Trader
/v1/intelligence/ignitions GET Volatility Breakout Engine (VBE) scanner Trader
/v1/intelligence/liquidation-heatmap GET Liquidation cascade zones & gravity vector Pro ($149)
/v1/intelligence/cross-exchange-flow GET Spot vs Futures volume ratio & OI velocity Pro ($149)
/v1/intelligence/composite GET 4-layer fused composite score (0-100) Pro ($149)
/v1/intelligence/market-intelligence GET Complete macro dashboard for all assets in one call Pro ($149)

Level 4: The Sovereign Cognitive Cortex

Endpoint Method Description Tier
/v1/intelligence/cortex GET 🧠 The Master Brain: 7 evidence families, trust score, contradiction engine, execution boundaries & action policy Pro ($149) / Institutional
/v1/intelligence/maestro GET Backward-compatible alias for the Cortex endpoint Pro ($149) / Institutional

🤖 Model Context Protocol (MCP) Setup

Horus provides an official FastMCP server compatible with Claude Desktop, Cursor IDE, and any MCP client:

1. Claude Desktop Configuration

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "horus-cortex": {
      "command": "python3",
      "args": ["/absolute/path/to/horus_flow_api/horus_mcp.py", "--transport", "stdio"],
      "env": {
        "FLOW_API_KEY": "YOUR_HORUS_API_KEY"
      }
    }
  }
}

2. Available Sovereign Tools for AI Agents

  1. get_horus_cortex(): 🧠 Primary Cognitive Tool — Full consensus, trust score (0-100), boundaries ($), and bot action multipliers.
  2. get_crypto_flow(symbol): Sub-second L2 orderflow and aggressive trade delta.
  3. get_equity_flow(symbol): US Equity block trades and tape prints.
  4. scan_crypto_flow(symbols): Batch scanner for active whale positioning.
  5. get_liquidation_heatmap(symbol): Liquidation cascade zones and gravitational pull.
  6. get_cross_exchange_flow(symbol): Spot vs Futures volume ratio and funding rate risk.
  7. get_composite_intelligence(symbol): 4-layer composite verdict (0-100).
  8. get_full_market_intelligence(): Macro overview of all monitored instruments.

⚡ 60-Second Quant Bot Quickstart (Python)

import requests

HEADERS = {"X-API-Key": "your_horus_api_key"}
BASE_URL = "https://flow.horustek.pro"

# 1. Query Horus Cortex for the Sovereign Market State
res = requests.get(f"{BASE_URL}/v1/intelligence/cortex", headers=HEADERS).json()

trust_score = res["trust_score"]
policy = res["action_policy"]
boundaries = res["execution_boundaries"]

print(f"🧠 Market State: {res['regime_state']} | Trust: {trust_score}/100")
print(f"🛡️ Action Directive: {policy['directive']}")
print(f"🎯 Support Invalidation: ${boundaries['invalidation_support']:,.0f} | Breakout Target: ${boundaries['breakout_resistance']:,.0f}")

# 2. Enforce Autonomous Risk Rules
if not policy["trend_allowed"]:
    print("⛔ Trade Rejected: Cortex forbids trend breakouts during transitions.")
else:
    position_multiplier = policy["trend_multiplier"]
    # execute_trade(multiplier=position_multiplier, stop_loss=boundaries["invalidation_support"])

💎 Institutional Subscription Tiers

Feature Explorer (Free) Trader ($49/mo) Professional ($149/mo) Institutional ($499/mo)
Daily API Quota 100 calls/day 1,000 calls/day 5,000 calls/day Unlimited
Microstructure L2 Flow Top 3 Symbols All Crypto Symbols All Crypto + US Equity All Instruments
Whale Tape & Imbalances Basic Real-Time Real-Time Sub-ms Priority Dedicated Socket
Level 3 Intelligence ❌ ❌ ✅ Full Access ✅ Full Access
🧠 Level 4 Horus Cortex ❌ ❌ ✅ Full Cognitive Brain ✅ Full Cognitive Brain
Autonomous Bot Multipliers ❌ ❌ ✅ ✅
AI Agent MCP Server Community Community ✅ Full FastMCP Access ✅ Dedicated Private Server
SLA & Support Community Standard Priority 24/7 Dedicated Quant Desk

🌐 Live Real-Time Dashboard

Explore the live institutional orderflow visualizer at flow.horustek.pro/dash/.


Engineered with mathematical rigor for Autonomous AI Agents and Quantitative Traders.
© 2026 Horus Tech Ltd. 🦅

Release files for horus-flow-mcp 3.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for horus-flow-mcp 3.0.0
File Size Uploaded
horus_flow_mcp-3.0.0.tar.gz 863.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for horus-flow-mcp 3.0.0
File Interpreter ABI Platform
horus_flow_mcp-3.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 876.8 kB

Release files / horus_flow_mcp-3.0.0.tar.gz

Download URL horus_flow_mcp-3.0.0.tar.gz
Size 863.9 kB
Tags Source
SHA-256 checksum
How to use checksums
cef2a1a6c76a6fbe38b17202f7484085f32cf5976acd2eeffbb1c54b92f016a4
BLAKE2b-256 checksum
How to use checksums
c80f5f1585be09de974e3159f630c86d6649ba69d1562408d99a1b2ef63b855b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / horus_flow_mcp-3.0.0-py3-none-any.whl

Download URL horus_flow_mcp-3.0.0-py3-none-any.whl
Size 13.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
54128357e7a2d51e9ebf1946e6d149491c8ae954975d9fc9427e1429fa955e2e
BLAKE2b-256 checksum
How to use checksums
6041bc5440aa36ad796784afeaccb308a5951a6abfdcffd7113bd1332080bb7f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

3.0.0 This release

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page