Project Goals
This project aims to provide automated financial analysis and stock price forecasting using a combination of:
TimeGPT for time-series forecasting (3-month stock price prediction).
GPT-4o-mini for textual financial analysis.
Yahoo Finance API for fetching financial data.
FastAPI for API deployment.
The API is designed for investors, analysts, and researchers who need quick insights into company financials and stock price trends.
Algorithm & Model Overview
1️⃣ Data Collection and Preparation
Yahoo Finance API is used to retrieve historical stock prices and financial metrics (financial ratios and balance sheet data).
2–3 key indicators are selected from each financial reporting block, covering profitability, liquidity, and indebtedness.
Time series are constructed based on quarterly stock prices.
2️⃣ Model Training or Adaptation
GPT-4o-mini is used to generate text-based analysis of financial indicators. Prompts are dynamic and include real values for precision.
TimeGPT is applied to forecast stock prices 3 months ahead.
FastAPI integrates all modules into a REST API for ease of use.
3️⃣ Solution Integration
The API provides users with a structured financial analysis and stock price forecast.
All modules are organized according to the clean architecture principle, ensuring separation of logic.
Example of a Standard Report Description Generated by ChatGPT-4
Intel Corporation (ticker: INTC) has published its financial results for the fourth quarter and the full year of 2024. For the year, the company’s revenue amounted to 53.1 billion, which is 2% less compared to the previous year. The net loss reached 18.76 billion, while in 2023, the company had a net profit of 1.69 billion.
intc.com
In the fourth quarter of 2024, Intel's revenue was 14.3 billion, representing a 7% decrease compared to the same period in the previous year. The net loss for this period was 126 million, whereas in Q4 2023, the company had a net profit of $2.7 billion.
Example API Output:
{
"company": "Intel Corporation",
"financials": {
"profitability": "### Financial Analysis of Return on Assets (ROA) for Intel Corporation\n\nROA Value: -9.55%\n\n#### Interpretation of the Value\nA Return on Assets (ROA) of -9.55% indicates that Intel Corporation is generating a loss relative to its total assets. This negative value suggests that the company is not efficiently utilizing its assets to generate profits, which is a concerning sign for investors and stakeholders.\n\n#### Trend Analysis\nThe recent trend for Intel's ROA has been decreasing. A sustained decline in ROA can signal operational inefficiencies, increased costs, or challenges in revenue generation, which may stem from competitive pressures or market changes. This trend is particularly troubling as it suggests that the company's ability to leverage its assets effectively is worsening over time.\n\n#### Industry Comparison\nWhen compared to the semiconductor industry average, which typically ranges from 10% to 20% for established companies, Intel's ROA of -9.55% is significantly below par",
"indebtedness": "### Financial Analysis of Intel Corporation's Debt to Equity Ratio\n\nDebt to Equity Ratio: 0.50\n\n#### Interpretation of the Value\nA Debt to Equity (D/E) ratio of 0.50 indicates that Intel Corporation has $0.50 of debt for every dollar of equity. This is generally considered a moderate level of leverage, suggesting that the company is using a balanced approach to financing its operations through both debt and equity.\n\n#### Assessment of the Value\n- Good or Bad?: A D/E ratio of 0.50 is typically seen as favorable. It implies that Intel is not overly reliant on debt, which can reduce financial risk, especially in a volatile market. A lower ratio can also indicate better financial health and stability.\n\n#### Recent Trend\n- Trend Analysis: Intel's D/E ratio has been relatively stable in recent years, suggesting that the company has maintained a consistent approach to its capital structure. There have been no significant spikes or drops, indicating",
"liquidity": "### Financial Analysis of Intel Corporation's Current Ratio\n\nCurrent Ratio Value: 1.33 (rounded from 1.3268659227275277)\n\n#### Interpretation of Current Ratio\nThe current ratio is a liquidity metric that measures a company's ability to cover its short-term liabilities with its short-term assets. A current ratio above 1 indicates that the company has more current assets than current liabilities, suggesting a good short-term financial health.\n\n#### Assessment of the Value\n- Good or Bad: A current ratio of 1.33 is generally considered acceptable. It indicates that Intel has sufficient short-term assets to meet its short-term obligations, which is a positive sign for investors and creditors. However, it is not excessively high, which could indicate inefficiency in asset utilization.\n\n#### Recent Trend\n- Trend Analysis: If recent financial reports show that Intel's current ratio has been increasing over the past few quarters, this would suggest improving liquidity and financial stability. Conversely, if the trend has been",
"stock_price_forecast (3 month)": 22.141623
}
}
Reports are generated in a structured manner, with clear metric explanations, benchmark values, and industry comparisons—making them accessible even to less experienced analysts.
1️⃣ Evaluation of Achievements
2️⃣ Opportunities for Future Improvement
There are no datasets linked
There are no datasets linked