kraken-cli

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
• What You Can Trade
• Quick Start
• MCP Server
• Paper Trading
• Commands
• API Keys & Configuration
• Verifying Binaries
• Contributing
• License & Disclaimer

Installation

Must build from source in termux

Requirements

Requires Rust and openssl.

pkg install git rust openssl openssl-tool pkg-config

Install

cargo install --git https://github.com/AdairLi2504/kraken-cli-termux

Or clone and build:

git clone https://github.com/AdairLi2504/kraken-cli-termux
cd kraken-cli-termux
cargo install --path .

After that, you may see a warning like this:

warning: be sure to add `/data/data/com.termux/files/home/.cargo/bin` to your PATH to be able to run the installed binaries

Remember to add the Cargo bin folder to the PATH env.

# Replace '/data/data/com.termux/files/home/.cargo/bin' with the path shown in the warning.
echo 'export PATH="$PATH:/data/data/com.termux/files/home/.cargo/bin"' >> ~/.bashrc
source ~/.bashrc

Verify

Verify it works:

kraken status && kraken ticker BTCUSD

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:

Resource	Description
CONTEXT.md	Runtime context for tool-using agents
AGENTS.md	Full integration guide: auth, invocation, errors, rate limits
agents/tool-catalog.json	151 commands with parameter schemas, types, and safety flags
agents/error-catalog.json	9 error categories with retry guidance
skills/	50 goal-oriented SKILL.md workflow packages
CLAUDE.md	Claude-specific integration guidance

Core invocation pattern:

kraken <command> [args...] -o json 2>/dev/null