How to use the ka commands

Full company profile including business description, sector, industry, CEO, employees, IPO date, exchange, country, and website. Output includes a structured summary with key company identifiers and a narrative business overview.

Real-time or latest market quote for any symbol. Returns bid, ask, open, high, low, close, volume, 52-week high/low, market cap, P/E ratio, and day change percentage. Output is a formatted market snapshot.

Multi-field stock screener — filter across 100+ fields: returns, RSI, ADX, MAs, sector, marketcap and more. Supports >, <, =, IN, LIKE operators and AND combinations.

Historical OHLCV (Open, High, Low, Close, Volume) price data with split and dividend adjustments. Supports custom date ranges and result limits. Output includes adjusted and unadjusted close prices for each trading day.

Top N best and worst single-day return events in a symbol's history. Shows date, return percentage, and surrounding market context. Useful for understanding tail risk, volatility events, and how the stock behaves during extreme market moves.

Monthly and quarterly seasonal return patterns based on full price history. Shows average return, win rate, and best/worst months for each calendar period. Useful for timing entries and exits based on historical tendencies.

Statistical price distribution analysis showing where a stock has spent most of its time. Includes frequency histogram, percentile ranking of current price, mean, median, standard deviation, and skewness of the price distribution. Useful for understanding price ranges and current price context.

Analyzes historical rally and pullback cycles. Shows average rally duration (days), average rally magnitude (%), average pullback duration, average pullback magnitude, and current cycle status. Useful for estimating how long and how far typical moves last for a given symbol.

Statistical analysis of historical price gaps. Categorizes gaps by type (gap-up / gap-down), shows fill rate (how often gaps close), average gap size, median time to fill, and frequency. Useful for gap trading strategies and understanding price behavior after gaps.

Quarterly and annual earnings data including EPS (actual vs estimate), revenue (actual vs estimate), surprise percentage, and reporting date. Useful for tracking earnings trends and beat/miss history over time.

Get historical dividends of a symbol

Get historical splits of a symbol

Historical earnings reaction analysis: how much the stock moved in the trading session immediately after each earnings report. Shows pre-earnings implied move vs actual move, gap direction, and trend over recent quarters. Useful for options traders and earnings event strategies.

Summary of recent earnings performance trends. Shows EPS and revenue trajectory over the last 8-12 quarters, growth rates, beat/miss streak, and forward estimates if available. Provides a quick fundamental health check through the earnings lens.

Post-earnings price drift analysis: how the stock performs in the 1, 5, 10, 20, and 60 days after each earnings report. Shows average drift by beat/miss/in-line outcome, and cumulative drift chart. Based on the academic Post-Earnings Announcement Drift (PEAD) effect.

Detected candlestick patterns in recent price history. Identifies reversal and continuation patterns including Doji, Hammer, Shooting Star, Engulfing, Morning/Evening Star, and Harami. Each pattern shows detection date, direction (bullish/bearish), and signal strength.

Fibonacci retracement and extension levels calculated from the most significant recent swing high and low. Shows key levels at 23.6%, 38.2%, 50%, 61.8%, 78.6%, and extension levels at 127.2% and 161.8%. Useful for identifying potential support, resistance, and price targets.

Price action signal analysis including breakout detection, support/resistance tests, trend line breaks, and inside/outside bar patterns. Shows recent signals with date, pattern type, direction, and historical success rate for each pattern type.

Full technical analysis report combining price data with key indicators. Includes RSI (9/14/20), MACD line/signal/histogram, Bollinger Bands, ATR, ADX/+DI/-DI, all moving averages (SMA/EMA 20/50/100/200), and a composite signal summary. Best for a quick complete technical picture of any symbol.

Comprehensive technical signal pack covering 15+ indicators. Includes MA crossover signals (SMA/EMA 20/50/200), RSI overbought/oversold, MACD crossover, Bollinger Band squeeze/breakout, Stochastic, ADX trend strength, and CCI signals. Output: signal table with direction (buy/sell/neutral) and strength.

Multi-symbol 0-100 composite score leaderboard. Ranks symbols across 6 components: Momentum (25%), Trend Quality (20%), Relative Strength (15%), RSI Positioning (15%), Volume Confirmation (15%), and ATH Distance (10%). Outputs a ranked leaderboard for quick comparative screening.

Identifies key support and resistance levels using three methods: volume profile (high-volume nodes), swing pivot analysis (local H/L extremes), and price clustering density (KDE-based). Levels are scored 0-100 based on volume, touches, density, recency, and method overlap. Outputs separate support and resistance lists sorted by proximity to current price.

5-component trend quality score (0-100) covering: R² of log-price regression (30%), ADX strength (25%), Higher High/Higher Low consistency (20%), volume-adjusted slope t-statistic (15%), and percentage of trending days (10%). Output includes multi-timeframe scores (20d, 63d, 126d) plus full window, with detailed component breakdown.

Scans 50+ chart patterns across 8 categories: reversal (double top/bottom, H&S, triple top/bottom, V-reversal), continuation (flags, pennants, wedges, rectangle, cup & handle), bilateral (symmetrical triangle, broadening), directional (ascending/descending triangle, channel), volatility (VCP, NR4/NR7, compression, gap consolidation), harmonic (ABCD, Gartley, Bat, Butterfly, Crab), price action (BOS/CHoCH, FVG, pin bars, engulfing, liquidity sweep, order block), and hybrid (short squeeze, HVN breakout, Wyckoff). Each detected pattern returns confidence score, active/historical status, key levels (breakout, target, stop), and notes.

Historical (realized) volatility analysis across multiple rolling windows (10d, 20d, 30d, 60d, 90d, 1y). Shows annualized volatility percentages, volatility trend, and comparison to 52-week average. Useful for options pricing, risk assessment, and position sizing.

Volume profile analysis showing price levels with the highest and lowest trading activity. Identifies the Point of Control (highest volume price), Value Area High/Low (70% of volume range), and high-volume nodes (HVN) / low-volume nodes (LVN). Key for institutional-level support/resistance analysis.

Detects days with statistically unusual trading volume — both spikes and unusually low volume. Shows date, actual volume, average volume, volume ratio, and price return on that day. Useful for spotting institutional accumulation, distribution, or news-driven volume events.

Comprehensive quantitative statistics report. Includes CAGR, Sharpe ratio, Sortino ratio, Calmar ratio, max drawdown, win rate, profit factor, average gain/loss, best/worst day, monthly returns breakdown, and risk-adjusted performance metrics.

Trading-focused statistics: win rate, average gain, average loss, profit factor, expectancy, average holding period, largest win/loss, and consecutive win/loss streaks. Helps evaluate the historical tradability and edge of a symbol.

Pearson correlation matrix for 2-10 symbols over a selected time period. Shows pairwise correlations from -1 (perfectly inverse) to +1 (perfectly correlated). Useful for portfolio diversification analysis and identifying hedging relationships. Includes a formatted heatmap-style text output.

Comprehensive drawdown analysis showing all historical drawdown periods. Includes maximum drawdown, average drawdown, median recovery time, current drawdown from peak, longest drawdown period, and underwater equity curve. Essential for risk assessment and strategy evaluation.

Multi-period momentum analysis showing returns across 1-day, 1-week, 1-month, 3-month, 6-month, and 1-year timeframes. Includes momentum rank within peer group, RSI, trend direction, and 52-week high/low context. Useful for momentum screening and trend confirmation.

Side-by-side comparison of 2-10 symbols across key metrics: returns (1d/1m/3m/1y), volatility, Sharpe ratio, beta vs SPY, RSI, ADX, max drawdown, and market cap. Output is a formatted comparison table. Ideal for peer analysis, ETF comparison, and portfolio candidate screening.

Beta analysis vs a benchmark (default: SPY). Reports beta, alpha, R-squared, correlation, and tracking error over multiple timeframes. Includes rolling beta chart to show how beta has changed over time. Useful for understanding a stock's systematic risk and market sensitivity.

Relative strength rating (0-99) measuring price performance vs a universe of stocks and a benchmark over multiple periods. A score of 99 means the stock outperformed 99% of the universe. Includes 1-month, 3-month, 6-month, and 1-year RS components with composite score.

Multi-type streak analysis for a symbol. Tracks consecutive up/down price days, days trading above or below key moving averages (SMA20, SMA50, SMA200), consecutive high or low volume days, and RSI zone streaks (overbought, oversold, bullish, bearish). Each streak type shows the current active streak, historical stats (count, average length, max length, average return), and the top longest historical streaks. Use -type to focus on a specific streak category, -threshold to filter noise from small price moves, and -lookback to control the analysis window.

Pairs trading statistical framework for two symbols. Computes OLS hedge ratio, log-price spread, rolling z-score with historical extremes, ADF cointegration test (pure numpy — no statsmodels), half-life of mean reversion via Ornstein-Uhlenbeck regression, price correlation, and generates a directional entry/exit signal (LONG_SPREAD / SHORT_SPREAD / WATCH / NEUTRAL) based on configurable z-score thresholds. Parameters: symbol (2 tickers), lookback (bars), zscore_window, spread_type (log/price), entry_z, exit_z, adf_maxlag.

Market regime detection for a symbol. Classifies the current regime using five statistical lenses: (1) Trend — ADX, +DI/-DI direction, SMA alignment; (2) Volatility — short vs long HV ratio and percentile rank; (3) Memory — Hurst exponent via R/S analysis (pure numpy) and return autocorrelation; (4) Structure — price vs SMA50/200, SMA slope. Outputs primary regime (TRENDING-UP / TRENDING-DOWN / RANGING / MEAN-REVERTING / HIGH-VOL-CHOPPY / LOW-VOL-COMPRESSION / CRASH-TRENDING / BREAKOUT-RALLY), plus directional / volatility / memory sub-regimes and a concrete strategy suggestion.

Stretch & Reversion Analysis — quantifies how far price is from its mean and historically what happens next. Computes z-score of close vs SMA20/50/200 (rolling std), Bollinger %B and bandwidth (20d 2σ), RSI(14) with overbought/oversold label, % deviation from each MA, and stretch level (NEUTRAL/MILD/MODERATE/EXTREME). The key feature: finds every historical occurrence of a similar stretch event (same direction, z-score above threshold) and computes forward returns at 5d/10d/20d/63d with mean, median, p10/p90 distribution, positive-day percentage, reversion probability (% of events where |z| dropped back below exit_z), and median/average days to revert.

Custom OHLCV formula scanner. Evaluate any mathematical expression over historical price data and see when the condition was true. Supports functions like avg(), std(), max(), min() over rolling windows. Useful for backtesting entry signals and custom indicator research.

Portfolio-level analytics for 2-20 symbols with optional position details (shares, cost basis, purchase date). Computes weighted returns, portfolio volatility, Sharpe ratio, correlation matrix, individual risk contribution, and minimum-variance optimization. Holdings format: SYMBOL:shares:avg_cost:purchase_date (all fields after symbol are optional).

Comprehensive risk dashboard computing: VaR (95% and 99% confidence), CVaR/Expected Shortfall, Ulcer Index, Pain Ratio, Tail Ratio, Skewness, Excess Kurtosis, Downside Deviation, Sortino Ratio, and Calmar Ratio. All computed from raw price history in Python — no reliance on external risk databases.

Side-by-side comparison of peer companies in the same sector/industry. Shows current price, 1-month and 1-year return, market cap, P/E ratio, and RSI for each peer. Useful for sector rotation and relative value analysis.

AI-generated summary of the latest news and sentiment for a symbol. Aggregates recent news articles, extracts key themes, and provides an overall sentiment assessment (bullish/bearish/neutral). Useful for quick fundamental event scanning.

AI-powered technical chart pattern analysis. Identifies chart patterns (head & shoulders, cup & handle, triangles, flags, double tops/bottoms), evaluates trend structure, key support/resistance, and provides a narrative summary of the current technical setup. Powered by Claude AI.

List all available KlickAnalytics CLI commands with descriptions and sample usage.

View the KlickAnalytics CLI changelog — lists all recent updates, new commands, and improvements.

Ask AI any market question — uses GPT to answer with context from KlickAnalytics data. Supports free-form queries about stocks, markets, earnings, and more.

Next and previous earnings dates for one or more symbols. Shows days until next earnings, reporting time (BMO/AMC), estimated EPS, and previous quarter results. Flags imminent earnings with warnings.

Quarterly and annual financial statements: income statement (revenue, margins, EPS), balance sheet (assets, debt, equity), cash flow (operating CF, FCF, buybacks), and key metrics (P/E, P/B, ROE, debt/equity, dividend yield). Powered by Financial Modeling Prep.

Forward analyst estimates and consensus: EPS and revenue forecasts (low/avg/high), consensus price target with implied upside, and recent analyst rating changes with firm names and grade shifts.

Recent insider trading activity from SEC Form 4 filings. Shows insider buys, sells, and option exercises with transaction dates, prices, share counts, and dollar values. Includes net buying/selling sentiment summary.

Return distribution deep-dive with histogram, normality diagnostics, and tail risk analysis. Shows daily/weekly/monthly return histogram, Jarque-Bera normality test, skewness and kurtosis, fat tail analysis (actual vs normal at ±1/2/3 sigma), empirical VaR and CVaR (Expected Shortfall) at 95/99%, return deciles, gain/loss ratio, and rolling skewness/kurtosis trend. Answers: how non-normal is this stock, and is the distribution getting more dangerous?

Composable chart image generator — build any technical chart by stacking overlays on the price axis and indicator panels below. Overlays: sma(), ema(), bb(), kc(), vwap, env(). Panels: vol, rsi(), macd(), stoch(), adx(), obv, atr(), cci(), willr(), mfi(). Each indicator takes inline params like bb(20,2.5) or macd(12,26,9). Special types: compare (multi-symbol), drawdown, histogram. Custom title via -title. Dark and light themes. Returns image/png or base64 JSON.

Aggregate technical signal scan across your watchlist. For each symbol: RSI zone, MACD signal, MA alignment (bullish/bearish), ADX trend strength, and a net signal score. One table showing which names have the most bullish or bearish confluence right now. Supports up to 15 symbols.

Bollinger Band squeeze detector (TTM Squeeze inspired). When Bollinger Bands contract inside Keltner Channels, volatility is compressed and a directional explosion is imminent. Shows current squeeze status (on/off/fired), squeeze duration, momentum direction bias, BB width percentile, historical squeeze events with 5d/10d/20d post-squeeze returns, win rates, and bullish/bearish outcome ratios. Includes recent bar-by-bar squeeze + momentum table.

Multi-timeframe trend sweep for 1-20 symbols. For each symbol, analyzes trend direction on daily, weekly, and monthly timeframes using SMA alignment (10/20/50/200), ADX trend strength, DI+/DI- directional indicators, and 10-bar rate of change. Master alignment table shows which symbols are aligned across all timeframes (ALIGNED UP/DOWN) vs conflicted. Includes per-symbol detail with price-vs-MA checks, SMA stack order, and ADX strength labels.

Entry/exit zone calculator combining Fibonacci retracements, pivot points (daily/weekly/monthly), VWAP anchored levels (YTD/QTD/MTD with sigma bands), and ATR-based stop/target zones into one actionable table. Shows ATR stops (tight/normal/wide), targets at 1R/2R/3R reward, all pivot levels, Fibonacci retracement and extension levels, nearest support/resistance with distance, and a unified sorted level map with current price marker.

Trend exhaustion scanner — detects when a trend is running on fumes before reversal. Combines 5 signals: RSI divergence (price new high, RSI lower high), volume divergence (price extends on fading volume), DeMark TD Sequential countdown (9/13 setups), MA extension z-score (distance from 20/50/200 SMA), and RSI overbought/oversold extremes. Outputs a 0-100 composite exhaustion score with active signal list and per-component detail.

Variance-covariance matrix with eigenvalue decomposition (PCA). Returns the full annualized covariance matrix, correlation matrix, principal component explained variance, PC loadings per symbol, diversification ratio, effective number of independent bets, and diversification quality assessment. Foundation for mean-variance optimization and portfolio risk analysis.

Multi-symbol performance heatmap across 7 timeframes (1d, 1w, 1m, 3m, 6m, YTD, 1y). Shows returns table with Best/Worst/Avg rows and per-period rankings. Up to 10 symbols.

Relative Rotation Graph — classifies symbols into LEADING, WEAKENING, LAGGING, or IMPROVING quadrants based on JdK RS-Ratio and RS-Momentum vs a benchmark. Includes ASCII scatter plot, direction/heading, and relative performance.

Basket performance tracker with equal-weight or custom weights. Shows cumulative NAV, daily attribution by symbol, rolling Sharpe, max drawdown, best/worst contributor, and period sub-returns. Like a mini-fund NAV with full P&L breakdown. Up to 15 symbols.

Multi-factor exposure analysis across a group of symbols. Scores each stock on 5 dimensions: Momentum (3m/6m/12m returns, RSI), Value (P/E, P/B, EV/EBITDA, dividend yield), Quality (ROE, net margin, operating margin, debt/equity), Size (market cap rank), and Volatility (annualized vol, max drawdown). Quintile ranking 1-5 within the group, composite score, factor radar per stock, and group factor summary showing which dimension differentiates the group most.

Monte Carlo price simulation — generates 1000+ forward paths based on historical return distribution fitted to a scaled t-distribution (captures fat tails). Returns median, 5th/95th percentile cone over time, probability of positive return, probability of hitting a target price, terminal price histogram, and cone snapshots at key days. Useful for options pricing intuition, position sizing, and risk scenario planning.

Multi-symbol event study inspired by Kensho-style analytics. Define conditions on one or more trigger symbols (e.g. TSLA|C>avg(C,50)) and the engine finds every date where ALL conditions fire simultaneously. Then it measures how a basket of target symbols performs around those events: buy N days before, sell M days after. Returns event count, year/month occurrence matrix, average returns, win rate, profit factor, median return, and best/worst trades per symbol. Historical trades table is available on request with -trades flag.

Deep tail risk analytics for 1-10 symbols. Computes Value-at-Risk (95/99) using historical, normal, and Cornish-Fisher methods. Includes CVaR/Expected Shortfall, skewness, excess kurtosis, tail ratio, multi-horizon risk (1d/5d/20d), drawdown-at-risk, loss frequency distribution, and the 5 worst historical days, weeks, and months. Shows dollar VaR on a $10k position. Multi-symbol mode adds a comparison table. What's the real downside beyond standard deviation?

Signal decay analysis — after RSI, MACD, MA-cross, Bollinger Band, volume spike, or gap signals fire, what are the forward returns at 1d/3d/5d/10d/20d horizons? Shows hit count, average return, median, win rate, profit factor, t-statistic, and a verdict on whether the signal has statistically significant alpha or is noise. Supports individual signals (rsi, macd, bb, ma, vol, gap) or all at once for comparison. 11 built-in signal types with automatic detection.

Hidden Markov Model regime detection — fits a 2-3 state Gaussian HMM to daily returns using the Baum-Welch (EM) algorithm. Identifies bull/bear/sideways regimes probabilistically. Shows current regime with state probabilities, transition probability matrix with expected duration per regime, per-regime statistics (ann return, volatility, % positive days, best/worst day), emission parameters, and full regime history timeline. More rigorous than rule-based detection.

Gap fade probability engine — analyzes every historical gap (up/down) by size category (tiny/small/medium/large/huge) and calculates same-day fill rate, multi-day fill rate, average fill time, continuation %, and average close return. Shows today's gap with a fade/no-fade verdict based on historical fill rate for that gap type. Includes day-of-week fill rates, recent gap history, and a fade strategy guide.

Composite quantitative ranking for 2-20 symbols across 6 dimensions: Momentum (3m/6m/12m returns, 25%), Quality (Sharpe/Sortino, 20%), Trend (ADX/MA alignment, 20%), Risk (drawdown/volatility, 15%), Mean-Reversion (z-score/52w distance, 10%), Volume (rel volume/OBV slope, 10%). Each dimension scored 0-100 as percentile within the peer group. Leaderboard with composite score, dimension leaders, detailed metrics, and MA alignment table.

Price ratio tracking between 2-3 symbols. Shows ratio mean, current z-score, Bollinger bands on the ratio, and reversion signals. Simpler relative-value monitoring compared to pairs (which focuses on cointegration/hedge ratios). Great for sector pairs like XLE/XLF or stock pairs like TSLA/NVDA.

Backtests a trading strategy defined by entry and exit conditions written in the OHLCV expression language. Supports bar offsets (C[-1]), rolling functions (avg, ema, rsi, atr, std, zscore), cross-asset indicators (macd, bbupper/bbmid/bblower, adx, diplus/diminus, stochk/stochd, cci, willr, obv, roc), and logical operators (and, or). Returns performance stats: total trades, win rate, gross profit/loss, net PnL, profit factor, avg win/loss, best/worst trade, avg bars held, max drawdown. Add -trades 1 to show full historical trade log.

Fetches live intraday OHLCV bars for a symbol from Financial Modeling Prep and computes intraday indicators: EMA(9), EMA(20), EMA(50), RSI(14), and MACD(12,26,9). Returns a session summary (session open/high/low, return%, range%), the latest bar, indicator values, trend/RSI/MACD signal labels (BULLISH/BEARISH/MIXED/OVERBOUGHT/OVERSOLD), and a recent 15-bar OHLCV table. Timeframes: 1min, 5min (default), 15min, 30min, 1hour, 4hour. Bar count is capped per timeframe (1min max 780, 5min max 780, 15min max 520, 30min max 520, 1hour max 400, 4hour max 240).

Computes VWAP (Volume Weighted Average Price) anchored to the first bar loaded, with ±1σ and ±2σ standard deviation bands. Returns: VWAP value, upper/lower band levels, current price deviation (absolute and %), position label (ABOVE_VWAP_2SD / ABOVE_VWAP_1SD / ABOVE_VWAP / AT_VWAP / BELOW_VWAP / BELOW_VWAP_1SD / BELOW_VWAP_2SD), VWAP slope (RISING/FLAT/FALLING over last N bars), overall bias label, and a recent 10-bar table with per-bar VWAP and deviation %. Timeframes: 1min, 5min (default), 15min, 30min, 1hour, 4hour.

Computes the Opening Range (ORH/ORL) from the first N minutes of the most recent trading session. Reports breakout status (LONG_BREAKOUT / SHORT_BREAKOUT / NO_BREAKOUT / ORB_FORMING), extension amount and %, extension targets at 1× and 2× the range width, daily ATR comparison with range quality label (TIGHT/NORMAL/WIDE/VERY_WIDE), and session progress. Period can be 5–120 min (default 30). Timeframes: 1min (default), 5min, 15min, 30min, 1hour, 4hour.

Intraday Relative Volume (RVOL) — today's volume vs historical average at the same time of day across prior sessions. Reports per-bar RVOL, cumulative RVOL, projected daily volume, volume trend (ACCELERATING/DECELERATING/STEADY), and RVOL classification.

Intraday key price levels — VWAP ± 1σ/2σ bands, session high/low, previous session close/high/low, swing pivots, and volume nodes. All levels ranked by proximity to current price and labeled SUPPORT or RESISTANCE.

Intraday market regime detection — classifies current price structure as TRENDING_UP, TRENDING_DOWN, RANGING, or MEAN_REVERTING with a HIGH/NORMAL/LOW volatility overlay. Uses ADX+DI±, R² (trend linearity), ATR ratio, VWAP cross count, and HH/HL bar consistency.

Intraday volume-by-price profile — POC (Point of Control), Value Area High/Low, High/Low Volume Nodes, balance/skew classification, and ASCII histogram. Shows where the market accepted and rejected value within the current session.

Premarket gap analysis — classifies the overnight gap (FULL/PARTIAL UP/DOWN, NO_GAP), measures gap vs daily ATR, shows previous session reference levels (close/high/low/VWAP), extension targets, and strategy implications per gap type.

Intraday screener — screen multiple symbols on live intraday metrics (change%, RVOL, RSI, ADX, VWAP deviation, gap%). Concurrent API calls for speed. Supports filter expressions and sortable leaderboard output. Up to 50 symbols per request.

Cross-sectional dispersion analysis — measures how spread out returns are within a basket of symbols. High dispersion = stock-picking market. Low dispersion = macro-driven, trade the index. Shows rolling dispersion, percentile rank, regime, avg pairwise correlation, per-symbol outlier analysis.

Cross-correlation at various lags (1-5 days) between all pairs in a basket. Finds predictive relationships: does AMD move 1 day before NVDA? Does SPY lead the group? Returns lag matrix, correlation at best lag, predictive pairs ranked by improvement, and leader/follower rankings.

Activate a specialized financial agent to analyze a symbol. Each agent has a unique persona, expertise, analytical lens, and output format. The agent auto-runs its priority commands, feeds the data to an LLM, and delivers structured analysis through its specialized lens. Run without arguments to see available agents.

Free-form chat with a specialized financial agent. Ask any question and the agent responds through its unique expertise lens. Automatically detects symbols in your message and runs relevant analysis commands. Provide -agent to select the persona.