Stockify is an intuitive Android application that provides users with real-time stock market data. With a user-friendly interface and dynamic features, users can easily search for stock symbols and view comprehensive information, including current prices, percentage changes, and additional company details.

1. Features
2. Screenshots
3. Installation Instructions
4. Usage
5. Code Overview
6. License
7. Author

• Stock Search: Effortlessly search for stocks by entering their symbol (e.g., AAPL, TSLA) and Clicking on search icon.
• Real-time Stock Data: View current stock price, percentage change, Company name, high/low prices, open/close prices, and the exchange.
• MVVM Architecture: The app is built using the MVVM (Model-View-ViewModel) architecture for better separation of concerns and maintainability.
• Loading Indicator: Shows a loading overlay while fetching data, ensuring a smooth user experience.
• Error Handling: Gracefully handles invalid stock symbols and network issues with informative error messages.
• Dynamic UI Updates: The app changes the background color based on price fluctuations (green for price increases and red for decreases) and displays corresponding up/down images.
• Price Difference: The app shows the difference between the previous and current prices, providing users with insight into stock performance at a glance.
• Periodic Updates: The app fetches updated stock information every minute to ensure users receive the latest data.
• Additional Information: Display company logos and links to official websites.
• Clickable URL: Users can click on the company URL to open the official website in a browser.
• Splash Screen Animation: A visually appealing graph animation is displayed on the splash screen during app launch.
• Bottom Navigation: Navigation between different sections is planned for future implementation.

• Android Studio installed on your machine.
• An API Key from Finnhub or another stock market API.

1. Clone the repository:

   git clone https://github.com/Arnavjain2503/Stockify.git

2. Open the project in Android Studio.

3. Add your API key:

   • Replace the placeholder API key in StockViewModel.java with your own:

     private static final String API_KEY = "your_api_key";

4. Run the app on an emulator or connected Android device.

• Launch the app: The app opens with a splash screen displaying an animated graph for 3 seconds before navigating to the main stock lookup screen.
• Search for stocks: Enter a stock symbol (e.g., AAPL) in the search bar and tap the search icon.
• View stock details: The app displays current prices, percentage changes, high/low prices, company logos, and links to the company’s website.
• Dynamic Feedback: The background color changes to green when the stock price increases and to red when it decreases. An up/down image is shown based on the price trend, along with the difference between the previous and current prices for quick visual feedback.
• Periodic Updates: The app fetches new stock information every minute to keep users updated with the latest market data.

• MainActivity.java: Manages the main UI, user interactions, and displays fetched stock data.
• SplashActivity.java: Shows the splash screen with animation during app launch.
• GraphView.java: Custom view for rendering the graph animation on the splash screen.
• StockViewModel.java: Handles the business logic, fetching data from the Finnhub API via Retrofit.
• StockApiService.java: Defines API endpoints for fetching stock quotes and company profiles.
• CompanyProfileResponse.java & StockQuoteResponse.java: Data models for handling API responses.

• AndroidManifest.xml: Defines application permissions, components, and metadata.
• activity_main.xml: Layout for the main activity, including the search bar and stock data display.
• activity_splash.xml: Layout for the splash screen, showing branding or animations during launch.
• graph_anim.xml: Defines the custom view for rendering animated graphs on the splash screen.
• bottom_nav_menu.xml: Specifies the items and icons for the bottom navigation bar.

• The app integrates with the Finnhub API to fetch real-time stock data, company profiles, and additional information.
• Retrofit is utilized for making efficient network requests with appropriate error handling.

The app requires the following permission in AndroidManifest.xml file:

<uses-permission android:name="android.permission.INTERNET" />

The App uses following Retrofit 2 dependencies in build.gradle (Module: app) file:

implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'

• Java for Android development.
• Retrofit for API requests.
• ViewModel for maintaining a clean separation of UI and business logic.
• Glide for loading images (e.g., company logos).

The app uses the Finnhub API for real-time stock data:

• /quote: Fetches current stock prices, percentage changes, opening price, high/low prices, and previous close.
• /profile2: Retrieves detailed company profile information, including company name, logo, and exchange information.

• The app primarily works with US stock markets. You can check stock prices at any time, but the every-minute update feature will only work during US market hours (9:30 AM to 4:00 PM EST, 7:00 PM to 1:30 AM IST for Indian investors).

• If the network connection is slow, data fetching from the API will take longer, especially when using an Android Virtual Device (AVD). It's recommended to use AVD with a fast network connection. Alternatively, you can run the app on a physical device by connecting via cable or using the APK for smoother performance.

This project is licensed under the MIT License.

Arnav Jain