Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fractal-solutions/stock-sim

just for fun CLI stock simulator
https://github.com/fractal-solutions/stock-sim

Last synced: 15 days ago
JSON representation

just for fun CLI stock simulator

Awesome Lists containing this project

README

        

# Stonks Market Simulator 📈

A whimsical stock market simulator featuring dynamic stock personalities and random market events.

## Features 🚀

- Real-time stock price simulation with dynamic volatility
- Stocks with distinct personalities that affect their behavior
- Random personality shifts that change stock behavior
- Market events that impact stock prices
- Event history tracking
- Simple buy/sell trading interface
- Portfolio management

## Stock Personalities 🎭

Stocks can shift between different personalities that affect their volatility and event frequency:
- Drama Queen: High volatility, frequent events
- Zen Master: Low volatility, moderate events
- More personalities coming soon!

## Trading Features 💰

- Buy and sell stocks at current market price
- Track your portfolio value and positions
- View transaction history
- Monitor active market events

## Installation 🛠️

1. Clone the repository
2. Open index.html in your browser

## Usage 🎮

- Watch stocks change personality and react to market events
- Buy low and sell high to grow your portfolio
- Track event history and active effects
- Monitor personality shift cooldowns

## Contributing 🤝

Feel free to submit pull requests or open issues to suggest new features or improvements!

## License 📝

MIT License - See LICENSE file for details