https://github.com/ryantusi/stocksavvy

📈 StockSavvy, your streamlined Python and Flask-based web app for stock trading and finance management. StockSavvy allows users to easily create an account, manage their portfolio, and trade stocks with intuitive features.
https://github.com/ryantusi/stocksavvy

database finance flask python stock-trading stocks-api

Last synced: about 2 months ago
JSON representation

📈 StockSavvy, your streamlined Python and Flask-based web app for stock trading and finance management. StockSavvy allows users to easily create an account, manage their portfolio, and trade stocks with intuitive features.

• Host: GitHub
• URL: https://github.com/ryantusi/stocksavvy
• Owner: ryantusi
• License: mit
• Created: 2023-12-22T13:04:28.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-12-23T06:42:33.000Z (over 1 year ago)
• Last Synced: 2025-01-20T23:46:22.268Z (3 months ago)
• Topics: database, finance, flask, python, stock-trading, stocks-api
• Language: Python
• Homepage:
• Size: 2.09 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# StockSavvy 💹

**StockSavvy: Streamlined Stock Trading and Finance** 

Welcome to StockSavvy, your streamlined Python and Flask-based web app for stock trading and finance management.

## Overview

StockSavvy allows users to easily create an account, manage their portfolio, and trade stocks with intuitive features. 

## Features 🚀

- **Account Management**: Users can create accounts or log in securely.

- **Portfolio Overview**: View the current valuation of owned stocks alongside the cash balance.

- **Stock Quoting**: Easily search for stock prices using symbols via an intuitive API request.

- **Buying and Selling**: Seamlessly execute stock trades - buy or sell stocks effortlessly.

- **Transaction History**: Keep track of all transactions, displaying date, time, and price at that moment.

- **Error Handling**: Ensures a smooth experience by handling various errors:

  - Wrong stock symbols

  - Buying more stocks than the cash balance

  - Selling stocks in excess of what's owned

  - Incorrect login credentials

  - Registration with an existing username

## Folder Structure

- 📁 `static`: Contains icons and CSS file

- 📁 `templates`: HTML files for different pages

   - `apology.html`: Error handling

   - `buy.html`: Stock buying page

   - `history.html`: Transaction history page

   - `layout.html`: Main home page

   - `login.html`: User login page

   - `quote.html`: Stock quote page

   - `quoted.html`: Display stock price after search

   - `register.html`: User registration page

   - `sell.html`: Stock selling page

- 📄 `app.py`: Flask app with sessions and routes

   - Uses session and database

   - Contains routes for HTML templates

- 📄 `finance.db`: Main database with tables for users, transactions, and portfolios

- 📄 `helpers.py`: Python module with functions and decorators

   - `apology()`, `login_required()`, `lookup()`, `usd()`

## Requirements

- CS50

- Flask

- Flask_Session

- Requests

- Urllib

- UUID

- Pytz

- Functools

- CSV

- Datetime

- Werkzeug.security

## Technology Used

`Python` `Flask` `HTML` `CSS` `Bootstrap` `SQLite3` `API`

## Screenshots

![Overview](screenshots/StockSavvy.gif)

*Overview: Visual representation of the stock trading web app.*

![Database](screenshots/database.png)

*Database: Track all past transactions, users, and portfolios with date, time, and prices.*

## Usage

1. Clone the repository.

2. Install required dependencies: `pip install cs50 Flask Flask_Session requests pytz`

3. Execute `flask run`.

4. Access the app through the provided localhost URL.

Feel free to contribute and enhance StockSavvy! 🚀📈💼