KlickAnalytics CLI#

The power of analytics at your fingertips. Pull deep financial intelligence straight into your terminal, agents, scripts, and AI workflows.

Built by the team behind KlickAnalytics.com — a financial markets platform developed by ex-Bloomberg professionals with decades of experience in market data, terminal design, and institutional analytics.

KlickAnalytics CLI is not just a data API — it is a rich analytics engine exposing pre-computed market intelligence: technical signals, earnings move analysis, volatility models, trader statistics, price action strategies, seasonality, and much more. Everything outputs clean JSON, purpose-built for agents and automation.

---

What you can do with the CLI#

• Terminal users — run financial research from your shell without opening a browser
• Developers — integrate analytics into Python scripts, cron jobs, and internal tools
• AI agents — call ka commands as tools inside OpenAI, Claude, LangChain, or any LLM pipeline
• OpenClaw users — wire up full automation across all global asset classes with zero extra code
• Quants & analysts — access pre-built analytics (volatility, quantstats, distributions, seasonality) ready to consume

---

Coverage — 100,000+ symbols globally#

Via the CLI and OpenClaw integration, KlickAnalytics covers the full spectrum of global assets:

• Stocks — US and international equities
• ETFs — all major US and global exchange-traded funds
• Mutual Funds — thousands of funds with performance data
• Crypto — major and long-tail digital assets
• Indices — global benchmark indices
• Commodities, FX, REITs, MLPs — and much more

---

Setup#

bash

# 1. Install
pip install klickanalytics-cli

# 2. Set API key — add to ~/.bashrc or ~/.zshrc for persistence
export KLICKANALYTICS_CLI_API_KEY=your_api_key_here

# 3. Verify
ka help

Get your free API key at klickanalytics.com/signup.

• Free tier: 50 commands/month
• Paid tier: 500 commands/month

---

Command structure#

text

ka [command] -s [SYMBOL] [optional flags]

Common flags#

FlagMeaningExample-sTicker symbol-s MSFT``-sdStart date (YYYY-MM-DD)-sd 2025-01-01``-edEnd date (YYYY-MM-DD)-ed 2025-12-31``-limitMax rows to return-limit 100``-lookbackNumber of bars to look back-lookback 252``-min_daysMinimum days for pattern match-min_days 3``-periodPeriod length-period annual``-tfTimeframe-tf daily``-datatypeOutput format-datatype json``-qNatural language query (ai-chat)-q "your query"

---

Built-in AI Chat Interface#

The CLI includes a direct AI chat interface — ask questions in plain English and get market intelligence back, without writing any code.

bash

ka ai-chat -q "What is the technical outlook for MSFT right now?"
ka ai-chat -q "Summarize the latest earnings surprise history for NVDA"
ka ai-chat -q "Which S&P 500 sectors are showing the strongest momentum this month?"
ka ai-chat -q "Compare volatility between MSFT and AAPL over the last year"

• Ideal for quick research queries without knowing the exact command
• Returns structured, analyst-style responses
• Can be piped into other tools or agent pipelines

---

Full command reference#

See references/commands.md for every command with flags, examples, and output field shapes. Load it when the user asks about a specific command or wants a comprehensive overview.

---

Choosing the right command#

Research goalCommandCurrent price / real-time quoteka quote -s MSFTHistorical OHLCV price dataka prices -s MSFT -sd 2025-01-01Company background, sector, profileka profile -s MSFTEarnings history & EPS vs estimateska earnings -s MSFTHow stock moves around earningska earnings-moves -s MSFTDividend historyka dividends -s MSFTStock split historyka splits -s MSFTComparable / peer companieska peers -s MSFTLatest news digestka news-summary -s MSFTRisk-adjusted performance (Sharpe, CAGR)ka quantstats -s MSFT -limit 252Trader stats (win rate, streaks)ka traderstats -s MSFTTechnical indicators (RSI, MACD, BBands)ka ta -s MSFTBuy/sell signal packka ta-signals -s MSFTVolume profile by price levelka vol-profile -s MSFTUnusual volume spikeska vol-unusual -s MSFTHistorical volatilityka volatility -s MSFT -sd 2025-01-01Price return distribution & skewnesska price-dist -s MSFTFibonacci retracement levelska fib -s MSFT -lookback 360Gap open/fill analysiska gap-analysis -s MSFTUp/down rally streakska updown -s MSFTCandlestick pattern detectionka candle_patterns -s MSFTPrice action strategy analysiska price-actions -s MSFTSeasonal monthly return patternska seasonality -s MSFTBest historical trading dayska bestdays -s MSFTAsk anything in plain Englishka ai-chat -q "your question"

---

Agent & LLM integration#

The CLI is designed as a first-class tool for AI agents. Every command outputs JSON. Each command maps cleanly to a tool definition in any LLM framework.

As a Claude / OpenAI tool#

python

tools = [
    {
        "name": "ka_quote",
        "description": "Fetch real-time market quote for a stock symbol",
        "parameters": {
            "type": "object",
            "properties": {
                "symbol": {"type": "string", "description": "Ticker symbol, e.g. MSFT"}
            },
            "required": ["symbol"]
        }
    },
    {
        "name": "ka_ta_signals",
        "description": "Get technical buy/sell signals for a symbol",
        "parameters": {
            "type": "object",
            "properties": {
                "symbol": {"type": "string"},
                "lookback": {"type": "integer", "description": "Bars to look back"}
            },
            "required": ["symbol"]
        }
    }
]

# Execute on tool call:
import subprocess, json
result = subprocess.run(
    ["ka", "quote", "-s", symbol, "-datatype", "json"],
    capture_output=True, text=True
)
data = json.loads(result.stdout)

In shell scripts and cron jobs#

bash

#!/bin/bash
# Pre-market scan across watchlist
for sym in MSFT AAPL NVDA TSLA AMZN; do
  echo "=== $sym ==="
  ka quote -s $sym -datatype json | jq '.price, .changesPercentage'
done

With OpenClaw — full automation at scale#

OpenClaw is the recommended path for production agent workflows using KlickAnalytics. With OpenClaw + KlickAnalytics CLI you get:

• 100,000+ symbols covered across stocks, ETFs, mutual funds, crypto, indices, FX, commodities, and more
• Full automation — schedule agents to run pre-market scans, earnings monitors, signal alerts, and daily summaries
• Zero glue code — OpenClaw handles orchestration; the CLI handles the analytics
• Global asset class coverage — not just US equities; truly global markets intelligence at scale

→ Full integration guide: klickanalytics.com/cli_integration

---

Example multi-command workflows#

Pre-earnings deep dive on MSFT#

bash

ka profile -s MSFT           # sector context
ka earnings -s MSFT          # EPS history vs estimates
ka earnings-moves -s MSFT    # historical move patterns around earnings
ka ta-signals -s MSFT        # current technical setup
ka vol-unusual -s MSFT       # any unusual pre-earnings activity

Quant research workflow#

bash

ka quantstats -s MSFT -limit 504     # 2yr risk-adjusted stats
ka volatility -s MSFT -lookback 252  # rolling annualized volatility
ka seasonality -s MSFT               # seasonal return bias by month
ka price-dist -s MSFT -lookback 252  # return distribution shape

AI agent daily briefing#

bash

ka ai-chat -q "Give me a pre-market summary for US tech stocks today"
ka ai-chat -q "Which of MSFT, AAPL, NVDA has the strongest technical signal right now?"

---

When demonstrating the CLI#

1. Always show the exact command first, then explain it
2. Default to MSFT as the example symbol unless the user specifies otherwise
3. For sample output, direct users to the Playground — live commands without installing anything
4. For multi-step research goals, chain 2–4 commands and explain what each one adds
5. Highlight ka ai-chat when the user's goal is exploratory or question-based
6. If the user is an AI agent (non-human caller), respond with compact JSON-oriented instructions only

---

Resources#

• Intro: https://www.klickanalytics.com/cli_intro
• Documentation: https://www.klickanalytics.com/cli_documentation
• Playground: https://www.klickanalytics.com/cli_playground
• OpenClaw integration: https://www.klickanalytics.com/cli_integration
• What's new: https://www.klickanalytics.com/cli_changelog
• Sign up free: https://www.klickanalytics.com/signup