Documentation

QuantumStocks

AI-driven market intelligence platform — multi-source data ingestion, server-side ML, options Greeks, gamma exposure, and a confluence signals engine. Built for retail traders who want institutional-grade tooling without the terminal price tag.

Amvera (Moscow + Warsaw) Next.js 16 + FastAPI Redis-cached <5ms /fast/* endpoints

Dashboard sections

15 tools, each backed by a real MCP endpoint. Same data you see in the dashboard.

Overview
Composite dashboard: top tickers, market snapshot, signals verdict, latest news.
Signals
Confluence score across 7 sources (HMM × SMC × ML × Tech × GEX × VWAP + more) with a single BULL/BEAR/NEUTRAL verdict.
LSTM Forecast
Single-layer LSTM price prediction with VaR, MAE/RMSE quality metrics, and a per-step predictions table.
ML Ensemble
5-model LSTM ensemble — weighted average, direction vote, confidence, and expected move %.
HMM Regime
Hidden Markov Model over 5 market states (CRASH → BEAR → SIDEWAYS → RECOVERY → BULL) with persistence and per-state annualized return.
Smart Money
Smart Money Concepts — order blocks, fair value gaps, premium/discount zones, liquidity sweeps.
Technical
RSI, MACD, Bollinger Bands, EMA20/50/100, Average True Price — with a 6-month price chart and overlaid levels.
Options
Full options chain per expiration — OI distribution chart, call/put walls, max pain, zero gamma, Greeks (delta/vega/gamma exposure).
GEX
Black-Scholes gamma exposure profile — net GEX per strike, call/put walls, gamma flip, negative gamma zones, trigger levels.
Fundamentals
Company profile, sector/industry, key ratios (P/E, P/B, P/S, ROE), financial ratings.
Econ Calendar
Forex Factory feed — NFP, CPI, FOMC, central-bank decisions. Filterable by country and impact.
News
Aggregated feed from multiple sources (RSS, LiveSquawk, etc.) with markdown rendering.
Screener
Finviz S&P 500 (501 companies) — sortable, filterable table with sector, price, perf 1W/1M, P/E, ROE, RSI, beta, target.
Correlation
Cross-asset correlation matrix and beta ranking for portfolio risk.
Ops
Admin view — APScheduler status, warmup progress, per-endpoint cache state.

Tech stack

What's actually running in production right now.

Backend
FastAPIPydanticAPSchedulerasyncio
ML / Quant
TensorFlow (LSTM)hmmlearnNumPy / SciPystatsmodels
Data sources
yfinanceyahooqueryForex FactoryFinvizFREDLiveSquawk
Cache / State
RedisSQLite (auth + payments)
Frontend
Next.js 16React 19Tailwind v4shadcn/uiRecharts
Infra
Amvera (RU region)DockerGitHub Actions

Pricing

Honest tiers — payment via crypto (NowPayments).

Free
0 ₽/ forever
  • ✓Landing + docs access
  • ✓Limited dashboard preview
  • ✓Community support
Pro
Recommended
See /payment/ monthly
  • ✓All 15 dashboard sections
  • ✓All tickers
  • ✓ML forecasts on-demand
  • ✓API access via cookie auth

API reference

Live from the MCP backend's /openapi.json. Endpoints require Authorization: Bearer <jwt>(obtained via POST /token after registration).

QuantumStock MCP API48 endpoints in 15 categories

⚡ Fast Layer (Redis Cache)

10
GET/fast/{ticker}/{dtype}
⚡ Fast: получить {dtype} для {ticker} из Redis (<5ms)
Required:tickerdtype
GET/fast/beta-ranking
⚡ Fast: beta ranking активов к SPY из Redis
GET/fast/calendar
📅 Экономический календарь (Forex Factory, Redis)
GET/fast/correlation-map
⚡ Fast: корреляционная матрица + beta ranking из Redis
GET/fast/finviz-screen
📊 Finviz S&P 500 screen (Redis)
GET/fast/finviz/{ticker}
📊 Finviz метрики тикера (Redis)
Required:ticker
GET/fast/indicators/{blog}
⚡ Fast: структурированные индикаторы блога (CDS/VIX/FedOdds) из Redis
Required:blog
GET/fast/news/{source}
⚡ Fast: RSS новости {source} из Redis
Required:source
GET/fast/signals
🎯 Multi-signal confluence (7 источников, Redis)
GET/fast/snapshot
⚡ Fast: снимок 37 инструментов из Redis (TTL 5м)

📋 Jobs (Async Tasks)

2
GET/jobs
📋 Список недавних фоновых задач
GET/jobs/{job_id}
📋 Статус фоновой задачи
Required:job_id

📰 Blog & RSS

3
GET/blog/indicators/{blog}
📰 Структурированные индикаторы блога (CDS/VIX/GDPNow/FedOdds)
Required:blog
GET/blog/rss/{source}
📰 Парсинг RSS/Atom ленты и запись в Redis
Required:source
GET/blog/sources
📰 Список доступных RSS-источников

🔬 Analytics (Primary Compute)

8
GET/analytics/correlation-map
🔬 Correlation Matrix + Beta Ranking + Top Pairs (async!)
GET/analytics/enriched/{ticker}
🔬 Enriched: GARCH(1,1), VaR, ATR, Sharpe, Drawdown, Skew/Kurt
Required:ticker
GET/analytics/gex/{ticker}
🔬 GEX: Gamma Exposure (Black-Scholes + IV smile Fouque)
Required:ticker
GET/analytics/signals/{ticker}
🔬 Multi-Signal Confluence: HMM × SMC × ML × Tech × GEX × VWAP
Required:ticker
GET/analytics/vwap/{ticker}
🔬 VWAP: Volume Weighted Average Price + σ-bands
Required:ticker
GET/analytics/warmup
🔥 Запустить полный прогрев Redis (все ticker × dtype)
GET/scheduler/status
🩺 Диагностика APScheduler: жив ли periodic scheduler?
GET/warmup/status
🔥 Статус прогрева Redis (сколько тикеров/dtype в кэше)

AI Skills

2
GET/SKILLS
📋 Реестр всех AI-навыков QuantumCP (НАЧНИТЕ ЗДЕСЬ)
GET/SKILLS/{skill_id}
📋 Детальная информация по конкретному навыку
Required:skill_id

Fundamentals

5
GET/ADVANCED_FUNDAMENTAL_SCORES
Финансовые рейтинги и скоринг компании
Required:ticker_symbols?
GET/ADVANCED_FUNDAMENTALS
Продвинутый анализ компании: 3 уровня детализации + финансовый рейтинг
Required:ticker_symbol?
GET/FRED
Get Fred Data Endpoint
Required:series_id?
GET/FUNDAMENTALS
Фундаментальные данные компании: профиль, финансы, статистика, рекомендации
Required:ticker_symbol?
GET/NASDAQ
Get Nasdaq Data Endpoint
Required:compnumber?

Macro

2
GET/FRED_SEARCH
Поиск экономических серий в FRED (Federal Reserve)
Required:search_text?
GET/FRED_SEARCH/SOURCES
Информация о параметрах поиска FRED

Market Data

3
GET/historical_data/{ticker}
Исторические OHLCV данные тикера
Required:tickerstart_date?end_date?
GET/MARKET_SNAPSHOT
Расширенный снимок рынка: 30+ инструментов, Fear & Greed, intermarket, sector rotation
GET/technical_analysis/{ticker}
Технический анализ тикера: RSI, MACD, Bollinger Bands, EMA, ATP
Required:ticker

ML Forecasting

3
GET/HMM_REGIME
HMM детекция рыночного режима (Monteiro 2025)
Required:ticker?
GET/LSTM
LSTM прогноз будущих цен (регрессия) с метриками качества и VaR
Required:ticker?start_date?end_date?interval?future_steps?time_step?
GET/ML_FORECAST
ML прогноз: Sharpe-weighted LSTM ансамбль (5 архитектур) + HMM consensus
Required:ticker?

News & Sentiment

4
GET/GLOBAL_NEWS
Последние глобальные рыночные новости (Markdown)
GET/NEWS
Последние новости компании по тикеру
Required:ticker?
GET/RSS_SOURCES
Список доступных RSS источников
GET/RSS/{source}
RSS новости из указанного источника
Required:source

Options

2
GET/options/data
Агрегированные данные опционов: греки, OI, Max Pain, Gamma Exposure
Required:ticker?
GET/options/expirations
Даты экспирации опционов для тикера
Required:ticker?

Smart Money

1
GET/SMART_MONEY
Smart Money Concepts (SMC): структура, Order Blocks, FVG, FTM сигналы
Required:ticker?

System

1
GET/time_check
Проверка системного времени сервера

Token

1
POST/token
Получает токен доступа для аутентификации пользователя

Users

1
POST/users/register
Регистрирует нового пользователя в системе
Required:secret_phrase?

Built and operated by Anton Bustrov · Source: info.quantumstocks.ru · Last updated 2026-10-03