Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Docs for the development version; the latest release is v0.8.1.

Cheatsheet

One page of the commands people use most. stockwise <command> --help shows every option; the commands reference explains each one.

For step-by-step walkthroughs, see What do you want to do?.

Bare tickers use the Indian market (TCS → TCS.NS). Add -m us, -m uk, -m jp, -m crypto, -m fx, -m commodity … for other markets, or set STOCKWISE_MARKET. Many commands take --json, and tables take --csv (stockwise <command> --help shows which).

Quotes and markets

Do thisCommand
Quote Indian stocksstockwise quote RELIANCE TCS (or bare stockwise RELIANCE)
Quote US stocksstockwise quote AAPL NVDA -m us
Everything about one stockstockwise deep HDFCBANK
Indian and US indicesstockwise markets
One index per exchange worldwidestockwise markets --global
Gainers and losersstockwise movers
Scan all of NIFTY 500 in one NSE request, one cap tierstockwise -m in movers --universe nifty500 --cap mid
Large / mid / small / micro stocks of a screen or heatmapstockwise screen momentum --cap small, stockwise heatmap --cap large
Sector performancestockwise sectors
Find a ticker by namestockwise search "tata motors"
First-run setup: market, holdings import, MCP snippetstockwise init (no prompts without a TTY: init --market in --import groww:FILE --no-mcp)
Check your setupstockwise doctor
Persistent response cache: size, clearstockwise cache status / stockwise cache clear
Pre-load the market universe into cache.dbstockwise cache warm (or --background)
Filter cached stocks offline by cap, sector, P/E, RVOLstockwise cache snapshots --cap large --min-pe 10 --sort roe
Run the background worker (live quotes, tasks, alerts, post-close sync)stockwise worker start / status / stop
Post-close notices: LTCG turns, new quarters, new non-routine NSE filings of held .NS stocks (each sent once)stockwise tasks add eod queues it for a running worker (worker start)
Queue a long job and follow itstockwise tasks add run -- backtest TCS then stockwise tasks / tasks show 1

Analysis

Do thisCommand
Fundamentals in plain Englishstockwise analyze INFY
Key events & filings timelinestockwise events LT
Last 8 quarters: YoY, QoQ, OPM, TTM, beat/missstockwise results TCS · results AAPL -m us --quarters 12 · results TCS --annual
Earnings-season scoreboardstockwise results --universe nifty50 · results --holdings --csv
Positive and negative findingsstockwise insights LT
6-pillar score (not a recommendation)stockwise verdict LT · stockwise verdict LT --explain
Piotroski F-score & Altman Z-scorestockwise score INFY --explain · stockwise scorecard TCS --json
Open and upcoming IPOsstockwise ipo
One IPO: demand, scores and allotment oddsstockwise ipo BCSSL --capital 2.5L
RSI, MACD, Bollinger Bandsstockwise technical TCS -p 6mo --explain
Price chart with volumestockwise history AAPL -m us -p 1y
Compare stocksstockwise compare TCS INFY WIPRO
Volatility, Sharpe, drawdownstockwise risk HDFCBANK
Support and resistancestockwise support RELIANCE
Stop-loss levelsstockwise stoploss TCS --entry 3500
Preset screensstockwise screen growth
Results and dividend datesstockwise calendar

Funds, options, commodities, bonds

Do thisCommand
Find a mutual fundstockwise mf search parag flexi direct
SIP returns (XIRR) for a fundstockwise mf sip 122639 5000 -p 5y
Rank a category by returnstockwise mf screen flexi cap
Regular vs Direct plan cost of the funds you holdstockwise mf bleed --return 10
Option chain with greeksstockwise options chain NIFTY
Put/call ratio, max painstockwise options pcr BANKNIFTY · stockwise options maxpain NIFTY
OI build-up & resistance/support wallsstockwise fno oi NIFTY · stockwise options oi BANKNIFTY -n 5 --explain
Strategy payoffstockwise options payoff NIFTY --strategy iron-condor --width 200
Gold and silver in ₹/10 gstockwise commodity spot
Sovereign Gold Bondsstockwise commodity sgb
G-sec and T-bill yieldsstockwise bonds yields

Portfolio and tax

Do thisCommand
Add a purchase (a lot)stockwise portfolio add TCS 10 3500 --date 2023-04-12
Sell (oldest lots first)stockwise portfolio sell TCS 5 3900
Preview a sale: lots, STCG/LTCG tax, LTCG countdown (saves nothing)stockwise portfolio sell TCS 5 --preview (alias --dry-run)
Regular-plan funds vs Direct: TER gap, yearly and 10Y cost, switch unitsstockwise mf bleed
Holdings, P&L and XIRRstockwise portfolio
Track a mutual fund (AMFI code or ISIN, valued at its NAV)stockwise portfolio add MF:122639 100 80 --date 2024-01-10
Portfolio X-Ray (overlap, concentration, sectors)stockwise portfolio xray · stockwise portfolio xray --json
Import from your brokerstockwise import kite holdings.xlsx (CSV or .xlsx; also groww, upstox, indmoney, cas)
Import a password-protected CAS PDF (needs casparser)stockwise import cas CAS.pdf · casparser ... | stockwise import cas -
Rebuild a symbol’s lots from a dated filestockwise import kite tradebook.csv --replace
One holding’s lots, sales and XIRRstockwise portfolio lots TCS
Compare with NIFTYstockwise portfolio benchmark NIFTY -p 1y
Splits, bonuses, dividendsstockwise portfolio actions --apply
Set target allocationstockwise portfolio target set TCS 25 · stockwise portfolio target show
Inflow rebalance (buy-only)stockwise rebalance --inflow 50000 (buy underweight without selling)
Rebalance with drift bandstockwise rebalance --drift 2.0
Tax-loss & LTCG exemption harveststockwise harvest · stockwise harvest --json
Capital-gains estimatestockwise tax in
ITR Schedule CG CSVstockwise tax export in --out cg.csv
Advance tax schedule & 234C estimatorstockwise tax advance · stockwise tax advance --paid 25000
Advance tax with each payment dated (exact 234C)stockwise tax advance --fy 2025-26 --paid 2025-06-14:3000 --paid 2025-09-10:5000
Everything on one screenstockwise dashboard

Alerts and watchlist

Do thisCommand
Watch stocksstockwise watch add INFY HDFCBANK
Price alertstockwise alert add RELIANCE below 1200
RSI alertstockwise alert add TCS rsi-below 30
Moving-average crossstockwise alert add INFY cross-above-sma 200
Breakout alertstockwise alert add SBIN breakout-high 52
Keep checking during market hoursstockwise alert watch
Set up Telegram/Slack/emailstockwise notify

Planning

Do thisCommand
SIP needed for a targetstockwise goal sip --target 1cr --years 15
Retirement corpus and SIPstockwise goal retire --monthly-expense 80000 --years-to-retire 20 --years-in-retirement 30
Education fundstockwise goal education --cost 25L --years 10
Short goal, ₹10L in hand after taxstockwise goal sip --target 10L --months 9 --net
Save a goal, track itstockwise goal add house --target 50L --by 2031-06 · stockwise goal list
How long a corpus lastsstockwise goal swp --corpus 1cr --withdrawal 50k
Prepay a loan or investstockwise goal prepay --principal 50L --loan-rate 9 --remaining-months 240 --extra 10k
What a past SIP becamestockwise sip NIFTYBEES 5000 -p 5y
What a lump sum becamestockwise whatif TCS 100000 2015-01-01

Strategies and practice

Do thisCommand
Backtest a strategy (after costs)stockwise backtest INFY -s macd
Backtest a basketstockwise backtest portfolio TCS INFY WIPRO -s rsi
Walk-forward teststockwise backtest walkforward TCS -s sma --train 1y --test 3mo
Paper-trade one session, then exit (for cron)stockwise daemon intraday 25000 --once
Replay the 2020 crashstockwise sim replay start covid-crash-2020
Take a challengestockwise sim challenge start beat-the-index
Your badges and best scoresstockwise sim profile
Shareable result cardstockwise sim card --svg card.svg

AI assistants

Do thisCommand
Ask in plain English (local Ollama by default)stockwise ask "how did my portfolio do this month?"
See which tools it ranstockwise ask "compare TCS and INFY on RSI and risk" --verbose
MCP server for Claude, Cursor and other assistantsstockwise mcp
Add it to Claude Codeclaude mcp add stockwise -- stockwise mcp
The MCP tools and their schemasstockwise mcp --list-tools
MCP over HTTPstockwise mcp --http 127.0.0.1:8788

Dashboards and scripting

Do thisCommand
Live terminal dashboardstockwise tui
Web dashboard and JSON APIstockwise serve --open
Pipe into jqstockwise quote TCS INFY --json | jq '.[].regularMarketPrice'
Save your defaultsstockwise config init
Shell completionstockwise completions zsh > ~/.zfunc/_stockwise

Live trading (real money)

Do thisCommand
Connect a brokerstockwise trade setup
Check a broker read-onlystockwise trade selftest
Preview an order, send nothingstockwise trade buy RELIANCE 1 --dry-run
Live holdingsstockwise trade holdings

Every order shows a preview and asks you to type yes. Practise with stockwise sim first. StockWise is not financial advice — see the disclaimer.