horus-flow-mcp
This server gives AI agents real-time institutional market-intelligence tools for crypto and US equities — covering orderflow, positioning, and volatility — so trading decisions can be made with measured, data-backed context rather than lagging indicators.
Crypto orderflow (
get_crypto_flow) – Real-time signal (BUY_PRESSURE / SELL_PRESSURE / WHALE_EXIT / EMERGENCY_DUMP) with confidence, bid/ask depth, whale intent, toxicity, and spoofing/trap flags for any pair.Equity orderflow (
get_equity_flow) – Same style of signal for US stocks, including large sell orders, block trades, and flags like WATERFALL_DUMP or PULLED_BID_WALL_SPOOF.Multi-asset scanning (
scan_crypto_flow) – Scan a basket of pairs at once and get the strongest buy/sell signals ranked by confidence for portfolio-wide risk checks.Institutional blocks & macro (
get_macro_blocks) – SPY market mode and buy ratio plus recent block trades over $200K with direction and size.Composite score (
get_composite_intelligence) – A 0–100 score with a BUY / SHORT / STAY_OUT verdict fusing orderflow, sentiment, leverage, and smart-money positioning.Liquidation heatmap (
get_liquidation_heatmap) – Long/short liquidation clusters at specific price levels with dollar amounts, to avoid entries near cascade zones.Cross-exchange flow (
get_cross_exchange_flow) – Futures/spot ratio and speculation index (e.g., hyper-speculation warnings) plus smart-money vs. crowd divergence.Market climate (
get_market_climate) – Regime (CHOP / TREND / RANGE) and health (HEALTHY / FRAGILE) to guide which strategy and sizing to use.Ignition detection (
get_ignitions) – Volatility state (DORMANT / RISING / IGNITED) with directional bias to anticipate or avoid explosive moves.All-in-one check (
get_market_intelligence) – Bundles orderflow, composite score, liquidation zones, cross-exchange analysis, climate, and ignitions into a single pre-trade call.
Provides real-time orderflow intelligence for Binance cryptocurrency pairs, enabling AI agents to analyze live Level 2 orderbook data and institutional buying/selling pressure for USDT trading pairs.
Integrates with RapidAPI to access Horus Flow Intelligence API for institutional-grade crypto and equity orderflow data, requiring a RapidAPI key for authentication and data access.
🤖 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." │
└─────────────────────────────────────────────────────────────────────────────────────────────┘Related MCP server: crypto-quant-signal-mcp
🛑 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:
Level 1-2 Physics (The Eye): Measures sub-second limit orderbook depth, spoofed liquidity walls, and aggressive taker execution delta before candlesticks print.
Level 3 Forensics (The Radar): Tracks Liquidation Cascades (Gravity Direction) and Spot vs. Futures Speculation Ratios.
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 [Websocket Ingestion]
B[Binance WSS <br/> L1/L2 Book]:::crypto_stream
A[Alpaca WSS <br/> IEX Equities - sample]:::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 |
|
| Order book imbalance (top 20 levels) and taker flow from Binance's public stream. Any TRADING spot pair | Free: all pairs |
|
| Snapshots every 15s with price, deltas and ratios | Builder: 60 min · Pro: 24 h |
|
| US equity flow from the IEX feed (about 3% of US volume, a sample) | Builder |
|
| SPY buy/sell skew and IEX prints of $200k or more | Free |
|
| Freshness and uptime of every data source (no key) | Public |
Level 3: Forensic Market Intelligence
Endpoint | Method | Description | Tier |
|
| WiseMan BTC regime and health | Builder |
|
| Volatility breakout scanner across ~750 assets, refreshed every minute | Builder |
|
| Crowd positioning vs its 24h median and estimated liquidation levels (10 majors) | Pro |
|
| Futures/spot volume vs its 7-day median, premium, funding and OI across Binance, Bybit and OKX | Pro |
|
| 0-100 score from climate, ignition, positioning and futures/spot flow | Pro |
|
| All of the above for 10 majors in one call | Pro |
Every Level 3 document carries a method field with its exact formula. Endpoints return 503 data_stale instead of serving data older than their freshness limit.
Level 4: The Sovereign Cognitive Cortex
Endpoint | Method | Description | Tier |
|
| Regime state, trust score, contradictions, execution boundaries and action policy | Pro |
|
| Backward-compatible alias for the Cortex endpoint | Pro |
Agent Layer
Endpoint | Method | Description | Plan |
|
| The spot order book of 30 Binance pairs in one call (top-five bid share, bid/ask ratio, 30 s taker flow), with its measured link to the next minute | Free: 3 rows · Trader: 30 |
|
| Rank about 250 Binance perpetuals in one call: buyers or sellers in control, volume surge, breakout candidates, crowded funding, or custom filters | Free: 3 rows · Builder: 100 |
|
| Live hit rate of every signal at 1/5/15/30 min, by signal, symbol and confidence | Public |
|
| Point-in-time ledger: what Horus said, at what price, and what happened next (since Aug 2026) | Builder |
|
| Changes since your last check: liquidation cascades, regime changes, new US halts, and more | Builder |
|
| The same events as Server-Sent Events | Builder |
|
| Signed webhooks for any event type | Pro |
|
| US session phase, holidays, early closes, next open/close, active halts | Public |
|
| All US trading halts published today, with plain-language reasons | Public |
|
| BTC order flow next to SPY, QQQ, COIN, MSTR and IBIT flow | Builder |
|
| Freshness and uptime of every data source | Public |
Every directional flow reading carries a reliability block with its measured hit rate. Add ?view=compact to /v1/flow/crypto/{symbol} for a token-light answer.
🤖 Connect Your AI Agent
Remote MCP server (recommended)
https://flow.horustek.pro/mcp (Streamable HTTP).
RapidAPI subscribers: send your RapidAPI key as
X-RapidAPI-Key: <key>. Calls go through RapidAPI, so your RapidAPI plan and quota apply. Subscribe on RapidAPI.Horus keys:
X-API-Key: <key>orAuthorization: Bearer <key>.No key: free tier: order flow for any pair, the public track record, US session context, the first 3 scanner results and service status.
Claude Code:
claude mcp add --transport http horus-flow https://flow.horustek.pro/mcp --header "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY"Any MCP client that supports remote servers:
{
"mcpServers": {
"horus-flow": {
"type": "http",
"url": "https://flow.horustek.pro/mcp",
"headers": { "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY" }
}
}
}Tools (all read-only, compact JSON with an output schema)
Tool | What it answers | Plan |
| What does the order book say right now across 30 majors, and how much has that told about the next minute | Free (3 rows) / Trader |
| Where are buyers, sellers or volume surging across about 250 markets right now | Free (3 rows) / Builder |
| Live order flow for one pair, with the signal's measured hit rate | Free |
| Is pressure building or fading over the last hour | Builder |
| Climate, Cortex and 10 majors in one call | Pro |
| Funding, OI across Binance/Bybit/OKX, crowd positioning, liquidation levels | Pro |
| Regime, trust score, contradictions, invalidation and breakout levels | Pro |
| Breakout scanner across ~750 assets | Builder |
| How often each signal was right | Free |
| Historical signals with outcomes, for backtesting | Builder |
| What changed since your last check | Builder |
| Can US stocks be traded right now, and which are halted | Free |
| Are crypto and US equities risk-on together or diverging | Builder |
| US stock flow from the IEX sample | Builder |
| Freshness of every data source | Free |
Readings are context with a measured track record, not trade instructions. Many signals score close to a coin flip; the reliability field says so.
Local stdio server (PyPI)
pip install horus-flow-mcp and set RAPIDAPI_KEY to use the RapidAPI listing from a local MCP client.
Webhook signatures
import hmac, hashlib
def verify(secret: str, timestamp: str, body: bytes, signature: str) -> bool:
expected = "sha256=" + hmac.new(secret.encode(), timestamp.encode() + b"." + body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, signature)
# timestamp = request.headers["X-Horus-Timestamp"], signature = request.headers["X-Horus-Signature"]⚡ 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"])💎 Plans
Feature | Free | Builder / Trader ($29/mo) | Pro ($149/mo) | Institutional ($499/mo) |
Crypto order flow | Any Binance spot pair | Any Binance spot pair | Any Binance spot pair | Any Binance spot pair |
Flow history | – | 60 minutes | 24 hours | 24 hours |
Track record and US session context | ✅ | ✅ | ✅ | ✅ |
Climate, ignitions, cross-asset, US equities (IEX sample) | – | ✅ | ✅ | ✅ |
Events (polling and SSE), signal ledger | – | ✅ | ✅ | ✅ |
Derivatives (10 majors, Binance + Bybit + OKX), composite, Cortex | – | – | ✅ | ✅ |
Signed webhooks | – | – | ✅ | ✅ |
Rate limit | 30/min | 120/min | 300/min | 600/min |
Remote MCP server | ✅ | ✅ | ✅ | ✅ |
Live status and uptime: flow.horustek.pro/status.html
🌐 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. 🦅
mcp-name: pro.horustek/horus-flow-mcp
Available Tools
10 toolsget_composite_intelligenceAInspect
Get composite intelligence score (0-100) with tactical verdict.
Returns a score from 0-100 and a verdict: BUY, SHORT, or STAY_OUT.
Combines orderflow, sentiment, leverage ratios, and smart money positioning
into a single actionable number. Score < 45 = dangerous, > 65 = opportunity.
Args:
symbol: Trading pair (default: BTCUSDT)
Inputs: symbol. Returns: result
get_cross_exchange_flowAInspect
Get Futures/Spot ratio, speculation index, and smart money divergence.
Reveals whether the market is driven by speculation (Futures) or real demand (Spot).
Futures/Spot > 8x = HYPER_SPECULATION (vulnerable to flush).
Also shows smart money divergence: are top traders positioned opposite to the crowd?
Args:
symbol: Trading pair (default: BTCUSDT)
Inputs: symbol. Returns: result
get_crypto_flowAInspect
Get real-time institutional orderflow for a cryptocurrency.
Returns signal (BUY_PRESSURE/SELL_PRESSURE/WHALE_EXIT/EMERGENCY_DUMP),
confidence score, bid/ask depth metrics, whale intent, toxicity level,
and flags like SPOOFING_DETECTED, BID_WALL_TRAP, DEPTH_COLLAPSE.
Args:
symbol: Trading pair (e.g., "BTCUSDT", "ETHUSDT", "SOLUSDT")
Inputs: symbol (required). Returns: result
get_equity_flowAInspect
Get real-time institutional orderflow for a US equity stock.
Returns signal (BUY_PRESSURE/SELL_PRESSURE/WHALE_EXIT/EMERGENCY_DUMP),
confidence score, large sell orders count, block trades, toxicity,
and flags like WATERFALL_DUMP, PULLED_BID_WALL_SPOOF.
Args:
symbol: Stock ticker (e.g., "SPY", "AAPL", "TSLA", "NVDA", "MSFT")
Inputs: symbol (required). Returns: result
get_ignitionsAInspect
Detect volatility ignition events — potential explosive price moves.
Returns ignition state (DORMANT, RISING, IGNITED) and directional bias.
IGNITED = imminent large move, reduce or exit positions.
RISING = pressure building, prepare for breakout.
Inputs: no named parameters. Returns: result
get_liquidation_heatmapAInspect
Get liquidation zones with dollar amounts — where leveraged positions will be force-closed.
Returns clusters of long and short liquidations at specific price levels
with total dollar amounts. Critical for avoiding entries near massive
liquidation zones that could trigger cascading price moves.
Args:
symbol: Trading pair (default: ETHUSDT)
Inputs: symbol. Returns: result
get_macro_blocksAInspect
Get US equity market macro trend and recent institutional block trades.
Returns SPY macro climate (market mode, buy ratio) and list of recent
block trades over $200K with symbol, direction, and size.
Use this to understand where institutional money is flowing.
Inputs: no named parameters. Returns: result
get_market_climateAInspect
Get current market mode and health status.
Returns market mode (CHOP, TREND, RANGE) and health (HEALTHY, FRAGILE).
CHOP = only scalps work, TREND = directional trades, RANGE = mean-reversion.
If health is FRAGILE, reduce all position sizes.
Inputs: no named parameters. Returns: result
get_market_intelligenceAInspect
Get complete market intelligence in a single call — combines all endpoints.
Returns orderflow signal, composite score, liquidation zones, cross-exchange
analysis, climate, and ignition state in one unified response. Use this
for a comprehensive pre-trade check.
Args:
symbol: Trading pair (default: BTCUSDT)
Inputs: symbol. Returns: result
scan_crypto_flowAInspect
Scan multiple cryptocurrencies for orderflow signals at once.
Returns a summary with strongest buy/sell signals and individual results
sorted by confidence. Use this for portfolio-wide risk assessment.
Args:
symbols: Comma-separated trading pairs (default: BTC, ETH, SOL, BNB, XRP)
Inputs: symbols. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Most tools have distinct purposes: crypto vs equity flow, batch scanning, macro blocks, composite score, liquidations, cross-exchange, climate, and ignition detection. The main ambiguity is between get_composite_intelligence and get_market_intelligence, though the latter is clearly described as an aggregate of all endpoints.
The dominant pattern is get_<domain>_<concept>, which is predictable and readable. One deviation is scan_crypto_flow, which uses a verb other than get, but it still follows the same broad noun/flow convention.
Ten tools is well-suited to the server's purpose of providing comprehensive market intelligence. Each tool addresses a distinct data need without redundancy, and the count feels appropriately scoped for a trading analysis domain.
The toolset covers crypto and equity orderflow, macro context, liquidation zones, cross-exchange data, market climate, ignition events, and a composite aggregate. Minor gaps include no direct tool for historical data or sentiment text, but the core pre-trade intelligence workflow is well covered.
Maintenance
Related MCP Connectors
Crypto futures order-flow signals, pumps, liquidation levels, order book walls and verdicts
Live crypto order book heatmap PNG, CVD, imbalance and liquidations from 4 public exchange feeds.
Free live order flow for BTC, gold, US 500 and more: order book, CVD, liquidations, funding.
Tracks real-time 1h/24h DEX buy/sell orderflow ratios, whale accumulation signals, and liquidity v
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables real-time options order flow analysis with pattern detection, institutional bias tracking, and monitoring of specific strike ranges and expirations. Provides comprehensive options trading data through integration with a high-performance Go-based data broker.11MIT
- AlicenseAqualityBmaintenanceAI-native quantitative trading signal engine for crypto and TradFi perpetuals. Multi-factor composite BUY/SELL/HOLD signals, cross-venue funding rate arbitrage scanning, and market regime detection powered by Hyperliquid data.10546 npm10MIT
- AlicenseBqualityDmaintenanceCross-exchange crypto orderflow for AI agents. 20 exchanges, 26 tokens, 9 tools — CVD, whale activity, funding/OI, 7-year OHLCV, on-chain address risk (EVM + Solana). Pay-per-call USDC via x402, no API key.921 npm1MIT

mcp-midasflowofficial
AlicenseNot gradedqualityDmaintenanceMidasFlow Flow API - Cross-exchange order flow, whale detection, liquidations, funding rates, squeeze alerts for AI agents. Native MCP server.MIT