Fahali

Get computed institutional risk score from weighted detection engine signals. Returns overall score (0-100), risk level (critical/high/moderate/low), narrative observation, breakdown by component, and detection count. Crash component is capped at 50 to prevent single-sided saturation. Observation, not advice. Public data — no tier required.

fahali_get_institutional_risk_score

Full executive market analysis for today — synthesized market risk breakdown, HMM regime (when available), smart-money flow, top multi-engine opportunities, contributing engines, and crash-risk summary. This is the complete answer to 'market analysis for today'. Composition of existing detection components only. For a lightweight yesterday-vs-today delta teaser use fahali_daily_brief. Public — no tier required. Observation, not advice.

fahali_get_market_briefing

Get detected market regime from the HMM 4-regime engine when available. Returns regime type (bullish/bearish/neutral/high_vol or null), volatility, trend, and expected return. Returns empty array + nulls when HMM regime data is not currently persisted (data availability depends on detection-layer writes). Covers the market_regime engine. Observation, not advice. Requires authentication.

fahali_get_market_regime

Get market sentiment history from news and detection signals. Supports optional symbol filter. Returns sentiment score, confidence, direction (bullish/bearish/neutral), source, and news count per entry. Covers the momentum and volume_anomaly engines. Public data — no tier required.

fahali_get_market_sentiment

Get live market snapshot with prices, changes, and asset class for all monitored instruments. Returns assets (crypto USDT pairs from Binance + US equities/ETFs from Alpaca) with symbol, price, change percent, and volume data. Also includes market indices. Public data — no tier required.

fahali_get_market_snapshot

Get structured market verdict for one or more symbols. Returns direction (bullish/bearish/neutral), confidence score, reasoning chain, expected move percentage, and forecast horizon. Covers dark_pool, pattern_recognition, ml_ensemble, momentum, market_regime, sentiment engines. Requires Professional tier or higher.

fahali_get_market_verdict

Get aggregate portfolio risk metrics. Returns sentiment momentum (bullish vs bearish signal balance), cascade risk score, liquidity stress score, and leverage level. Synthesizes data from leverage, funding_stress, and volume_anomaly engines. Public data — no tier required.

fahali_get_portfolio_metrics

Get portfolio risk assessment for your connected exchange accounts. Returns overall risk score (0-100), value-at-risk (VaR95), expected drawdown, per-position risk breakdown with symbol-level recommendations (REDUCE/HEDGE/MONITOR), and contagion risk. Requires connected exchange accounts. Requires Elite tier or higher.

fahali_get_portfolio_risk

Get unified realtime detection feed from all 18 engines. Returns signals, active alerts, anomalies, dark pool activity, risk metrics, and nexus signals in one response. Includes alert count, signal count, and timestamps. Best single-call tool for 'what is Fahali detecting right now'. Public data — no tier required.

fahali_get_realtime_alerts

Get institutional smart money dashboard. Returns detection counts per symbol, overall institutional action (accumulating/distributing/neutral), top symbol by detection count, sector rotation, and alert-derived sentiment. Fields are honestly labeled: 'detectionsToday' is an alert count (not USD volume), 'topSymbolByDetections' is the most-alerted symbol (not a price move). Covers the order_flow engine. Public data — no tier required.

fahali_get_smart_money_dashboard

Get the honest 4-axis track record scorecard. Returns direction accuracy, magnitude precision, crash catch rate, and volatility assessment — each with base-rate lift vs raw hit-rate. Includes blended aggregate and base rate context. Do NOT cite raw percentages without the base rate lift. Public data — no tier required.

fahali_get_track_record_scorecard

Get the visual intelligence constellation — a unified snapshot of all 18 detection engines rendered as interactive graph nodes. Returns nodes (symbol, radius, glow intensity, status, stress, ETF exposure, gamma exposure, institutional flow, trigger event), inter-node flows (source, target, value, velocity), vortex metadata (active, intensity, gravitational pull, label), signal strength, and market context. Covers ALL 18 engines in one snapshot. Public data — no tier required.

fahali_get_visual_intelligence

Get whale and large institutional trade activity. Returns per-symbol whale count, accumulated volume, phase (accumulation/distribution/markup/markdown), average entry price, estimated target, probability, entity type, and dominant action. Covers the risk_intelligence engine (whale detection component). Public data — no tier required.

fahali_get_whale_activity

Run a natural-language stress test on a portfolio. Describe a scenario (e.g. 'Stress test against 2020 COVID crash combined with 20% Yen devaluation') and optionally provide custom positions. Returns scenario simulations with market drop, probability, expected drawdown, most vulnerable symbols, and estimated capital at risk. Requires authentication.

fahali_run_shock_test