Kraken CLI
The first AI-native CLI for trading crypto, stocks, forex, and derivatives.
Full Kraken API access. Built-in MCP server. Live and paper trading. Single binary.
Works with Cursor, Claude, Codex, Copilot, Gemini, Goose, and OpenClaw.
Try these with your AI agent:
"Install kraken-cli (https://github.com/krakenfx/kraken-cli) and build me a morning market brief."
"Watch ETH, SOL, and BTC for 30 seconds. What are the pros and cons of buying each right now?"
"Look up AAPLx, TSLAx, and SPYx on xStocks. Summarize how each is performing today."
"You are a Wall Street veteran with 20 years of experience. You have 1 minute. Paper trade BTC and show me your P&L."
"Open a 10x leveraged long on BTC futures paper with $5,000 collateral. Set a trailing stop at 3%."
[!CAUTION]
Experimental software. Interacts with the live Kraken exchange and can execute real financial transactions. Read DISCLAIMER.md before using with real funds or AI agents.
Contents
Installation
Single binary, no runtime dependencies.
One-liner
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/krakenfx/kraken-cli/releases/latest/download/kraken-cli-installer.sh | sh
Detects your OS and architecture, downloads the right binary, and installs it. macOS (Apple Silicon and Intel) and Linux (x86_64 and ARM64) are supported. Windows: use WSL.
Verify it works:
kraken status && kraken ticker BTCUSD
Pre-built binaries are also available on the GitHub Releases page.
Build from source
Requires Rust.
cargo install --git https://github.com/krakenfx/kraken-cli
Or clone and build:
git clone https://github.com/krakenfx/kraken-cli.git
cd kraken-cli
cargo install --path .
What You Can Trade
One binary covers six asset classes. All trading commands work across asset classes using the same interface; pass --asset-class where needed.
| Asset class | Instruments | Margin | Flag | Example |
|---|
| Crypto spot | 1,400+ pairs (BTC, ETH, SOL, and hundreds more) | Up to 10x on major pairs | (default) | kraken order buy BTCUSD 0.001 --type limit --price 50000 |
| Tokenized U.S. stocks & ETFs (xStocks) | 79 assets: AAPL, NVDA, TSLA, GOOGL, AMZN, MSFT, SPY, QQQ, and more | Up to 3x on top 10 | --asset-class tokenized_asset | kraken order buy AAPLx/USD 0.1 --type limit --price 200 --asset-class tokenized_asset |
| Forex | 11 fiat pairs: EUR/USD, GBP/USD, USD/JPY, AUD/USD, and more | — | --asset-class forex | kraken ticker EURUSD --asset-class forex |
| Perpetual futures | 317 contracts: crypto, 5 forex perps, 11 equity/index perps (AAPL, NVDA, TSLA, SPY, QQQ, S&P 500) | Up to 50x | (futures engine) | kraken futures order buy PF_XBTUSD 1 --type limit --price 50000 |
| Inverse & fixed-date futures | 20 contracts: BTC, ETH, SOL, LTC, XRP, ADA, DOGE, LINK | Varies | (futures engine) | kraken futures order buy FI_XBTUSD_260327 1 --type limit --price 50000 |
| Earn / staking | Flexible and bonded strategies across multiple assets | — | — | kraken earn strategies --asset ETH |
xStocks are not available in the USA. Availability for all products varies by jurisdiction.
For AI Agents
If you're an AI agent or building one, start here:
Core invocation pattern:
kraken <command> [args...] -o json 2>/dev/null
- stdout is always valid JSON on success, or a JSON error envelope on failure.
- Exit code 0 means success. Non-zero means failure.
- stderr carries diagnostics only (enabled with
-v). Never parse stderr for data.
Why Agent-First?
