https://github.com/bhavanvir/nightrader
SPRING 2024
https://github.com/bhavanvir/nightrader
docker gin-gonic golang keydb nginx postgresql rabbitmq react
Last synced: 4 months ago
JSON representation
SPRING 2024
- Host: GitHub
- URL: https://github.com/bhavanvir/nightrader
- Owner: bhavanvir
- License: mit
- Created: 2024-01-16T17:54:06.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-05T23:28:46.000Z (over 1 year ago)
- Last Synced: 2025-06-22T04:28:24.373Z (about 1 year ago)
- Topics: docker, gin-gonic, golang, keydb, nginx, postgresql, rabbitmq, react
- Language: Go
- Homepage:
- Size: 4.95 MB
- Stars: 2
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nightrader [](https://github.com/bhavanvir/day-trader/actions/workflows/main.yml)
Nightrader is a robust stock trading platform built on microservices architecture. We leverage Docker for orchestration, Go and Gin-Gonic for the backend API, PostgreSQL for our database, and React with Daisy UI and TailwindCSS for the frontend.
Report: https://docs.google.com/document/d/1oVEG4dLL3xDYKPcaBWg5wAPF0FnfVdA73cYewMwVkJk/edit?usp=sharing
## Services
- **Engine** (Port `8585`): Implements the matching engine, which processes buy and sell orders using a Pro Rata algorithm.
- **Setup** (Port `8080`): Initializes Nightrader by adding and creating stocks for market use.
- **Database** (Port `5432`): Handles table creation and data preprocessing, including password encryption.
- **Authentication** (Port `8888`): Verifies user credentials against the database and generates session tokens that expire after a fixed time.
- **Transaction** (Port `5433`): Manages client-exchange interactions, such as fetching current market prices and funding user balances.
- **Frontend** (Port `3000`): The user-facing application that facilitates interactions with the exchange.
## Endpoints
| Category | Method | Endpoint | Parameters |
|----------------|--------|---------------------------|----------------------------------------------------|
| Authentication | POST | /register | {
"username": string,
"password": string,
"name": string
} |
| | POST | /login | {
"user_name": string,
"password": string
} |
| Transaction | GET | /getStockPrices | - |
| | GET | /getWalletBalance | - |
| | GET | /getStockPortfolio | - |
| | GET | /getWalletTransactions | - |
| | GET | /getStockTransactions | - |
| | POST | /addMoneyToWallet | {
"amount": number
} |
| | POST | /placeStockOrder | {
"stock_id": number,
"is_buy": boolean,
"order_type": string,
"quantity": number,
"price": number
} |
| | POST | /cancelStockTransaction | {
"stock_tx_id": string
} |
| Setup | POST | /createStock | {
"stock_name": string
} |
| | POST | /addStockToUser | {
"stock_id": string,
"quantity": number
} |
## Installation
1. **Prerequisites**: Ensure Docker is installed and configured on your system.
2. **Clone the repository**:
```bash
git clone https://github.com/bhavanvir/day-trader.git
```
3. **Navigate to the project directory**:
```bash
cd day-trader
```
4. **Start up all microservices**:
```bash
docker compose up --build -d
```
5. **Access the frontend**:
Open a web browser and go to `localhost:3000` to start trading.
Feel free to reach out if you have any questions or need further assistance. Happy trading!