@nepse-toolkit/cli

CLI for Nepal Stock Exchange — market data, technical analysis, screening, portfolio tracking.

Part of the nepse-toolkit monorepo.

Install

npm install -g @nepse-toolkit/cli

Or run without installing:

npx @nepse-toolkit/cli market

Commands

All commands support --json for machine-readable output.

Market & Index

nepse market                          # Market overview: NEPSE index, turnover, top gainers/losers
nepse sectors                         # Sector indices with rotation analysis
nepse providers                       # Data provider health (NEPSE, MeroLagani, ShareSansar)

Stock Analysis

nepse stock NABIL                     # Current quote: LTP, change, volume, 52-week range
nepse stock NABIL -a                  # Full analysis: quote + technical signals + recommendation
nepse stock NABIL --history           # Price history (OHLCV)
nepse compare NABIL SBL HBL          # Side-by-side comparison (2-5 stocks)

Screening & Opportunities

nepse screen -s commercial_bank       # Filter by sector
nepse screen --gainers                # Top gainers
nepse screen --losers                 # Top losers
nepse opportunities                   # Scan all 7 strategies, ranked by score
nepse opportunities -s oversold_bounce

Floorsheet & Broker Flow

nepse floorsheet NABIL                # Transaction log
nepse floorsheet NABIL -b             # Broker flow: net buy/sell, accumulation signals

Portfolio & Alerts

nepse watchlist add NABIL NLIC        # Add to watchlist
nepse watchlist                       # View watchlist with live prices
nepse portfolio add NABIL 100 850     # Add position (symbol, quantity, buy price)
nepse portfolio                       # View holdings with P&L
nepse alert NABIL above 900           # Set price alert

Backtesting

nepse backtest                        # Compare all 7 strategies
nepse backtest -s momentum_breakout   # Backtest specific strategy
nepse backtest --symbols NABIL,NLIC   # Backtest on specific stocks

Data Sync

nepse sync                            # Bulk sync market data to local SQLite
nepse ipo                             # Current and upcoming IPOs

Command Reference

| Command | Description | Key Flags | |---------|-------------|-----------| | market | NEPSE index, turnover, top movers | --json | | stock SYMBOL | Quote with optional analysis | -a analysis, -h history | | screen | Filter stocks | -s sector, --gainers, --losers, -v min-volume | | opportunities | Find trades via 7 strategies | -s strategy, -n limit | | compare | Side-by-side (2-5 stocks) | --json | | floorsheet | Transactions or broker flow | -b broker mode, -d date | | sectors | Sector rotation analysis | --json | | watchlist | Manage watchlists | -a add, -r remove, -n name | | portfolio | Track holdings and P&L | --add, -s symbol, -q qty, -p price | | alert | Price alerts | --above, --below, -r remove | | backtest | Backtest strategies | -s strategy, -h holding days, -c capital | | ipo | IPO listings | --json | | providers | Provider health | --json | | sync | Sync data to local DB | --json |

License

MIT