InvestAssure

Inspiration

The idea for InvestAssure came from a personal challenge faced by one of our team members. While trying to make an important investment decision, they were overwhelmed by the sheer volume of financial terms, dense reports, and conflicting news sources. Despite having access to data, they struggled to understand the actual risks tied to the investment, such as fraud allegations, market volatility, or legal red flags hidden in complex SEC filings. This moment of confusion highlighted a much bigger issue, investment risk analysis is not accessible to the average person. Tools that exist today are often too technical, fragmented, or built for financial experts. There was no simple way to get a holistic, real-time risk snapshot of a company using trusted sources like news sentiment, market trends, liquidity indicators, and legal disclosures. This experience inspired us to build InvestAssure, a platform that simplifies financial risk and makes it easy for anyone to evaluate the safety of their investments. Whether you're a beginner investor, a student learning finance, or someone managing a portfolio, InvestAssure aims to be your go-to AI-powered risk advisor that turns complex data into clear, actionable insights.

What it does

This project is an AI-powered Investment Risk Analyzer that provides a holistic risk assessment for any publicly traded company. By entering just a stock ticker and investment type, users receive a detailed report highlighting potential red flags and an overall risk score to guide informed decision-making.

The Project uses multiple data streams: Market Data (via Yahoo Finance): Calculates market volatility using recent stock price fluctuations and daily returns. It also evaluates liquidity based on average trading volume, indicating how easily shares can be bought or sold without major price impact. News Sentiment Analysis (via NewsAPI): Gathers the latest news headlines about the company and applies VADER sentiment analysis to detect negative patterns. This helps quantify fraud or reputation risk and reflects how the company is perceived in the public eye. SEC Filings (via SEC EDGAR + NLP): Automatically downloads the latest 8-K filings and scans them using spaCy (NLP) for legal, compliance, or financial red flags. Keywords such as "fraud," "restatement," or "lawsuit" are flagged, providing an inside view of internal company concerns.

The system then combines all three components, market risk, liquidity risk, and fraud/news risk, into a final weighted risk score (0–100). Based on the score, the app categorizes the investment into low, moderate, high, or very high risk, and generates critical alerts to warn users when immediate attention is needed. This tool empowers investors, portfolio managers, or even curious learners with fast, reliable, and explainable financial risk insights, all from a single API call.

How we built it

We developed this full-stack risk analysis platform by combining powerful tools across frontend, backend, AI, and design. On the frontend, we used React.js and JavaScript to build a dynamic and responsive user interface, with Material UI enhancing the visual design and ensuring a clean, professional look. For backend development, we used Python with the Flask framework to build an API capable of processing user inputs and returning real-time risk analysis data. We integrated yfinance to fetch historical stock data for volatility and liquidity analysis, and NewsAPI to retrieve live company-related news articles. To assess news sentiment, we used VADER (Valence Aware Dictionary for Sentiment Reasoning) from the vaderSentiment library, and for detecting financial red flags within SEC filings, we employed spaCy, a powerful NLP library. We also used SEC EDGAR Downloader to retrieve 8-K filings for deeper fraud detection through text scanning.

Challenges we ran into

Throughout the development process, we encountered several significant challenges. One major hurdle was integrating multiple data sources, including real-time financial data from yfinance, news sentiment from NewsAPI, and unstructured SEC filings from the EDGAR database. Each API had its own limitations, rate limits, and response structures that we had to normalize and handle gracefully. In fact, we ran into the free usage limit of NewsAPI, which forced us to create a new account and generate a fresh API key mid-development, adding unexpected delays and troubleshooting. Parsing SEC filings was especially challenging because the documents are lengthy and unstructured, making it difficult to extract red flags using NLP. We used spaCy to perform keyword matching and sentiment analysis, but ensuring accuracy and contextual relevance required fine-tuning. On the frontend, building a responsive React interface that could process asynchronous API responses and reflect real-time risk assessments was technically complex. Managing API keys securely using environment variables and keeping the backend modular and maintainable added to the complexity. Lastly, time management was a real challenge in the hackathon setting, especially when coordinating between backend logic, frontend design, API integration, and data visualization under tight deadlines.

Accomplishments that we're proud of

We’re incredibly proud of how much we accomplished within such a short timeframe. One of our biggest wins was successfully integrating real-time financial data, news sentiment analysis, and SEC filing insights into a unified risk evaluation engine. We were able to leverage NLP with spaCy to flag potential legal or financial red flags from complex SEC documents, which added real-world value and made our analyzer feel industry-relevant. Implementing a critical alert system based on weighted risk components like market volatility, liquidity, and fraud potential allowed us to give users not just a score, but actionable insights. On the frontend, we built a clean and responsive React dashboard that clearly visualizes risk metrics, sentiment, and red flags, making it user-friendly and intuitive. We’re also proud of how we managed our project workflow, collaborating across frontend, backend, and design while keeping the codebase modular and scalable. Even overcoming hurdles like API limitations, data preprocessing, and secure environment variable setup felt rewarding because it mirrored real-world software development challenges. Finally, turning a broad prompt into a fully working, informative, and production-ready web app is something we’re really proud of.

What we learned

Building InvestAssure was a valuable learning experience that taught us how to simplify complex financial and legal data into meaningful, user-friendly insights. It was our first time working with financial APIs like yFinance, SEC EDGAR, and NewsAPI, and we learned how to fetch, filter, and preprocess real-time data for risk analysis. We also faced the challenge of formulating natural language processing (NLP) logic for the first time, using tools like spaCy to scan lengthy SEC filings for red flags and VADER sentiment analysis to evaluate news headlines. Understanding how to structure and score risks based on volatility, liquidity, sentiment, and legal signals pushed us to think critically and creatively. We grew more confident in our full-stack development skills, from building a Flask backend to designing a clean, interactive frontend in React with Material UI. We also experienced firsthand the importance of API rate limits, even needing to switch NewsAPI accounts after hitting usage limits during testing. Most importantly, we learned how to collaborate as a team under time pressure, divide responsibilities efficiently, and iterate quickly based on test results. This project helped us appreciate how technology can empower everyday users to make smarter investment decisions—and how much can be achieved through persistence and teamwork.

What's next for InvestAssure

While InvestAssure already offers a good foundation for evaluating investment risk based on real-time market volatility, news sentiment analysis, liquidity, and SEC filings, we see significant room for growth and innovation. One of our top priorities is to enhance the NLP engine for SEC filing analysis. Currently, the red flag detection relies on simple keyword matches, which may miss deeper, context-driven risks. We aim to improve this by implementing advanced NLP models like transformer-based architectures, for example BERT, that can understand the nuances in financial documents and identify subtle red flags such as lawsuits, financial irregularities, and compliance breaches. This will make SEC flag detection more accurate, scalable, and meaningful. We're also working toward enabling multi-ticker portfolio risk analysis, so users can assess and monitor the overall risk of their investment portfolio in a single view. This includes building visual dashboards, trend insights, and a real-time alerting system that notifies users when their portfolio enters a critical risk zone.

In the future, we plan to:

Expand support for global equities, ETFs, and cryptocurrencies
Integrate ML-driven personalized recommendations
Enable user authentication with OAuth for secured history tracking
Offer custom risk reports
Optimize the mobile experience for on-the-go investors

Lastly, we ran into rate limits with our initial NewsAPI key during testing, which prompted us to quickly set up a new account and reconfigure the backend. This experience highlighted the importance of scalable API management and contingency planning, which we plan to implement in future versions.