Skip to content

michaelsboost/UpOrDown

Repository files navigation

💹 UpOrDown — Random Trading Game Simulator

🌟 Overview

UpOrDown is a minimalist random trading simulator built to test one simple thesis:
can you be profitable purely by chance with good risk management?

Every trade is a coin flip — results are random, the chart updates instantly, and your survival depends only on position sizing and payout structure.

🛠️ Built Using kodeWeave
Lightweight, fast, and designed for accessibility across devices. No build step required.

🚀 Launch the App

🌍 Try it live: UpOrDown Simulator

No installation required. Fully browser-based!

🛠️ Key Features

🎲 Pure Randomness

  • Each trade resolves instantly as Win or Loss (default 50/50).
  • Chart updates after each click to visually reflect the result.
  • No data feed, no indicators — chance only.

💰 Risk Management Tools

  • Wager type: Fixed Dollar or % of Balance.
  • Adjustable payout % — e.g., 80% = +$80 profit on $100 wager.
  • Start balance configurable with one click.

📊 Performance Tracking

  • Win rate, streaks, best/worst trade.
  • Net P&L, average win/loss, total trades.
  • Export/Import backups in .json format.

⌨️ Hotkeys

  • B → Up (Buy)
  • S → Down (Sell)
  • O → Open Settings

🗂️ Planned Features (TODO)

Coming soon to UpOrDown:

  • 📈 Equity Curve – Track bankroll growth over time
  • 🎯 Presets – House edge, casino-style odds, “teaser edge” modes
  • 🔑 Seeded Randomness – Reproducible simulation runs
  • 🏆 Leaderboard – Compare expectancy across different payout structures and wagers

Getting Started

1️⃣ Install & Run Locally

# Clone the repository
git clone https://github.com/michaelsboost/UpOrDown.git
cd UpOrDown

# Open index.html in a browser

2️⃣ Dependencies

  • Tailwind + lightweight CSS
  • Vanilla JS – no frameworks, just pure JavaScript
  • kodeWeave – Used for prototyping/building

🧠 Contributing

UpOrDown is open for contribution!

  • Fork the repository
  • Create a new branch: (feature/add-equity-curve)
  • Submit a Pull Request

Contributors welcome!

📜 License

Licensed under the MIT License — free to use, remix, and distribute.

Developed by: Michael Schwartz
Maintained by: The open-source community

☕ Support This Project

If UpOrDown was helpful for you, consider showing your appreciation in the following ways:

Your support is greatly appreciated and helps fund this & future projects! 🚀