Lumina OrderBook MCP
Provides live 60-level L2 limit order book and tape imbalance data from Coinbase Exchange as a zero-auth crypto market data source, including best bid/ask, Stoikov micro-price, spread, order-flow imbalance, largest liquidity walls, and aggressive tape delta.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Lumina OrderBook MCP get BTC's live 60-level L2 order book, liquidity walls, and ATR risk map"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
📊 Lumina OrderBook MCP (lumina-orderbook-mcp)
Give Claude Code, Cursor, and AI Agents Real-Time 60-Level L2 Order Books, Liquidity Walls, Schmitt-Trigger Factor Ontology & Zero-Repaint ATR Risk Maps — With Zero API Keys.
⚡ 30-Second AI Copy-Paste Install • 🛠️ MCP Tools • 📦 Sample Output • 💎 Pro Edition (NASDAQ TotalView 60-Depth) • 🇯🇵 日本語ガイド
Why lumina-orderbook-mcp?
"LLM nodes should argue about meaning; deterministic code should own the numbers."
When people ask an LLM "Is NVDA or BTC a good entry right now?", standard chatbots either hallucinate prices, eyeball screenshots, repaint on unclosed candles, or drift on stop-loss arithmetic. And existing TradingView MCP scrapers require keeping a heavy desktop app open on a debug port.
lumina-orderbook-mcp runs 100% locally on your machine with zero API keys, zero account signups, and zero TradingView Desktop dependency:
Live 60-Level L2 Limit Order Book & Tape Imbalance (24/7 Crypto): Multi-exchange automatic failover (
Coinbase Exchange$\rightarrow$Kraken$\rightarrow$Hyperliquid— never geo-blocked by HTTP 451 in the US, EU, or Japan). Computes Stoikov micro-price, spread (bps), Top-10 & Deep-60 Order Flow Imbalance (OFI), largest USD buy/sell walls, and aggressive tape delta.Intraday 5m Volume-at-Price (VAP) Microstructure (US/JP Equities, ETFs, Gold, FX): Computes Point of Control (
POC), 70% Institutional Value Area (VAH/VAL), SessionVWAPdeviation in bps, and high-volume support/resistance magnets (NVDA,TSLA,SPY,GLD,7203.T,USDJPY,XAUUSD).Zero-Repaint Closed-Bar Risk Blueprint: Automatically slices off unclosed forming candles so signals never repaint mid-bar. Outputs
EMA(20/50/200), Weinstein200-Day SMAStage-2 status, causalADR(15)remaining intraday fuel %, Schmitt-Trigger Factor Ontology polarity tags, and exact1.5x ATRstructural stop /1.5R&3.0Rtargets.
Related MCP server: Gogi MCP Server
⚡ 30-Second Setup (Just Paste 1 Sentence into Your AI)
No manual JSON editing needed. Copy and paste this single sentence into Claude Code, Cursor, Windsurf, or Antigravity:
Please install and configure the MCP server from https://github.com/ramuza0113-sketch/lumina-orderbook-mcp (use `uvx` if available, otherwise `pip install git+https://github.com/ramuza0113-sketch/lumina-orderbook-mcp.git` and run via `python -m lumina_orderbook_mcp.server`) so you can query live L2 order books, OFI liquidity walls, and deterministic ATR risk maps.Or Configure Directly via CLI / JSON
Option A: Claude Code (1 command with uvx)
claude mcp add lumina-orderbook -- uvx --from git+https://github.com/ramuza0113-sketch/lumina-orderbook-mcp lumina-orderbook-mcpOption B: Cursor (.cursor/mcp.json) / Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"lumina-orderbook": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/ramuza0113-sketch/lumina-orderbook-mcp",
"lumina-orderbook-mcp"
]
}
}
}Option C: Standard pip + Automatic Claude Desktop Installer (Windows Store / MSIX & macOS supported!)
pip install git+https://github.com/ramuza0113-sketch/lumina-orderbook-mcp.git
python -m lumina_orderbook_mcp.server --install-claude(Automatically detects both standard %APPDATA%\Claude and Microsoft Store %LOCALAPPDATA%\Claude-Data configs, safely backs up existing preferences, and registers lumina-orderbook! Then fully quit Claude Desktop via Ctrl+Q and reopen.)
🛠️ Included MCP Tools
Tool Name | What It Computes Deterministically | Example Symbols |
| Crypto: Live 60-level L2 Order Book, Stoikov Micro-Price, Top-10 & Deep-60 OFI, Top-3 USD Bid/Ask Walls, Aggressive Tape Delta.Stocks/ETFs/FX: 5m Volume-at-Price ( |
|
| Closed-Bar Only (anti-repaint) |
|
| Scans up to 10 tickers in parallel/batch and ranks them by absolute microstructure order-flow / institutional volume conviction. |
|
| Launches a live auto-refreshing dark-mode Bloomberg-style Web Terminal ( |
|
| Localhost ( | (No arguments needed) |
💬 Prompts to Try Right Away
"Check the live 60-level L2 order book on
BTC-USDandETH-USD. Where are the biggest USD buy/sell walls right now, and is aggressive tape buying confirming the book?""Pull both the intraday VAP liquidity profile and the 1h closed-bar quant risk packet for
NVDA. Does it still have intraday ADR15 fuel left, and what are the exact 1.5R / 3.0R levels?""Scan
BTC-USD,SOL-USD,NVDA,TSLA,SPY,GLDand tell me which asset has the strongest institutional order-flow imbalance right now."
📦 Real Deterministic JSON Output
{
"symbol": "BTC-USD",
"asset_class": "CRYPTO",
"feed_type": "LIVE_L2_LIMIT_ORDER_BOOK",
"exchange_source": "Coinbase Exchange (Zero-Auth L2)",
"levels_analyzed": { "bids": 60, "asks": 60 },
"touch": {
"best_bid": 64349.68,
"best_ask": 64349.69,
"stoikov_micro_price": 64349.69,
"spread_abs": 0.01,
"spread_bps": 0.0
},
"order_flow_imbalance": {
"top10_bid_ratio_pct": 96.27,
"top10_imbalance": 0.9255,
"deep_imbalance": 0.4447,
"distance_weighted_pressure": 0.7875,
"schmitt_trigger_regime": "STRONG_BID_DOMINANCE"
},
"liquidity_walls": {
"largest_bid_support_walls": [
{ "price": 64340.6, "size": 0.924096, "notional_usd": 59456.89, "distance_bps": 1.41 }
],
"largest_ask_resistance_walls": [
{ "price": 64359.4, "size": 0.559841, "notional_usd": 36031.01, "distance_bps": 1.51 }
]
},
"recent_tape_flow": {
"sample_trades": 60,
"tape_delta_imbalance": 1.0,
"tape_state": "AGGRESSIVE_TAPE_BUYING"
}
}💎 Community (Free) vs Sponsor Pro Edition
lumina-orderbook-mcp is part of the Lumina Quantitative Research Ecosystem (featured in awesome-quant & Awesome_AI4Finance).
Feature | Community Edition (This Repo — MIT) | 💎 Sponsor Pro Edition ( |
API Keys Required | 0 (Instant Run) | Local BYOD ( |
Crypto 60-Level L2 Order Book + Tape OFI | ✅ Included | ✅ Included + Multi-Venue Lead-Lag |
US/JP Stock 5m Volume-at-Price ( | ✅ Included | ✅ Included |
Closed-Bar Schmitt-Trigger & ATR | ✅ Included | ✅ Included |
Live 60-Level US Equity L2 ( | Port Readiness Check | ✅ Full Millisecond 60-Depth Feed |
Spoofing Wall-Collapse & Iceberg Absorption Detector | — | ✅ Scroll-Out Resistant Deep OFI ( |
Z3 Theorem-Proved Slippage-Proof Pyramiding & OCO Bridge | — | ✅ Included ( |
👉 Become a GitHub Sponsor (♡ Sponsor) to support open-source quantitative research & unlock Sponsor-Only Pro repositories!
🇯🇵 日本語クイックガイド (Japanese)
**APIキー登録ゼロ・完全無料(MITライセンス)**で、お使いの Claude Code / Cursor / Claude Desktop / Antigravity に「リアルタイム60段板(暗号資産L2フル板)・機関投資家の売買壁・日米株の価格帯別出来高(POC/VAH/VAL)・確定足ベースのATR損切り&利確マップ」を直結できるMCPサーバーです。
初心者向け:AIに「1行コピペ」するだけで自動導入
難しい設定ファイルの編集は不要です。普段使っている Claude Code や Cursor のチャット欄に、以下の1文をそのまま貼り付けて送信してください:
https://github.com/ramuza0113-sketch/lumina-orderbook-mcp のMCPサーバーをインストールして設定に追加して(uvxがなければ pip install git+https://github.com/ramuza0113-sketch/lumina-orderbook-mcp.git して python -m lumina_orderbook_mcp.server で登録して)。リアルタイムの板情報(OFI)とATRリスク計算を使えるようにして。導入後にそのまま聞ける質問例
🔥 新機能(ビジュアル板&ランキング画面を起動):
Luminaのライブ板&リスク画面をブラウザで開いて(または単体起動コマンド:lumina-orderbook-mcp --dashboard)BTC-USD と ETH-USD のリアルタイム60段板を見て、今どこに一番厚い買い壁・売り壁があるか教えてNVDA と トヨタ(7203.T) の出来高プロファイル(POC)と1時間足の確定足リスクマップを出して。今日のADR値幅燃料はまだ残ってる?BTC-USD, SOL-USD, NVDA, TSLA, GLD を一括スキャンして、今一番板と出来高の偏りが強い銘柄をランキングして
さらに米国株の Moomoo OpenD(NASDAQ TotalView 60段リアルタイム板・見せ板スプーフィング急キャンセル検知・アイスバーグ吸収検知) や上位コンテナを利用したい方は、右上の ♡ Sponsor(GitHub Sponsors) から公式サポーター枠をご確認ください。
📚 Academic References & Citation
Hashimoto, K. (2026a). Eliminating Polarity Hallucinations and Order Book Horizon Truncation Bias in Autonomous Multi-Agent Quantitative Systems: Schmitt-Trigger Factor Ontologies, Scroll-Out Resistant Deep OFI, and Slippage-Proof Pyramiding. CERN Zenodo. DOI: 10.5281/zenodo.23935930
Hashimoto, K. (2026d). Formal Verification of Quantitative Execution Guardrails via Z3 SMT Theorem Proving. CERN Zenodo. DOI: 10.5281/zenodo.24050440
Main Multi-Agent Research Framework:
ramuza0113-sketch/lumina-ai-hedge-fund
Disclaimer: This software is provided strictly for quantitative research, educational, and informational purposes. Nothing output by this MCP server constitutes financial, investment, or trading advice.
Available Tools
5 toolscheck_pro_institutional_bridgeA
Check localhost (127.0.0.1) readiness for institutional Level-2 / execution bridges (Moomoo OpenD :11111 NASDAQ TotalView 60-depth, Interactive Brokers Gateway/TWS :4002/:7497, and MetaTrader 5 RPyC Bridge :8001) and display Lumina OrderBook MCP Pro upgrade details.
Inputs: no named parameters. Returns: result
get_ai_quant_candle_packetA
Compute a zero-repaint (closed-bar only) quantitative analysis & deterministic ATR risk packet. [日本語検索キーワード: 確定足リスクマップ / 損切り・利確ライン / ATR / ADR値幅燃料 / EMAトレンド判定]
Supported timeframes: '5m', '15m', '30m', '1h', '1d'. Works across US Stocks ('NVDA', 'AAPL'), Japanese Stocks ('7203.T', '8035.T'), Crypto ('BTC-USD', 'SOL-USD'), Commodities ('GLD', 'XAUUSD'), and FX ('USDJPY').
Returns:
Confirmed closed candle OHLCV (eliminates mid-candle repainting)
EMA(20/50/200) alignment + Weinstein 200-Day SMA Stage-2 regime
Causal 15-day ADR% & remaining intraday ADR fuel% (chasing-exhaustion warning)
Schmitt-Trigger Factor Ontology semantic polarity tags (prevents LLM polarity hallucinations)
Deterministic 1.5x ATR structural stop loss, 1.5R partial & 3.0R runner targets, and unit sizing per $100 risk.
Inputs: symbol, timeframe. Returns: result
get_live_l2_orderbookB
Fetch real-time market microstructure & liquidity walls for Crypto, US/JP Stocks, ETFs, Gold, or FX. [日本語検索キーワード: リアルタイム60段板 / 板情報 / オーダーブック / 買い壁・売り壁 / 歩み値OFI / 出来高プロファイル POC VWAP]
For Crypto (e.g. 'BTC-USD', 'ETH-USD', 'SOL-USD', 'XRP-USD'): Returns live 60-level L2 limit order book (Coinbase -> Kraken -> Hyperliquid automatic fallback), Stoikov micro-price, spread (bps), Top-10 & Deep-60 Order Flow Imbalance (OFI), largest Bid/Ask liquidity walls in USD, and recent aggressive tape delta.
For Stocks / ETFs / Gold / FX (e.g. 'NVDA', 'TSLA', 'SPY', 'GLD', '7203.T', 'USDJPY'): Returns live 5-minute Volume-at-Price (VAP) Point of Control (POC), 70% Value Area (VAH/VAL), Session VWAP deviation (bps), institutional accumulation/distribution pressure, and local Moomoo OpenD (:11111) NASDAQ TotalView port readiness.
Inputs: depth, symbol. Returns: result
open_live_quant_terminalB
Launch and open the interactive dark-mode Lumina Live OrderBook & Quant Risk Web Terminal
in the user's browser (http://127.0.0.1:8765).
[日本語検索キーワード: Lumina ライブ板 / 板画面 / オーダーブック画面 / リスク画面 / ターミナル / ランキング画面を開く]
Displays 3 real-time visual panels simultaneously:
Multi-Asset OFI & Volume Imbalance Ranking Radar (clickable watchlist)
Live auto-ticking 60-level L2 Order Book DOM Ladder + Cumulative Depth Chart (Crypto) or 24-bin Volume-at-Price POC/VAH/VAL Histogram (Stocks / Gold / FX)
Closed-Bar Trend Stack, Intraday ADR15 Fuel Tank Gauge, and 1.5R / 3.0R Long & Short Blueprints. Call this tool whenever the user asks to visually see or open the order book, chart, ranking board, or Lumina terminal UI.
Inputs: symbol, timeframe, watchlist. Returns: result
scan_market_liquidity_anomaliesA
Scan up to 10 comma-separated tickers simultaneously and rank them by real-time L2 order-book pressure or intraday institutional volume imbalance. [日本語検索キーワード: 一括スキャン / 銘柄ランキング / 板・出来高インバランス順位]
Inputs: symbols_csv. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a recognizably different action: closed-bar quant packet, live L2/VAP fetch, multi-ticker scan, terminal UI launch, and bridge readiness check. The main soft overlap is between get_live_l2_orderbook and scan_market_liquidity_anomalies, since both surface liquidity/imbalance metrics; the single-symbol vs. batch distinction is stated but an agent could still hesitate when asked to 'show liquidity for NVDA'.
All names are snake_case and follow a clear verb_noun pattern (check_, get_, get_, open_, scan_). Resource qualifiers (pro_institutional_bridge, ai_quant_candle_packet, live_l2_orderbook, live_quant_terminal, market_liquidity_anomalies) are descriptive and unambiguous.
Five tools is well within the healthy 3-15 range and each earns its place in the orderbook/quant workflow. However, every tool is very heavy (multi-section payloads), so there is no lightweight call for simple lookups, making the granularity slightly coarse.
The surface covers the core lifecycle: closed-bar analysis with ATR risk, live microstructure, batch ranking scan, visual terminal, and connectivity diagnostics. Minor gaps remain around symbol discovery/validation, historical backfill beyond the candle packet, and any watchlist/alert management.
Maintenance
Related MCP Connectors
Unified financial infrastructure connecting AI agents directly to trade live/demo brokerage accounts, Web3 non-custodial wallets, real-time market data across equities, ETFs, crypto, forex, options, DeFi swaps, and prediction markets, institutional research feeds, and algorithmic strategy backtesters.
Crypto perps for AI agents: funding, OI, liquidations, order book, CVD, volume profile, footprint.
Aligned market data for AI agents: crypto, stocks, FX and macro on one clock. Local or hosted.
Options flow, volatility, dealer positioning (GEX) and dark pool data for AI trading agents.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables AI co-pilots to interact with TradingView charts, manage alerts via REST API, automate morning briefs with custom trading rules, and perform real-time market analysis.-

Gogi MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables AI assistants in MCP clients to query real-time market data, inspect portfolio and Web3 wallet balances across brokers, place protected equity/ETF, crypto, forex, options, DeFi swap, and prediction market orders, and run backtests.MIT- AlicenseNot gradedqualityFmaintenanceEnables AI agents to query liquidation radar for seven tokens, inspect recorded BTC/ETH order book depth with wall history and aggressor flow, and request Li.Fi cross-chain swap routes that agents sign themselves.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to read live Hyperliquid market data — perp and spot metadata, mid prices, order books, OHLCV candles, funding rates and history, and current open interest — keylessly from the exchange's public info API, with no wallet or trading access.105 npmMIT