📈 nx-stock

Real-Time Stock Market CLI, Portfolio Tracker, Bandarmology & Price Alert for Indonesian Stock Exchange (IHSG).

Bikin kamu tetap fokus ngoding tanpa perlu bolak-balik buka Stockbit atau browser! Dipasang langsung di terminal kesayanganmu.

🔥 Features

• ⚡ Live Watchlist Dashboard (--live): Dashboard auto-refresh real-time dengan tampilan ringkas.
• 💼 Portfolio PnL Tracker: Pantau harga modal (Avg Price), jumlah lot, dan floating cuan/loss (Rp & %).
• 📊 Technical Analysis (check): Deteksi otomatis indikator RSI (14), MA20, MA50, dan sinyal Trend.
• 🕵️ Bandarmology & Volume Spike: Deteksi Volume Ratio vs Rata-Rata 10 Hari (Ultra Spike 🔥) dan dinamika pasar.
• 🔔 Desktop Price Alert: Notifikasi OS & suara (beep) instan saat harga menyentuh target Take Profit atau Stop Loss.
• 🇮🇩 IHSG Native: Otomatis menanganai ticker saham Indonesia (cukup ketik BUMI, BBCA, DEWA, dll).

📦 Installation

Pasang secara global via NPM atau PNPM:

# Via NPM
npm install -g nx-stock

# Atau via PNPM / YARN
pnpm add -g nx-stock
yarn global add nx-stock

🚀 Quick Usage

1. Cek Analisa Saham Spesifik

Analisa fundamental ringkas, rasio PER/PBV, indikator RSI, MA20/MA50, dan sinyal teknikal secara instan:

nx-stock check BUMI
# atau shortcut alias
nx-stock c BBCA

2. Kelola Watchlist & Portofolio

Tambah / Update Saham ke Watchlist (dengan Harga Modal & Lot):

# Tambah ticker biasa
nx-stock w -a DEWA

# Tambah ticker + Data Portofolio (Harga Modal & Lot)
nx-stock w -a BUMI --avg-price 165 --lots 100

Set Target Price Alert (Take Profit / Stop Loss):

# Notifikasi jika BUMI tembus Rp 180 (High) atau turun ke Rp 165 (Low)
nx-stock w --alert BUMI:180:165

# Set target High saja
nx-stock w -al DEWA:480

Hapus Saham dari Watchlist:

nx-stock w -r BUVA

3. Tampilkan Live Dashboard (Split Screen Friendly!)

Jalankan dashboard live auto-refresh yang akan terus memperbarui data pasar di background:

# Refresh tiap 5 detik (Default)
nx-stock w --live

# Refresh dengan interval kustom (Misal: tiap 10 detik)
nx-stock w -l -i 10

💻 CLI Commands Overview

| Command / Flag | Alias | Description | | --------------------------- | :---: | ----------------------------------------------------- | | nx-stock check <ticker> | c | Analisa detail teknikal & fundamental untuk 1 ticker. | | nx-stock watchlist | w | Lihat daftar watchlist dan portofolio. | | -l, --live | — | Mode auto-refresh real-time. | | -i, --interval <sec> | — | Mengatur interval auto-refresh (default: 5s). | | -a, --add <ticker> | — | Menambahkan ticker ke watchlist. | | --avg-price <price> | — | Menentukan harga modal rata-rata beli. | | --lots <lots> | — | Menentukan jumlah lot kepemilikan. | | --alert <ticker:high:low> | — | Menambahkan target harga notifikasi untuk OS. | | -r, --remove <ticker> | — | Menghapus ticker dari watchlist. |

🛠️ Configuration & Storage

Data watchlist, portofolio, dan target alert disimpan secara lokal di komputer kamu pada lokasi berikut:

~/.nx-stock-watchlist.json

Data hanya disimpan secara lokal dan tidak dikirim ke server mana pun.

##📄 License

Distributed under the MIT License.

See the LICENSE file for more information.