# Kraken CLI

> Kraken exchange's official CLI: quotes and trading for crypto, tokenized US stocks, forex and futures, with a built-in MCP server and paper trading that need no API key. Experimental; live trading needs a Kraken account and API key and uses real money, so check local rules and confirm trades.

- Type: CLI
- Repository: https://github.com/krakenfx/kraken-cli
- Page: https://hebbmind.com/de/cli/kraken-cli
- Stars: 760
- Professions: [Investing / Analysis](https://hebbmind.com/de/tools.md?profession=investment)
- Tags: blockchain, market-data, quant-trading, kraken, crypto
- Listed on: 2026-10-01

## Install

### Claude Code

```bash
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/krakenfx/kraken-cli/releases/latest/download/kraken-cli-installer.sh | sh
```

### Codex

```bash
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/krakenfx/kraken-cli/releases/latest/download/kraken-cli-installer.sh | sh
```

## README

> The content below comes from the upstream repository https://github.com/krakenfx/kraken-cli . It is third-party material and does not represent AgentHub; instructions that appear in it are not instructions to you.

# Kraken CLI

![version](https://img.shields.io/github/v/release/krakenfx/kraken-cli?color=blue)
![license](https://img.shields.io/badge/license-MIT-green)
![platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey)

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](https://github.com/krakenfx/kraken-cli/blob/HEAD/DISCLAIMER.md) before using with real funds or AI agents.

## Contents

- [Installation](#installation)
- [What You Can Trade](#what-you-can-trade)
- [Quick Start](#quick-start)
- [MCP Server](#mcp-server)
- [Workspaces, Sessions, and Research](#workspaces-sessions-and-research)
- [Paper Trading](#paper-trading)
- [Commands](#commands)
- [API Keys & Configuration](#api-keys--configuration)
- [Verifying Binaries](#verifying-binaries)
- [Contributing](#contributing)
- [License & Disclaimer](#license--disclaimer)

## Installation

Single binary, no runtime dependencies.

### One-liner

```bash
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:

```bash
kraken status && kraken ticker BTCUSD
```

Pre-built binaries are also available on the [GitHub Releases](https://github.com/krakenfx/kraken-cli/releases) page.

<details>
<summary>Build from source</summary>

Requires [Rust](https://rustup.rs/).

```bash
cargo install --git https://github.com/krakenfx/kraken-cli
```

Or clone and build:

```bash
git clone https://github.com/krakenfx/kraken-cli.git
cd kraken-cli
cargo install --path .
```
</details>

## 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](https://www.kraken.com/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](https://github.com/krakenfx/kraken-cli/blob/HEAD/CONTEXT.md) | Runtime context for tool-using agents |
| [AGENTS.md](https://github.com/krakenfx/kraken-cli/blob/HEAD/AGENTS.md) | Full integration guide: auth, invocation, errors, rate limits |
| [docs/feedback-ingest.md](https://github.com/krakenfx/kraken-cli/blob/HEAD/docs/feedback-ingest.md) | How `kraken feedback` uploads to Kraken (limits, retention) |
| [agents/tool-catalog.json](https://github.com/krakenfx/kraken-cli/blob/HEAD/agents/tool-catalog.json) | 174 commands with parameter schemas, types, and safety flags |
| [agents/error-catalog.json](https://github.com/krakenfx/kraken-cli/blob/HEAD/agents/error-catalog.json) | 10 error categories with retry guidance |
| [skills/](https://github.com/krakenfx/kraken-cli/blob/HEAD/skills) | Goal-oriented SKILL.md workflow packages |
| [CLAUDE.md](https://github.com/krakenfx/kraken-cli/blob/HEAD/CLAUDE.md) | Claude-specific integration guidance |

Core invocation pattern:

```bash
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 — structured JSON logs (warnings/errors by default, more with `-v` or `RUST_LOG`). Never parse stderr for data.

<details>
<summary>Why Agent-First?</summary>

Most CLIs are built for humans at a terminal. This one is built for LLM-based agents, MCP tool servers, and automated pipelines that need to call Kraken reliably without custom API clients.

- **Structured output by default.** Every command supports `-o json`. No screen-scraping, no regex on table borders.
- **Consistent error envelopes.** Errors are JSON objects with a stable `error` field (`auth`, `rate_limit`, `validation`, `api`, `network`). Agents route on `error` without parsing human sentences.
- **Predictable exit codes.** Success is 0, failure is non-zero. Combined with JSON errors on stdout, agents detect and classify failures programmatically.
- **Paper trading for safe iteration.** Test strategies against live prices with `kraken paper` (spot) and `kraken futures paper` (perpetual futures) commands. No API keys, no real money, same interface as live trading.
- **Market memory.** `kraken record` captures live streams into a local DuckDB/JSONL tape library with integrity counters; finalized tapes replay into paper sessions and feed the autoresearch lab.
- **Full API surface.** The catalog describes 174 request/response commands covering Spot, Futures, xStocks, Forex, Funding, Earn, Subaccounts, and paper trading. Long-running WebSocket, recording, replay, session-start, and stream-daemon surfaces remain CLI-only.
- **Built-in MCP server.** Native Model Context Protocol support over stdio. No subprocess wrappers needed.
- **Rate-limit aware.** No client-side throttling. When the Kraken API rejects a request due to rate limits, the CLI returns an enriched error with `suggestion`, `retryable`, and `docs_url` fields so agents can read the documentation and adapt their strategy.

Humans benefit from the same design: `--output table` renders clean tables, `kraken shell` provides a REPL, and `kraken setup` walks through configuration.

</details>

## Verifying Binaries

Release binaries are signed with [minisign](https://jedisct1.github.io/minisign/). Every artifact on the [Releases](https://github.com/krakenfx/kraken-cli/releases) page has a corresponding `.minisig` signature file.

**Public key:**

```
RWQJue8SwPzZBZO8Up5ppAUqm0wM/gK5yjnam+Dbf7KbY0utkiO+7XCd
```

**Verify a downloaded binary:**

```bash
minisign -Vm kraken-cli-aarch64-apple-darwin.tar.gz -P RWQJue8SwPzZBZO8Up5ppAUqm0wM/gK5yjnam+Dbf7KbY0utkiO+7XCd
```

Install minisign: `brew install minisign` (macOS) or `apt install minisign` (Linux).

## Quick Start

Public market data requires no credentials:

```bash
kraken ticker BTCUSD -o json
kraken orderbook BTCUSD --count 10 -o json
kraken trades BTCUSD --count 20 -o json
kraken ohlc BTCUSD --interval 60 -o json
```

With authentication:

```bash
export KRAKEN_API_KEY="your-key"
export KRAKEN_API_SECRET="your-secret"

kraken balance -o json
kraken open-orders -o json
kraken order buy BTCUSD 0.001 --type limit --price 50000 -o json
```

For humans (table output, interactive setup):

```bash
kraken setup
kraken ticker BTCUSD
kraken balance
kraken shell
```

## API Keys & Configuration

Authenticated commands (trading, balances, order management) require a Kraken API key pair. Public market data and paper trading work without credentials.

### Getting API keys

**Spot** (covers trading, balances, funding, earn, subaccounts): [Settings > API](https://www.kraken.com) on kraken.com. Full guide: [How to create a spot API key](https://support.kraken.com/articles/360000919966-how-to-create-an-api-key).

**Futures** (only for `kraken futures` commands): [Settings > Create Key](https://www.kraken.com/login-futures) on the Futures interface. Full guide: [How to create a Futures API key](https://support.kraken.com/hc/en-us/articles/360022839451-How-to-create-an-API-key-for-Kraken-Futures).

Grant the minimum permissions your workflow needs. For read-only monitoring, "Query Funds" and "Query Open Orders & Trades" are sufficient.

### Environment variables (recommended for agents)

```bash
export KRAKEN_API_KEY="your-key"
export KRAKEN_API_SECRET="your-secret"
export KRAKEN_FUTURES_API_KEY="your-futures-key"       # optional
export KRAKEN_FUTURES_API_SECRET="your-futures-secret"  # optional
```

### Config file (for humans)

Store credentials in `~/.config/kraken/config.toml`:

```toml
[auth]
api_key = "your-api-key"
api_secret = "your-api-secret"

[settings]
default_pair = "BTCUSD"
output = "table"
```

Or use the interactive wizard: `kraken setup`.

### Credential resolution

Highest precedence first:

1. Command-line flags (`--api-key`, `--api-secret`)
2. Environment variables (`KRAKEN_API_KEY`, `KRAKEN_API_SECRET`)
3. Config file (`~/.config/kraken/config.toml`)

### Security

- Config file is created with `0600` permissions (owner read/write only)
- Secrets are never logged, printed, or included in error messages
- Use `--api-secret-stdin` or `--api-secret-file` instead of `--api-secret` to avoid secrets in process listings
- For automation, prefer environment variables over command-line flags

<details>
<summary>Advanced: API endpoint overrides</summary>

| Variable | Default | Description |
|----------|---------|-------------|
| `KRAKEN_SPOT_URL` | `https://api.kraken.com` | Spot REST API base URL |
| `KRAKEN_FUTURES_URL` | `https://futures.kraken.com/derivatives/api/v3` | Futures REST API base URL |
| `KRAKEN_WS_PUBLIC_URL` | `wss://ws.kraken.com/v2` | Public WebSocket endpoint |
| `KRAKEN_WS_AUTH_URL` | `wss://ws-auth.kraken.com/v2` | Authenticated Spot WebSocket endpoint |
| `KRAKEN_WS_L3_URL` | `wss://ws-l3.kraken.com/v2` | Level 3 order book WebSocket endpoint |
| `KRAKEN_FUTURES_WS_URL` | `wss://futures.kraken.com/ws/v1` | Futures WebSocket endpoint |
| `KRAKEN_FEEDBACK_ENDPOINT` | `https://cli-feedback.kraken.com/v1/feedback` | Product feedback ingest URL (trusted hosts only; see [docs/feedback-ingest.md](https://github.com/krakenfx/kraken-cli/blob/HEAD/docs/feedback-ingest.md)) |

Resolution: CLI flag > environment variable > default. Only `https://` and `wss://` schemes are accepted.

</details>

## MCP Server

`kraken-cli` includes a built-in [Model Context Protocol](https://modelcontextprotocol.io/) server over stdio. No subprocess wrappers needed.

MCP tool calls run through the same command path as CLI commands and inherit the same error handling and rate-limit behavior.

> [!WARNING]
> MCP is local-first and designed for your own machine. Any agent connected to this MCP server uses the same configured Kraken account and API key permissions. Do not expose, tunnel, or share this server outside systems you control. Always use `https://` and `wss://` endpoints. Treat this integration as alpha and use least-privilege API keys.

```bash
kraken mcp                           # default: market, account, paper, workspace, feedback
kraken mcp -s all                    # all services, dangerous calls require acknowledged=true
kraken mcp -s all --allow-dangerous  # all services, no per-call confirmation
kraken mcp -s market,trade,paper     # specific services
```

Configure your MCP client (Claude Desktop, ChatGPT, Codex, Gemini CLI, Cursor, VS Code, Windsurf, etc.):

```json
{
  "mcpServers": {
    "kraken": {
      "command": "kraken",
      "args": ["mcp", "-s", "all"]
    }
  }
}
```

Gemini CLI users can install directly: `gemini extensions install https://github.com/krakenfx/kraken-cli`

### Service groups

| Service | Auth | Risk |
|---------|------|------|
| market | No | None |
| account | Yes | Read-only |
| trade | Yes | Orders (dangerous) |
| funding | Yes | Withdrawals (dangerous) |
| earn | Yes | Staking (dangerous) |
| subaccount | Yes | Transfers (dangerous) |
| futures | Mixed | Orders (dangerous) |
| futures-paper | No | None (simulation) |
| paper | No | None (simulation) |
| workspace | No | None (paper workspaces); live workspaces gate like the real account |
| feedback | No | Uploads text to Kraken (see [docs/feedback-ingest.md](https://github.com/krakenfx/kraken-cli/blob/HEAD/docs/feedback-ingest.md)) |
| auth | No | Read-only |

Default: `market,account,paper,workspace,feedback`. The `feedback` MCP tools call the same upload path as `kraken feedback`. Streaming groups (`websocket`, `futures-ws`) are excluded in MCP v1.

Dangerous tools carry the `destructive_hint` annotation and include `[DANGEROUS: requires human confirmation]` in the description. In guarded mode (default), dangerous calls must include `acknowledged=true`. In autonomous mode (`--allow-dangerous`), this requirement is disabled.

<details>
<summary>Output & Errors</summary>

### JSON (`-o json`)

The primary output format. Every command returns valid JSON on stdout.

```bash
kraken ticker BTCUSD -o json
# {"BTCUSD":{"a":["67234.10","1","1.000"],"b":["67234.00","1","1.000"],...}}
```

WebSocket commands emit JSONL (one JSON object per line) for streaming.

### Table (`-o table`)

Human-readable tables. Default when `-o` is not specified.

```
┌──────────┬──────────┬──────────┬──────────┬────────────┐
│ Pair     │ Ask      │ Bid      │ Last     │ Volume ... │
├──────────┼──────────┼──────────┼──────────┼────────────┤
│ BTCUSD   │ 67234.10 │ 67234.00 │ 67234.10 │ 1234.56    │
└──────────┴──────────┴──────────┴──────────┴────────────┘
```

### Error envelopes

On failure, stdout contains a JSON envelope with a stable `error` category:

```json
{"error": "auth", "message": "Authentication failed: EAPI:Invalid key"}
```

Route on `error`, not on `message`. The `message` field is human-readable and not stable.

| Category | Retryable | Action |
|----------|-----------|--------|
| `auth` | No | Check API key and secret |
| `rate_limit` | Yes | Error includes `suggestion` with tier-specific limits, `docs_url` pointing to Kraken documentation, and `retryable` flag. Read `suggestion` and adapt strategy. |
| `network` | Yes | Exponential backoff, max 5 retries |
| `validation` | No | Fix input parameters |
| `api` | No | Inspect request and parameters |
| `config` | No | Check config file or env vars |
| `websocket` | Yes | Reconnect with paced backoff and safety budget (up to 12 reconnect attempts per stream lifecycle) |
| `io` | No | Check file paths and permissions |
| `parse` | No | Log raw response, possible API maintenance |

Full error catalog with envelopes and backoff strategies: [agents/error-catalog.json](https://github.com/krakenfx/kraken-cli/blob/HEAD/agents/error-catalog.json).

### Logging (`-v`, `--log-format`, `RUST_LOG`)

Diagnostics are emitted via `tracing` to **stderr only** — stdout stays the pure result/JSON channel. Logging is **off by default** except warnings and errors, so the `2>/dev/null` pattern is unaffected. Secrets, credentials, and financial data are never logged.

**Format** — structured JSON (JSONL, one object per line) by default, so logs are machine-parseable out of the box. A human-readable format is opt-in:

```bash
kraken balance -o json -v 2>/dev/null | jq .   # result on stdout; logs (JSON) on stderr
kraken balance -v --log-format pretty           # human-readable logs instead
export KRAKEN_LOG_FORMAT=pretty                 # ...or via env (e.g. a dev shell profile)
```

`--log-format` accepts `json` (default), `pretty`, or `compact`, and is independent of `-o`/`--output` (which formats the command result on stdout).

**Level** — controlled by `RUST_LOG` (the standard `tracing` filter); `-v`/`--verbose` is a shortcut for debug-level kraken-cli logs:

```bash
kraken balance -v                                  # kraken-cli at debug (dependencies stay quiet)
RUST_LOG=kraken_cli=debug kraken balance           # same, explicit
RUST_LOG=kraken_cli::client=trace kraken ticker BTCUSD   # HTTP request/response detail
```

Note: a bare `RUST_LOG=debug` enables debug for *every* crate (including dependencies like `tungstenite`); scope it to `kraken_cli` — or just use `-v` — for our diagnostics alone.

</details>

## Workspaces, Sessions, and Research

Version 0.4.0 adds a durable paper-research loop:

1. A **workspace** isolates the account.
2. A **session** records an evaluation window.
3. A **tape** preserves replayable market data.
4. A **lab experiment** seals the hypothesis and pass criteria.

```bash
# Create an isolated account.
kraken workspace create momentum --capital 10000 --mode paper -o json
export KRAKEN_WORKSPACE=momentum

# Record in one terminal.
kraken session start --symbols BTC/USD --channels ticker,trade \
  --label baseline --to jsonl -o json

# Trade in another terminal and preserve the rationale.
kraken paper buy BTC/USD 0.01 -o json
kraken session note --kind buy --symbol BTC/USD \
  --reason "breakout held above the prior high" -o json
kraken session stop -o json

# Review the closed window.
kraken session show --session baseline -o json
kraken explain pnl --session baseline -o json
kraken workspace report momentum -o json
```

For repeatable experiments, freeze the plan before the first session:

```bash
kraken lab new breakout-v1 \
  --hypothesis "a confirmed breakout produces positive net return" \
  --min-return-pct 0 --max-drawdown-pct 2 --min-fills 1 \
  --session live:5m --session replay:tape:baseline -o json

kraken lab next breakout-v1 -o json
kraken lab compare breakout-v1 -o json
```

The command tables below cover each surface. Machine-readable contracts live in
[agents/tool-catalog.json](https://github.com/krakenfx/kraken-cli/blob/HEAD/agents/tool-catalog.json).

## Commands

The public request/response catalog contains 174 commands across 15 groups.
Parameter schemas live in
[agents/tool-catalog.json](https://github.com/krakenfx/kraken-cli/blob/HEAD/agents/tool-catalog.json). Long-running streams are
documented below but excluded from the catalog.

| Group | Commands | Auth | Description |
|-------|----------|------|-------------|
| market | 11 | No | Ticker, orderbook, OHLC, trades, spreads, asset info, tape library |
| account | 18 | Yes | Balances, orders, trades, ledgers, positions, exports |
| trade | 9 | Yes | Order placement, amendment, cancellation (spot, xStocks, forex) |
| funding | 10 | Yes | Deposits, withdrawals, wallet transfers |
| earn | 6 | Yes | Staking strategies and allocations |
| subaccount | 2 | Yes | Create subaccounts, transfer between accounts |
| futures | 39 | Mixed | Futures market data and trading |
| futures-paper | 17 | No | Futures paper trading simulation with live prices |
| futures-ws | 9 | Mixed | Futures WebSocket streaming |
| websocket | 15 | Mixed | Spot WebSocket v2 streaming and request/response |
| paper | 16 | No | Spot paper trading simulation with live prices, P&L explanation, and the Autoresearch Lab |
| workspace | 15 | No | Strategy workspaces and recorded sessions: isolated accounts, session windows, decision logs, reports, promotion |
| feedback | 1 | No | Product feedback upload to Kraken (local DuckDB mirror on success) |
| auth | 4 | No | Credential management |
| utility | 2 | No | Interactive setup and REPL shell |

41 commands are marked `dangerous` (orders, withdrawals, transfers, cancel-all, staking, account and margin settings). The authoritative list is the `dangerous` field in [agents/tool-catalog.json](https://github.com/krakenfx/kraken-cli/blob/HEAD/agents/tool-catalog.json).

<details>
<summary>Full command reference</summary>

### Market Data (Public)

| Command | Description |
|---------|-------------|
| `kraken status` | System status |
| `kraken server-time` | Server time |
| `kraken assets [--asset BTC,ETH] [--asset-class CLASS]` | Asset info |
| `kraken pairs [--pair BTCUSD] [--asset-class CLASS]` | Tradable pairs |
| `kraken ticker <PAIR...> [--asset-class tokenized_asset\|forex]` | Ticker data |
| `kraken ohlc <PAIR> [--interval 60] [--asset-class tokenized_asset\|forex]` | OHLC candles |
| `kraken orderbook <PAIR> [--count 25] [--asset-class tokenized_asset]` | L2 order book |
| `kraken orderbook-grouped <PAIR> [--depth 10] [--grouping 1]` | Grouped order book |
| `kraken trades <PAIR> [--count 1000] [--asset-class tokenized_asset]` | Recent trades |
| `kraken spreads <PAIR> [--since TS] [--asset-class tokenized_asset]` | Recent spreads |
| `kraken tape list` | Every recorded tape in the library: ref, backend, state, in use |

### Account Data (Private)

| Command | Description |
|---------|-------------|
| `kraken orderbook-l3 <PAIR> [--depth 100]` | L3 order book |
| `kraken balance [--rebase-multiplier rebased\|base]` | All balances |
| `kraken extended-balance` | Extended balances (balance, credit, held) |
| `kraken credit-lines [--rebase-multiplier rebased\|base]` | Credit line details (VIP) |
| `kraken trade-balance [--asset USD] [--rebase-multiplier rebased\|base]` | Margin/equity summary |
| `kraken open-orders [--trades] [--cl-ord-id ID] [--rebase-multiplier rebased\|base]` | Open orders |
| `kraken closed-orders [--start TS] [--end TS] [--offset N] [--userref REF] [--cl-ord-id ID] [--closetime open\|close\|both] [--consolidate-taker] [--without-count] [--rebase-multiplier rebased\|base]` | Closed orders |
| `kraken query-orders <TXID...> [--trades] [--userref REF] [--consolidate-taker] [--rebase-multiplier rebased\|base]` | Query specific orders |
| `kraken trades-history [--type TYPE] [--trades] [--offset N] [--consolidate-taker] [--without-count] [--ledgers] [--rebase-multiplier rebased\|base]` | Trade history |
| `kraken query-trades <TXID...> [--trades] [--rebase-multiplier rebased\|base]` | Query specific trades |
| `kraken positions [--txid ID] [--show-pnl] [--consolidation market] [--rebase-multiplier rebased\|base]` | Open positions |
| `kraken ledgers [--asset BTC --type trade] [--asset-class CLASS] [--start TS] [--end TS] [--offset N] [--without-count] [--rebase-multiplier rebased\|base]` | Ledger entries |
| `kraken query-ledgers <ID...> [--trades] [--rebase-multiplier rebased\|base]` | Query specific ledger entries |
| `kraken volume [--pair BTCUSD] [--rebase-multiplier rebased\|base]` | Trade volume & fees |
| `kraken export-report --report trades --description "desc" [--format CSV\|TSV] [--fields F] [--starttm TS] [--endtm TS]` | Request export |
| `kraken export-status --report trades` | Export status |
| `kraken export-retrieve <ID>` | Download export |
| `kraken export-delete <ID>` | Delete export |

### Trading

| Command | Description |
|---------|-------------|
| `kraken order buy <PAIR> <VOL> [--type limit --price P] [--asset-class tokenized_asset] [--validate] ...` | Buy order |
| `kraken order sell <PAIR> <VOL> [--type limit --price P] [--asset-class tokenized_asset] [--validate] ...` | Sell order |
| `kraken order batch <JSON_FILE> [--pair P] [--asset-class tokenized_asset] [--deadline DL] [--validate]` | Batch orders (2-15) |
| `kraken order amend --txid <TXID> [--order-qty Q --limit-price P ...]` | Amend order in-place |
| `kraken order amend --cl-ord-id <ID> [--limit-price P ...]` | Amend by client order ID |
| `kraken order edit <TXID> [--price P]` | Edit order (cancel+replace) |
| `kraken order cancel <TXID...>` | Cancel by txid(s) |
| `kraken order cancel --cl-ord-id <ID>` | Cancel by client order ID |
| `kraken order cancel-batch <TXID...> [--cl-ord-ids ID...]` | Cancel batch (max 50 total) |
| `kraken order cancel-all [--yes]` | Cancel all |
| `kraken order cancel-after <SECS>` | Dead man's switch |

### Funding

| Command | Description |
|---------|-------------|
| `kraken deposit methods <ASSET> [--asset-class currency\|tokenized_asset] [--rebase-multiplier rebased\|base]` | Deposit methods |
| `kraken deposit addresses <ASSET> <METHOD> [--new] [--asset-class CLASS] [--amount AMT]` | Deposit addresses |
| `kraken deposit status [--asset A] [--asset-class CLASS] [--method M] [--start TS] [--end TS] [--cursor C] [--limit N] [--rebase-multiplier rebased\|base]` | Deposit status |
| `kraken withdraw <ASSET> <KEY> <AMOUNT> [--asset-class CLASS] [--address ADDR] [--max-fee F] [--rebase-multiplier rebased\|base]` | Withdraw funds |
| `kraken withdrawal methods [--asset A] [--asset-class CLASS] [--network N] [--rebase-multiplier rebased\|base]` | Withdrawal methods |
| `kraken withdrawal addresses [--asset A] [--asset-class CLASS] [--method M] [--key K] [--verified true\|false]` | Withdrawal addresses |
| `kraken withdrawal info <ASSET> <KEY> <AMOUNT>` | Withdrawal fee info |
| `kraken withdrawal status [--asset A] [--asset-class CLASS] [--method M] [--start TS] [--end TS] [--cursor C] [--limit N] [--rebase-multiplier rebased\|base]` | Withdrawal status |
| `kraken withdrawal cancel <ASSET> <REFID>` | Cancel pending withdrawal |
| `kraken wallet-transfer <ASSET> <AMT> --from IIBAN --to IIBAN` | Wallet transfer |

### Earn

| Command | Description |
|---------|-------------|
| `kraken earn strategies [--asset ETH] [--lock-type flex bonded...] [--ascending] [--cursor C] [--limit N]` | List strategies |
| `kraken earn allocate <ID> <AMT>` | Allocate funds |
| `kraken earn deallocate <ID> <AMT>` | Deallocate funds |
| `kraken earn allocate-status <ID>` | Allocation status |
| `kraken earn deallocate-status <ID>` | Deallocation status |
| `kraken earn allocations [--ascending] [--converted-asset USD] [--hide-zero-allocations]` | Current allocations |

### Subaccounts

| Command | Description |
|---------|-------------|
| `kraken subaccount create <USERNAME> <EMAIL>` | Create sub account |
| `kraken subaccount transfer <ASSET> <AMOUNT> --from IIBAN --to IIBAN [--asset-class CLASS]` | Transfer between accounts |

### Futures: Public Market Data

| Command | Description |
|---------|-------------|
| `kraken futures instruments` | All contracts |
| `kraken futures tickers` | All tickers |
| `kraken futures ticker <SYMBOL>` | Single ticker |
| `kraken futures orderbook <SYMBOL>` | Order book |
| `kraken futures history <SYMBOL> [--since TS] [--before TS]` | Trade history |
| `kraken futures feeschedules` | Fee schedules |
| `kraken futures instrument-status [--symbol SYM]` | Instrument status |

### Futures: Trading (Private)

| Command | Description |
|---------|-------------|
| `kraken futures order buy <SYM> <SIZE> [--type limit] [--price P] [--stop-price SP] [--trigger-signal mark\|index\|last] [--client-order-id ID] [--reduce-only] [--trailing-stop-max-deviation V] [--trailing-stop-deviation-unit percent\|quote_currency]` | Buy futures |
| `kraken futures order sell <SYM> <SIZE> [--type limit] [--price P] [--stop-price SP] ...` | Sell futures |
| `kraken futures edit-order --order-id ID [--size S] [--price P] [--stop-price SP]` | Edit existing order |
| `kraken futures cancel --order-id ID` | Cancel by order ID |
| `kraken futures cancel --cli-ord-id ID` | Cancel by client order ID |
| `kraken futures cancel-all [--symbol SYM] [--yes]` | Cancel all orders |
| `kraken futures cancel-after <SECS>` | Dead man's switch |
| `kraken futures batch-order '<JSON>'` or `kraken futures batch-order @file.json` | Batch order placement |

### Futures: Account Data (Private)

| Command | Description |
|---------|-------------|
| `kraken futures accounts` | Wallet/account info |
| `kraken futures open-orders` | Open orders |
| `kraken futures positions` | Open positions |
| `kraken futures fills [--since TS]` | Recent fills |
| `kraken futures leverage [--symbol SYM]` | Leverage preferences |
| `kraken futures set-leverage <SYMBOL> <MAX_LEVERAGE>` | Set leverage |
| `kraken futures notifications` | Account notifications |
| `kraken futures transfers` | Transfer history |
| `kraken futures transfer <AMOUNT> <CURRENCY>` | Transfer between wallets |
| `kraken futures history-executions [--since TS] [--before TS] [--sort asc\|desc]` | Execution history |
| `kraken futures history-orders [--since TS] [--before TS] [--sort asc\|desc]` | Order history |
| `kraken futures history-triggers [--since TS] [--before TS] [--sort asc\|desc]` | Trigger history |
| `kraken futures history-account-log-csv [--since TS] [--before TS]` | Account log (CSV) |
| `kraken futures trading-instruments [--contract-type ...]` | Trading instruments (auth) |
| `kraken futures historical-funding-rates <SYMBOL>` | Historical funding rates |
| `kraken futures order-status <ORDER_ID>...` | Query order status (auth) |
| `kraken futures pnl-preferences` | Get PnL preferences (auth) |
| `kraken futures set-pnl-preference <SYMBOL> <PREFERENCE>` | Set PnL preference (auth) |
| `kraken futures unwind-queue` | Get unwind queue (auth) |
| `kraken futures assignment-programs` | Assignment programs (auth) |
| `kraken futures fee-schedule-volumes` | Fee schedule volumes (auth) |
| `kraken futures subaccounts` | List subaccounts (auth) |
| `kraken futures subaccount-status <UID>` | Subaccount trading status (auth) |
| `kraken futures set-subaccount-status <UID> <ENABLED>` | Set subaccount trading status (auth) |
| `kraken futures wallet-transfer <FROM> <TO> <UNIT> <AMOUNT>` | Transfer between wallets (auth) |

### Futures: Paper Trading (No Auth)

| Command | Description |
|---------|-------------|
| `kraken futures paper init [--balance 10000] [--currency USD] [--fee-rate 0.0005]` | Initialize futures paper account |
| `kraken futures paper reset [--balance B] [--currency C] [--fee-rate R]` | Reset account (clear positions, orders, fills) |
| `kraken futures paper balance` | Collateral, used margin, available margin, unrealized P&L |
| `kraken futures paper status` | Account summary: equity, P&L since start, unrealized P&L, position/order counts |
| `kraken futures paper buy <SYM> <SIZE> [--leverage L] [--type TYPE] [--price P] [--stop-price SP] [--trigger-signal mark\|index\|last] [--client-order-id ID] [--reduce-only] [--trailing-stop-max-deviation V] [--trailing-stop-deviation-unit percent\|quote_currency]` | Paper long (all 8 order types) |
| `kraken futures paper sell <SYM> <SIZE> [--leverage L] [--type TYPE] [--price P] ...` | Paper short (all 8 order types) |
| `kraken futures paper orders` | Open resting orders |
| `kraken futures paper order-status <ID>` | Query specific order |
| `kraken futures paper edit-order --order-id <ID> [--size S] [--price P] [--stop-price SP]` | Edit resting order |
| `kraken futures paper cancel --order-id <ID>` | Cancel by order ID or `--cli-ord-id` |
| `kraken futures paper cancel-all [--symbol SYM]` | Cancel all (optional symbol filter) |
| `kraken futures paper batch-order '<JSON>'` | Batch order placement |
| `kraken futures paper positions` | Open positions with mark price, liquidation price, unrealized P&L |
| `kraken futures paper fills [--since TS]` | Fill history |
| `kraken futures paper history` | Closed positions and cancelled orders with realized P&L |
| `kraken futures paper leverage [--symbol SYM]` | Current leverage preferences |
| `kraken futures paper set-leverage <SYM> <LEV>` | Set default leverage for a symbol |

### Futures WebSocket Streaming

| Command | Description |
|---------|-------------|
| `kraken futures ws ticker <MARKET...>` | Stream futures tickers (public) |
| `kraken futures ws trades <MARKET...>` | Stream futures trades (public) |
| `kraken futures ws book <MARKET...>` | Stream futures order book (public) |
| `kraken futures ws fills` | Stream fills (private, challenge auth) |
| `kraken futures ws open-orders` | Stream open orders (private) |
| `kraken futures ws open-positions` | Stream open positions (private) |
| `kraken futures ws balances` | Stream balances and margins (private) |
| `kraken futures ws notifications` | Stream notifications (private) |
| `kraken futures ws account-log` | Stream account log (private) |

### WebSocket (Streaming and Request/Response)

| Command | Description |
|---------|-------------|
| `kraken ws ticker <PAIR...> [--event-trigger bbo]` | Stream tickers |
| `kraken ws trades <PAIR...>` | Stream trades |
| `kraken ws book <PAIR...> [--depth 10]` | Stream L2 order book |
| `kraken ws ohlc <PAIR...> [--interval 1]` | Stream OHLC candles |
| `kraken ws instrument [PAIR...]` | Stream instrument metadata |
| `kraken ws executions` | Stream trade executions (auth) |
| `kraken ws balances` | Stream balance updates (auth) |
| `kraken ws level3 <PAIR...>` | Stream L3 order book (auth) |
| `kraken ws add-order` | Place order via WebSocket (auth) |
| `kraken ws amend-order` | Amend order via WebSocket (auth) |
| `kraken ws cancel-order` | Cancel order(s) via WebSocket (auth) |
| `kraken ws cancel-all` | Cancel all orders via WebSocket (auth) |
| `kraken ws cancel-after <TIMEOUT>` | Dead man's switch via WebSocket (auth) |
| `kraken ws batch-add` | Batch add orders via WebSocket (auth) |
| `kraken ws batch-cancel` | Batch cancel orders via WebSocket (auth) |

### Market Memory (CLI-only, no auth)

| Command | Description |
|---------|-------------|
| `kraken record --symbols <PAIR...> --channels <CH...> [--tape NAME] [--to duckdb,jsonl]` | Capture live market data into a local tape; Ctrl-C/SIGTERM finalizes |
| `kraken streamd start --symbols <PAIR...> --channels <CH...>` | Multi-symbol, multi-channel JSONL stream to stdout |

Add `--monitor` to `ws`, `streamd`, or `record` for stderr JSONL health lines (latency, trade gaps, staleness, heartbeats). See the [market memory walkthrough](https://github.com/krakenfx/kraken-cli/blob/HEAD/examples/03-market-memory.md).

### Strategy Workspaces

| Command | Description |
|---------|-------------|
| `kraken workspace create <NAME> --capital <AMOUNT> --mode paper [--currency USD] [--fee-rate R] [--slippage-rate R] [--allow-pairs PAIR...]` | Create and fund an isolated paper account |
| `kraken workspace list` | List paper workspaces plus the real-account `default` workspace |
| `kraken workspace show [NAME]` | Show the durable workspace contract |
| `kraken workspace status [NAME]` | Mark account equity and P&L |
| `kraken workspace balance [NAME]` | Fold balances from the local journal; `default` delegates to Kraken |
| `kraken workspace reset [NAME] [--yes]` | Start a new capital epoch while retaining history |
| `kraken workspace report [NAME]` | Report session, manual-trade, reset, drift, and total account results |
| `kraken workspace promote [NAME]` | Evaluate and return the paper-to-live safety checklist |

Select a workspace with `--workspace <NAME>` or
`KRAKEN_WORKSPACE=<NAME>`. Spot order verbs simulate inside a paper workspace;
without one they retain real-account behavior and confirmation gates. Named
live workspaces remain blocked until credentials can be scoped safely.

### Recorded Sessions

| Command | Description |
|---------|-------------|
| `kraken session start --symbols <PAIR...> [--label LABEL] [--experiment NAME]` | Start a live recorded evaluation window |
| `kraken session start --from tape:<NAME> [--speed N] [--label LABEL] [--experiment NAME]` | Start a replay-backed paper session |
| `kraken session stop` | Finalize the active session and its account window |
| `kraken session list` | List sessions and their derived state |
| `kraken session show [--session latest\|s<N>\|LABEL]` | Inspect the window, provenance, and valuation |
| `kraken session note --kind buy\|sell\|skip\|alert --reason <TEXT>` | Append the reasoning behind a decision |
| `kraken session decisions [--session REF]` | Read the stable decision-log contract |
| `kraken session state get [--session REF]` | Read an agent's typed resumption cursor |
| `kraken session state set [FIELDS...]` | Replace the active session's resumption cursor |

`session start`, `record`, `replay`, and `streamd` are CLI-only streams.
Request/response operations around them remain available through MCP.

### Autoresearch Lab and P&L

| Command | Description |
|---------|-------------|
| `kraken explain pnl [--session REF]` | Decompose a stopped session's P&L and attribute decisions |
| `kraken lab new <NAME> [EXPERIMENT OPTIONS...]` | Freeze a hypothesis, criteria, and session plan |
| `kraken lab show <NAME>` | Verify and show a sealed experiment |
| `kraken lab next <NAME>` | Return the next planned session command |
| `kraken lab score [--session REF] [--experiment NAME]` | Score a stopped session mechanically |
| `kraken lab compare <NAME>` | Compare every planned session, including named failures |

`session state` is operational; decisions, fills, marks, and sealed criteria
remain the evidence used for replay and scoring.

### Feedback

| Command | Description |
|---------|-------------|
| `kraken feedback <TYPE> (--input-string STR \| --input-file PATH) [--llm-model MODEL]` | Submit product feedback (`feature-request`, `friction`, or `bug`). Uploads to Kraken over HTTPS; mirrors locally on success. Do not include secrets or PII. See [docs/feedback-ingest.md](https://github.com/krakenfx/kraken-cli/blob/HEAD/docs/feedback-ingest.md). |

### Utility

| Command | Description |
|---------|-------------|
| `kraken setup` | Interactive setup wizard |
| `kraken shell` | Interactive REPL |
| `kraken auth set/show/test/reset` | Credential management |

</details>

## Paper Trading

Paper trading provides a safe sandbox for testing trading logic against live Kraken prices. No API keys, no account, no real money. Two independent paper engines cover spot and futures.

### Spot Paper Trading

The command interface has near-parity with live spot trading. Switch between paper and live by changing the prefix: `kraken paper buy` vs `kraken order buy`. Paper supports `market` and `limit` order types, a configurable flat slippage model, and no partial fills.

**Agent pattern:**

```bash
kraken workspace create sandbox --capital 10000 --mode paper -o json
export KRAKEN_WORKSPACE=sandbox
kraken paper buy BTCUSD 0.01 -o json
kraken paper sell BTCUSD 0.005 --type limit --price 70000 -o json
kraken workspace status -o json
kraken workspace reset --yes -o json
```

**Human pattern:**

```bash
kraken workspace create sandbox --capital 5000 --currency EUR --mode paper
export KRAKEN_WORKSPACE=sandbox
kraken paper buy BTCUSD 0.01
kraken paper balance
kraken paper status
kraken paper orders
kraken paper history
kraken workspace reset
```

| Command | Description |
|---------|-------------|
| `kraken paper init [--balance 10000] [--currency USD] [--fee-rate 0.0026] [--slippage-rate 0.001]` | Compatibility alias that creates the selected paper workspace |
| `kraken paper reset [--balance B] [--currency C] [--fee-rate R] [--slippage-rate S] [--yes]` | Compatibility alias that reconciles pending orders, then resets |
| `kraken paper balance` | All balances (total, reserved, available) |

> The README is long; the above is its first 40000 characters. Full content: https://github.com/krakenfx/kraken-cli