Project Info
Inspiration
Modern (novice) traders are flooded with fragmented, fast-moving information (price action, fundamentals, news/sentiment, and options/volatility) and lack a single, interpretable surface that converts these streams into trustworthy, real-time signals. Making fast, data-driven trading decisions becomes guesswork rather than insight. We wanted to bring order to that chaos by giving traders a clear and interpretable view of market energy in one place.
What it does
MarketMind turns raw market data into simple, real-time visual signals. Six agents, each built with Elastic Agent Builder, analyze a different layer of the market: price movement, company fundamentals, news sentiment, volatility, etc. Their combined outputs appear as glowing pulses around each stock, showing whether momentum is building, risk is rising, or sentiment is shifting.
How we built it
We built 6 agents connected to Elasticsearch, each reading from multiple indices and returning standardized JSON results. Every agent computes its own metrics, scoring, and reasoning before sending its output back to the MarketMind client. The frontend was built with React 19 and Next.js 16, using TypeScript, SVG physics-based visuals, and Chart.js for live candlestick charts. Yahoo Finance provided real-time data, while the app’s animation engine created the smooth pulsing and orbiting interactions that make the experience feel alive.
Challenges we ran into
ESQL was powerful but strict, and small syntax differences broke queries. Aligning timestamps across datasets and keeping data fresh without overwhelming performance required multiple iterations. The hardest part was keeping every agent’s logic explainable while still running fast enough for real-time feedback.
Accomplishments we're proud of
We successfully integrated real trading analysis techniques inside a fully explainable multi-agent system. The Oracle Network computes Technical Analysis indicators such as RSI, Bollinger Bands, and MACD to assess short-term price momentum. The Arbitrage Hunter applies Fundamental Analysis metrics including P/E Ratio and Beta to detect valuation imbalances. The Volatility Prophet uses Portfolio Optimization with Risk-Adjusted Allocation concepts like Modern Portfolio Theory and the Black-Litterman Model to contextualize volatility regimes. Bringing all of these together in one live system that is both interpretable and reactive is a major achievement.
What we learned
We learned that modularity and explainability are essential for both trust and performance. By designing each agent as an independent analytical node with clear responsibilities, we reduced complexity while improving interpretability. We also discovered how visual design can make complex market models not only accessible but intuitive, helping users “see” patterns they might otherwise miss.
What's next
Our next goal is to use realtime data sources to injest into Elasticsearch. This will provide better data to the agents which will result in better responses. We also aim to implement a user chat interface. This user agent will communicate with the Elastic agents using the A2A protocol to provide a response.
MarketMind
A real-time stock market visualization application with AI-powered agent analysis. MarketMind visualizes stock data through an interactive bubble interface where 6 unique AI agents continuously analyze stocks and provide trading signals through visual animations.
Tech Stack
- Next.js 16 (React 19)
- Axios for HTTP requests
- SVG Animations for pulse effects
- Elastic Agent Builder API for AI agent integration
- Lava for foundational model access
Analysis
View
Metric
- 8
- 4
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- CSSIn code
- Next.jsIn code
- ReactIn code
- TypeScriptIn code
4 of 4 appear in the indexed code.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
237 KB
Source files
42
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
AlexLuu1/MarketMind
47 files · 290 KB · @ c6fab9f
Structure
Interface
19 files · 40%Screens, components and styles rendered to the user.
API & routing
7 files · 15%Request entry points: routes, handlers and controllers.
Application logic
14 files · 30%Domain rules, services and shared utilities.
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here — open the file browser to check anything the diagram implies.
Languages
- TypeScript99%
- CSS0%
- Markdown0%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
package.json
npm · 11- axios
- chart.js
- next
- react
- react-chartjs-2
- react-dom
- yahoo-finance2
- +4 more
Declared in the repository’s manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
Feature verification
Axios for HTTP requestsVerified
Axios for HTTP requests
Claimed on readmehigh confidencesrc/app/api/agents/query/route.ts:2— axios is imported and used to POST to the Elastic Agent Builder API
Chart.js live candlestick/line chartsVerified
SVG physics-based visuals, and Chart.js for live candlestick charts
Claimed on Devpostmedium confidencesrc/components/StockChart.tsx:4— Imports Chart as ChartJS and Line/Bar from react-chartjs-2, renders <Line> chart fed by fetchRealCandlestickData; chart type is line/bar based, not a dedicated candlestick chart type
Fundamental Analysis: P/E Ratio and Beta (Arbitrage Hunter)Verified
The Arbitrage Hunter applies Fundamental Analysis metrics including P/E Ratio and Beta to detect valuation imbalances
Claimed on Devposthigh confidencesrc/utils/fundamentalAnalysis.ts:9— analyzePERatio computes valuation signal from peRatio/forwardPEsrc/utils/fundamentalAnalysis.ts:66— analyzeBeta computes volatility/risk classification from beta value
Interactive bubble interface visualizing stocksVerified
MarketMind visualizes stock data through an interactive bubble interface where 6 unique AI agents continuously analyze stocks
Claimed on readmehigh confidencesrc/components/StockBubble.tsx:1— Dedicated StockBubble component exists alongside AgentBubble and Canvas rendering the bubble layoutsrc/components/Canvas.tsx:1— Canvas component orchestrating bubbles on an SVG surface
React 19 / Next.js 16 / TypeScript frontendVerified
Frontend built with React 19 and Next.js 16, using TypeScript
Claimed on Devposthigh confidencepackage.json— next: 16.0.0, react: 19.2.0, typescript devDependency present
Real-time visual pulse signals around stocksVerified
Combined agent outputs appear as glowing pulses around each stock, showing momentum/risk/sentiment shifts
Claimed on Devposthigh confidencesrc/components/AgentBubble.tsx:166— Renders SVG <animate> pulsing energy lines and traveling marbles driven by an activePulses array filtered from agent-produced Pulse objectssrc/hooks/useAgentPolling.ts:1— Hook that polls the agents API and produces pulse state consumed by the bubble UI
Technical Analysis indicators: RSI, Bollinger Bands, MACD (Oracle Network)Verified
The Oracle Network computes Technical Analysis indicators such as RSI, Bollinger Bands, and MACD to assess short-term price momentum
Claimed on Devposthigh confidencesrc/utils/technicalAnalysis.ts:9— calculateRSI implementedsrc/utils/technicalAnalysis.ts:85— calculateBollingerBands implementedsrc/utils/technicalAnalysis.ts:114— calculateMACD implemented
Yahoo Finance real-time data sourceVerified
Yahoo Finance provided real-time data
Claimed on Devposthigh confidencesrc/app/api/stock/historical/route.ts:2— Imports and instantiates yahoo-finance2's YahooFinance client and calls yahooFinance.historical(symbol, ...)package.json— yahoo-finance2 listed as a dependency
Portfolio Optimization with MPT / Black-Litterman (Volatility Prophet)Code-supported
The Volatility Prophet uses Portfolio Optimization with Risk-Adjusted Allocation concepts like Modern Portfolio Theory and the Black-Litterman Model to contextualize volatility regimes
Claimed on Devpostmedium confidencesrc/utils/portfolioManagement.ts:183— calculateMPT implements a simplified Modern Portfolio Theory / Sharpe ratio calculation, but no Black-Litterman implementation was found anywhere in the codebase
Six AI agents analyzing market layers via Elastic Agent BuilderCode-supported
Six agents, each built with Elastic Agent Builder, analyze price movement, fundamentals, news sentiment, volatility, etc.
Claimed on Devpostmedium confidencesrc/utils/agents.ts:4— Defines exactly 6 agents (Oracle, Value Finder, Sentiment Analyzer, Volatility Seer, Volume Anomalies, Catastrophe Detector) each with an id and connector_idsrc/app/api/agents/query/route.ts:19— POSTs to process.env.ELASTIC_API_URL with agent_id/connector_id using an ApiKey header, matching Elastic Agent Builder's converse API shape; falls back to generateMockResponse on failure so real invocation cannot be confirmed without live credentials
Elasticsearch as backing data store for agentsClaimed only
6 agents connected to Elasticsearch, each reading from multiple indices and returning standardized JSON results
Claimed on Devpostmedium confidenceFuture: real-time ingestion into ElasticsearchClaimed only
Next goal is to use realtime data sources to ingest into Elasticsearch for better agent responses
Claimed on Devposthigh confidenceFuture: user chat interface via A2A protocolClaimed only
We also aim to implement a user chat interface communicating with Elastic agents using the A2A protocol
Claimed on Devposthigh confidenceLava foundational model accessClaimed only
Lava for foundational model access
Claimed on readmehigh confidence
An AI agent derived these features from the project’s Devpost page and readme, then searched the code for each one. Verified features are backed by cited code; claimed-only features had no supporting code, which is not by itself proof a feature is missing.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.