hedgequantx 1.1.1 → 1.2.31

package/README.md

@@ -1,60 +1,43 @@
 # HedgeQuantX CLI
 
+```
+██╗  ██╗███████╗██████╗  ██████╗ ███████╗ ██████╗ ██╗   ██╗ █████╗ ███╗   ██╗████████╗██╗  ██╗
+██║  ██║██╔════╝██╔══██╗██╔════╝ ██╔════╝██╔═══██╗██║   ██║██╔══██╗████╗  ██║╚══██╔══╝╚██╗██╔╝
+███████║█████╗  ██║  ██║██║  ███╗█████╗  ██║   ██║██║   ██║███████║██╔██╗ ██║   ██║    ╚███╔╝ 
+██╔══██║██╔══╝  ██║  ██║██║   ██║██╔══╝  ██║▄▄ ██║██║   ██║██╔══██║██║╚██╗██║   ██║    ██╔██╗ 
+██║  ██║███████╗██████╔╝╚██████╔╝███████╗╚██████╔╝╚██████╔╝██║  ██║██║ ╚████║   ██║   ██╔╝ ██╗
+╚═╝  ╚═╝╚══════╝╚═════╝  ╚═════╝ ╚══════╝ ╚══▀▀═╝  ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝   ╚═╝   ╚═╝  ╚═╝
+```
+
 **Prop Futures Algo Trading CLI**
 
 A powerful command-line interface for connecting to prop trading firms and managing your futures trading accounts.
 
+[![npm version](https://img.shields.io/npm/v/hedgequantx.svg)](https://www.npmjs.com/package/hedgequantx)
+[![npm downloads](https://img.shields.io/npm/dm/hedgequantx.svg)](https://www.npmjs.com/package/hedgequantx)
+
 ---
 
 ## Features
 
-- Multi-platform connection support (ProjectX, Rithmic, Tradovate)
-- 19+ supported prop firms via ProjectX
-- Real-time account management
-- View positions, orders, and account stats
-- Secure authentication
-
-## Supported Prop Firms (ProjectX)
-
-| Firm | Status |
-|------|--------|
-| Topstep | Active |
-| Alpha Futures | Active |
-| TickTickTrader | Active |
-| Bulenox | Active |
-| TradeDay | Active |
-| Blusky | Active |
-| Goat Futures | Active |
-| The Futures Desk | Active |
-| DayTraders | Active |
-| E8 Futures | Active |
-| Blue Guardian Futures | Active |
-| FuturesElite | Active |
-| FXIFY | Active |
-| Hola Prime | Active |
-| Top One Futures | Active |
-| Funding Futures | Active |
-| TX3 Funding | Active |
-| Lucid Trading | Active |
-| Tradeify | Active |
-| Earn2Trade | Coming Soon |
+- Multi-platform support (ProjectX, Tradovate, Rithmic)
+- 37 supported prop firms
+- Multi-account connections
+- Real-time stats (balance, P&L, positions)
+- Secure encrypted session storage
+- Auto-update with restart
 
 ---
 
 ## Installation
 
-### Prerequisites
-
-- Node.js >= 16.x
-- npm >= 8.x
-
-### Option 1: Install from GitHub
+### Option 1: NPM (Recommended)
 
 ```bash
-npm install -g github:HedgeQuantX/HQX-CLI
+npm install -g hedgequantx
 ```
 
-### Option 2: Clone and Install (Recommended)
+### Option 2: Clone from GitHub
 
 ```bash
 git clone https://github.com/HedgeQuantX/HQX-CLI.git
@@ -65,92 +48,90 @@ npm link
 
 ---
 
-## Update
-
-To update the CLI to the latest version:
-
-```bash
-cd ~/HQX-CLI && git pull
-```
-
-That's it! Changes are applied immediately. No need to reinstall.
-
-### Option 3: Download and Install
-
-```bash
-# Download the package
-curl -L -o hedgequantx.tgz https://github.com/HedgeQuantX/HQX-CLI/releases/latest/download/hedgequantx-1.0.0.tgz
-
-# Install globally
-npm install -g hedgequantx.tgz
-```
-
----
-
 ## Usage
 
-### Launch the CLI
-
 ```bash
+# Launch CLI
 hedgequantx
-```
 
-### CLI Commands
+# Or use short alias
+hqx
 
-```bash
-hedgequantx --version    # Show version
-hedgequantx --help       # Show help
-hedgequantx status       # Show system status
+# Show version
+hedgequantx version
 ```
 
 ---
 
-## Quick Start
-
-1. **Launch the CLI**
-   ```bash
-   hedgequantx
-   ```
+## Supported Prop Firms (37)
+
+| ProjectX (19) | Rithmic (16) | Tradovate (2) |
+|---------------|--------------|---------------|
+| TopStep | Apex | Apex |
+| Alpha Futures | TopstepTrader | TakeProfitTrader |
+| TickTickTrader | MES Capital | |
+| Bulenox | Bulenox | |
+| TradeDay | TradeFundrr | |
+| Blusky | TheTradingPit | |
+| Goat Futures | FundedFuturesNetwork | |
+| The Futures Desk | PropShopTrader | |
+| DayTraders | 4PropTrader | |
+| E8 Futures | DayTraders.com | |
+| Blue Guardian Futures | 10XFutures | |
+| FuturesElite | LucidTrading | |
+| FXIFY | ThriveTrading | |
+| Hola Prime | LegendsTrading | |
+| Top One Futures | Earn2Trade | |
+| Funding Futures | Tradesea | |
+| TX3 Funding | | |
+| Lucid Trading | | |
+| Tradeify | | |
+
+> **Note:** ProjectX firms are fully supported. Rithmic and Tradovate coming soon.
 
-2. **Select your connection**
-   - ProjectX
-   - Rithmic (coming soon)
-   - Tradovate (coming soon)
-
-3. **Choose your prop firm**
-   - Select from the list of supported firms
+---
 
-4. **Login with your credentials**
-   - Enter your username
-   - Enter your password
+## Dashboard Features
 
-5. **Access your dashboard**
-   - View Accounts
-   - View Positions
-   - View Orders
-   - User Info
+- **View Accounts** - List all trading accounts with balance and status
+- **View Positions** - Open positions with P&L
+- **View Orders** - Pending and filled orders
+- **View Stats** - Trading metrics, equity curve, P&L calendar
+- **User Info** - Account details
+- **Add Prop-Account** - Connect multiple prop firms
+- **Algo-Trading** - Automated trading (coming soon)
+- **Update HQX** - Auto-update with restart
 
 ---
 
 ## Screenshots
 
 ```
-██╗  ██╗███████╗██████╗  ██████╗ ███████╗ ██████╗ ██╗   ██╗ █████╗ ███╗   ██╗████████╗██╗  ██╗
-██║  ██║██╔════╝██╔══██╗██╔════╝ ██╔════╝██╔═══██╗██║   ██║██╔══██╗████╗  ██║╚══██╔══╝╚██╗██╔╝
-███████║█████╗  ██║  ██║██║  ███╗█████╗  ██║   ██║██║   ██║███████║██╔██╗ ██║   ██║    ╚███╔╝ 
-██╔══██║██╔══╝  ██║  ██║██║   ██║██╔══╝  ██║▄▄ ██║██║   ██║██╔══██║██║╚██╗██║   ██║    ██╔██╗ 
-██║  ██║███████╗██████╔╝╚██████╔╝███████╗╚██████╔╝╚██████╔╝██║  ██║██║ ╚████║   ██║   ██╔╝ ██╗
-╚═╝  ╚═╝╚══════╝╚═════╝  ╚═════╝ ╚══════╝ ╚══▀▀═╝  ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝   ╚═╝   ╚═╝  ╚═╝
-────────────────────────────────────────────────────────────────────────────────────────────
-  Prop Futures Algo Trading
-────────────────────────────────────────────────────────────────────────────────────────────
-
-? Choose Your Connection:
-  ❯ ProjectX
-    Rithmic
-    Tradovate
+╔══════════════════════════════════════════════════════════════════════════════════════════════╗
+║██╗  ██╗███████╗██████╗  ██████╗ ███████╗ ██████╗ ██╗   ██╗ █████╗ ███╗   ██╗████████╗██╗  ██╗║
+║██║  ██║██╔════╝██╔══██╗██╔════╝ ██╔════╝██╔═══██╗██║   ██║██╔══██╗████╗  ██║╚══██╔══╝╚██╗██╔╝║
+║███████║█████╗  ██║  ██║██║  ███╗█████╗  ██║   ██║██║   ██║███████║██╔██╗ ██║   ██║    ╚███╔╝ ║
+║██╔══██║██╔══╝  ██║  ██║██║   ██║██╔══╝  ██║▄▄ ██║██║   ██║██╔══██║██║╚██╗██║   ██║    ██╔██╗ ║
+║██║  ██║███████╗██████╔╝╚██████╔╝███████╗╚██████╔╝╚██████╔╝██║  ██║██║ ╚████║   ██║   ██╔╝ ██╗║
+║╚═╝  ╚═╝╚══════╝╚═════╝  ╚═════╝ ╚══════╝ ╚══▀▀═╝  ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝   ╚═╝   ╚═╝  ╚═╝║
+╠══════════════════════════════════════════════════════════════════════════════════════════════╣
+║                              Prop Futures Algo Trading  v1.2.0                               ║
+╠══════════════════════════════════════════════════════════════════════════════════════════════╣
+║         Connections: 1    Accounts: 2    Balance: $299,776    P&L: $-223 (-0.1%)             ║
+╚══════════════════════════════════════════════════════════════════════════════════════════════╝
+
+? Dashboard:
+  > View Accounts
+    View Positions
+    View Orders
+    View Stats
+    User Info
+    Add Prop-Account
+    ──────────────
+    Algo-Trading
     ──────────────
-    Exit
+    Update HQX
+    Disconnect
 ```
 
 ---
@@ -160,45 +141,60 @@ hedgequantx status       # Show system status
 ```
 HQX-CLI/
 ├── bin/
-│   └── cli.js              # Main CLI entry point
+│   └── cli.js                # Entry point
 ├── src/
-│   ├── api/
-│   │   ├── projectx_userapi.json     # ProjectX User API spec
-│   │   └── projectx_gatewayapi.json  # ProjectX Gateway API spec
-│   └── services/
-│       └── projectx.js     # ProjectX API service
+│   ├── app.js                # Main router
+│   ├── config/
+│   │   ├── index.js
+│   │   ├── constants.js
+│   │   └── propfirms.js      # 37 PropFirms config
+│   ├── pages/
+│   │   ├── accounts.js
+│   │   ├── orders.js
+│   │   ├── positions.js
+│   │   ├── stats.js
+│   │   └── user.js
+│   ├── security/
+│   │   ├── encryption.js     # AES-256-GCM
+│   │   ├── validation.js     # Input sanitization
+│   │   └── rateLimit.js      # API rate limiting
+│   ├── services/
+│   │   ├── projectx.js       # ProjectX API
+│   │   ├── session.js        # Encrypted sessions
+│   │   └── hqx-server.js     # HQX Server API
+│   └── ui/
+│       ├── box.js
+│       ├── table.js
+│       └── device.js
 ├── package.json
-├── claude.md               # Development rules
 └── README.md
 ```
 
 ---
 
-## API Documentation
+## Security
 
-### ProjectX APIs
-
-- **UserAPI**: Authentication, account management, stats, trades
-  - Host: `userapi.[propfirm].projectx.com`
-  
-- **GatewayAPI**: Trading operations (orders, positions)
-  - Host: `api.[propfirm].projectx.com`
+- AES-256-GCM encrypted session storage
+- Machine-bound encryption keys
+- Input validation and sanitization
+- API rate limiting
+- Secure file permissions (0600)
 
 ---
 
-## Development
+## Update
 
-### Run in development mode
+The CLI has a built-in update feature:
 
-```bash
-cd HQX-CLI
-npm run dev
-```
+1. Select **Update HQX** from the dashboard
+2. CLI pulls latest changes from GitHub
+3. Installs dependencies
+4. Auto-restarts with new version
 
-### Run tests
+Or manually:
 
 ```bash
-npm test
+cd ~/HQX-CLI && git pull origin main
 ```
 
 ---
@@ -206,22 +202,18 @@ npm test
 ## Roadmap
 
 - [x] ProjectX integration
-- [x] Multi-propfirm support
+- [x] Multi-propfirm support (37 firms)
 - [x] Account viewing
 - [x] Position viewing
 - [x] Order viewing
+- [x] Stats with equity curve
+- [x] Encrypted sessions
+- [x] Multi-account connections
 - [ ] Rithmic integration
 - [ ] Tradovate integration
 - [ ] Algo trading engine
 - [ ] Real-time market data
 - [ ] Order placement
-- [ ] Strategy builder
-
----
-
-## Contributing
-
-Contributions are welcome! Please read our contributing guidelines before submitting a PR.
 
 ---
 
@@ -239,8 +231,8 @@ This software is for educational and informational purposes only. Trading future
 
 ## Support
 
+- Discord: [https://discord.gg/UBKCERctZu](https://discord.gg/UBKCERctZu)
 - GitHub Issues: [https://github.com/HedgeQuantX/HQX-CLI/issues](https://github.com/HedgeQuantX/HQX-CLI/issues)
-- Email: marat.himet@gmail.com
 
 ---