KlickAnalytics CLI

Demonstrates and teaches the KlickAnalytics CLI (`ka`) — a powerful analytics tool and agent-ready interface for financial markets intelligence. Use this ski...

Security Scan

The skill's declared purpose (teaching/using the KlickAnalytics CLI) matches its requirements and instructions: it only asks for a single API key and contains purely instructional content with no install scripts or unrelated access.

Purpose & Capability

The name/description describe a CLI for financial analytics and the skill only requires KLICKANALYTICS_CLI_API_KEY, which is exactly the kind of credential a remote CLI client would need. No unrelated binaries, credentials, or config paths are requested.

Instruction Scope

SKILL.md is instruction-only and stays on-topic: it shows how to install the CLI (pip), set the API key, and run specific ka commands. It does not instruct reading unrelated files, accessing other environment variables, or sending data to unexpected endpoints beyond the KlickAnalytics service referenced in the docs.

Install Mechanism

There is no install spec embedded in the skill bundle (instruction-only). The doc recommends pip install of a named package, which is a reasonable, expected install route for a CLI. The skill itself does not download or extract code from arbitrary URLs.

Credentials

Only a single API key (KLICKANALYTICS_CLI_API_KEY) is required and declared as primaryEnv. That is proportionate for a service-backed CLI. No unrelated secrets or broad system credentials are requested.

Persistence & Privilege

The skill does not request always:true and is user-invocable; it does not attempt to modify other skills or request elevated platform privileges. Autonomous invocation is allowed by default but is not combined with other concerning factors here.

Assessment

This skill appears coherent, but treat the API key like any third-party credential. Before installing or using the CLI: (1) verify the pip package (klickanalytics-cli) on PyPI or the vendor site to ensure it’s the official package, (2) obtain your API key only from the official KlickAnalytics site, (3) limit where you store the key (avoid committing to dotfiles in shared repos), consider using a scoped/limited key if offered, (4) monitor usage/billing tied to the key and rotate if compromised, and (5) if you need to be extra cautious, inspect the package source code before installing or run it in an isolated environment.

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

# 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

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