Skip to content

Latest commit

 

History

55 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Stock Simulator

Introduction

A simple web app to practice buying and selling stocks with virtual money and real market data, with following features:

  1. Simulated Trading: Buy and sell stocks with real-time prices (via Finnhub and Financial Modeling Prep APIs).
  2. Portfolio Dashboard: View cash balance, invested amount, total value, and recent transactions.
  3. Market Overview: Track major indices (S&P 500, Dow Jones, Nasdaq 100) and see your top holding’s price trend. Browse the latest financial news headlines.
  4. Educational Content: Tutorial section and flashcards to learn trading concepts.

Technical Architecture

NBMetadataCache

Developers

  • Manan Patel: Worked on user concretion and transaction history functionality.
  • Viki Yarema: Develop MongoDB database, integrate the Finnhub API.
  • Nikhil Thomas: Worked on dashboard, trade page. Integrate Finnhub API functionality.
  • Kyle Ye: Develop Login, Market, and Tutorial page. Integrate FMP API for Market Trending.

Project Installation

  1. Create a MongoDB instance, either locally or on MongoDB Atlas.
  2. Add the username, password, and cluster address to a .env file in the DjangoProject1 folder. Path to .env file: backend/DjangoProject1/.env
  3. Additionally, get a Finnhub API key and store it there as well, along with your Django secret key. The .env file should look like this:
MONGO_USER=...
MONGO_PASSWORD=...
MONGO_CLUSTER=...
FINNHUB_API_KEY=...
DJANGO_SECRET_KEY=...
  1. Install the python requirements by running: (Optionally create a venv for this project):
    python3 -m venv .venv
    source .venv/bin/activate
    cd backend
    pip install -r requirements.txt
  1. Ensure your MongoDB database is running
  2. Run the following command to start the Django backend:
    python3 manage.py runserver 8000 
  1. Open frontend/index.html in your browser to begin using the application

About

Simple Stock Simulator

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages