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
kacommands 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
# 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
ka [command] -s [SYMBOL] [optional flags]
Common flags
| Flag | Meaning | Example |
|---|---|---|
-s | Ticker symbol | -s MSFT |
-sd | Start date (YYYY-MM-DD) | -sd 2025-01-01 |
-ed | End date (YYYY-MM-DD) | -ed 2025-12-31 |
-limit | Max rows to return | -limit 100 |
-lookback | Number of bars to look back | -lookback 252 |
-min_days | Minimum days for pattern match | -min_days 3 |
-period | Period length | -period annual |
-tf | Timeframe | -tf daily |
-datatype | Output format | -datatype json |
-q | Natural 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.
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 goal | Command |
|---|---|
| Current price / real-time quote | ka quote -s MSFT |
| Historical OHLCV price data | ka prices -s MSFT -sd 2025-01-01 |
| Company background, sector, profile | ka profile -s MSFT |
| Earnings history & EPS vs estimates | ka earnings -s MSFT |
| How stock moves around earnings | ka earnings-moves -s MSFT |
| Dividend history | ka dividends -s MSFT |
| Stock split history | ka splits -s MSFT |
| Comparable / peer companies | ka peers -s MSFT |
| Latest news digest | ka news-summary -s MSFT |
| Risk-adjusted performance (Sharpe, CAGR) | ka quantstats -s MSFT -limit 252 |
| Trader stats (win rate, streaks) | ka traderstats -s MSFT |
| Technical indicators (RSI, MACD, BBands) | ka ta -s MSFT |
| Buy/sell signal pack | ka ta-signals -s MSFT |
| Volume profile by price level | ka vol-profile -s MSFT |
| Unusual volume spikes | ka vol-unusual -s MSFT |
| Historical volatility | ka volatility -s MSFT -sd 2025-01-01 |
| Price return distribution & skewness | ka price-dist -s MSFT |
| Fibonacci retracement levels | ka fib -s MSFT -lookback 360 |
| Gap open/fill analysis | ka gap-analysis -s MSFT |
| Up/down rally streaks | ka updown -s MSFT |
| Candlestick pattern detection | ka candle_patterns -s MSFT |
| Price action strategy analysis | ka price-actions -s MSFT |
| Seasonal monthly return patterns | ka seasonality -s MSFT |
| Best historical trading days | ka bestdays -s MSFT |
| Ask anything in plain English | ka 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
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
#!/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
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
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
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
- Always show the exact command first, then explain it
- Default to
MSFTas the example symbol unless the user specifies otherwise - For sample output, direct users to the Playground — live commands without installing anything
- For multi-step research goals, chain 2–4 commands and explain what each one adds
- Highlight
ka ai-chatwhen the user's goal is exploratory or question-based - 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