@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