Content
# Kraken CLI × ChainVector
A fork of [krakenfx/kraken-cli](https://github.com/krakenfx/kraken-cli) with [ChainVector](https://chainvector.com) as the built-in signals-intelligence layer. Kraken executes; ChainVector decides.
Full Kraken API access. ChainVector regime detection, momentum, probability engine, whale flow, liquidations, funding, and strategy advisors. 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:
> *"What regime is BTC in? Should I be long, short, or flat for the next 15 minutes?"*
> *"Run `kraken strategy advise` and, if there's no veto, put on the trade in futures paper with the suggested stop and target."*
> *"What is the probability BTC touches 100k in the next hour? Any liquidation clusters between here and there?"*
> *"Scan funding across venues and find me a delta-neutral carry pair."*
> *"You are a Wall Street veteran with 20 years of experience. Use ChainVector signals to paper trade BTC for 15 minutes and show me your P&L."*
---
> [!CAUTION]
> Experimental software. Interacts with the live Kraken exchange and can execute real financial transactions. Read [DISCLAIMER.md](DISCLAIMER.md) before using with real funds or AI agents.
## Contents
- [Installation](#installation)
- [ChainVector Intelligence](#chainvector-intelligence)
- [What You Can Trade](#what-you-can-trade)
- [Quick Start](#quick-start)
- [MCP Server](#mcp-server)
- [Paper Trading](#paper-trading)
- [Commands](#commands)
- [API Keys & Configuration](#api-keys--configuration)
- [Contributing](#contributing)
- [License & Disclaimer](#license--disclaimer)
## Installation
Single binary, no runtime dependencies. Requires [Rust](https://rustup.rs/) to build.
```bash
cargo install --git https://github.com/C0inFlips/kraken-cli-chainvector
```
Or clone and build:
```bash
git clone https://github.com/C0inFlips/kraken-cli-chainvector.git
cd kraken-cli-chainvector
cargo install --path .
```
The binary is still named `kraken`. Verify it works:
```bash
kraken status && kraken ticker BTCUSD
kraken signals status # requires CHAINVECTOR_API_KEY
```
## ChainVector Intelligence
Two command groups turn ChainVector's API into the decision layer for every trade. Both are read-only and need only a ChainVector API key — no Kraken credentials.
```bash
export CHAINVECTOR_API_KEY="cv_live_..." # get one at https://chainvector.com
```
### `kraken signals` — raw intelligence (32 commands)
```bash
kraken signals snapshot --symbol BTC -o json # one-call bot decision snapshot
kraken signals regime --symbol BTC -o json # trending/choppy/quiet/squeeze_setup/cascading
kraken signals momentum --symbol BTC -o json # cross-venue momentum, -100..+100
kraken signals probability --symbol BTC-USDT --target 100000 --horizon 15m -o json
kraken signals whale-pressure --symbol BTC -o json # net whale flow
kraken signals cascade-risk --symbol BTC -o json # liquidation cascade probability
kraken signals heatmap --symbol BTC -o json # liquidation cluster levels
kraken signals funding-squeeze --symbol BTC -o json # crowded-side unwind score
kraken signals risk-index -o json # 0-100 market stress composite
kraken signals screener -o json # rank all tracked assets
```
Also: `lead-lag`, `volatility`, `indicators`, `whale-trades`, `liquidations`, `funding`, `funding-weighted`, `funding-arbitrage`, `basis`, `positioning`, `long-short`, `cvd`, `book-imbalance`, `book-walls`, `open-interest`, `history`, `options-probability`, `prediction-markets`, `prediction-quotes`, `prediction-stability`, `prediction-edge`, `status`.
### `kraken strategy` — composite advisors (6 commands)
Each advisor fuses multiple signals into one structured decision: action (`long`/`short`/`flat`), confidence, veto list, size multiplier, and volatility-scaled stop/target. Advisors never place orders — execution stays with the Kraken command groups.
```bash
kraken strategy advise --symbol BTC --horizon-min 15 -o json # full ensemble: regime gate + EV + vetoes
kraken strategy momentum --symbol BTC -o json # momentum-continuation check
kraken strategy meanrev --symbol BTC -o json # mean-reversion check
kraken strategy squeeze --symbol BTC -o json # funding-squeeze play
kraken strategy cascade-fade --symbol BTC -o json # fade an exhausting cascade
kraken strategy carry -o json # delta-neutral funding carry scan
```
### The loop
```bash
ACTION=$(kraken strategy advise --symbol BTC -o json 2>/dev/null | jq -r '.action')
case "$ACTION" in
long) kraken paper buy BTCUSD 0.01 -o json ;;
short) kraken futures paper sell PF_XBTUSD 1 --leverage 5 --type market -o json ;;
flat) echo "no trade" ;;
esac
```
See [skills/recipe-signal-driven-trade](skills/recipe-signal-driven-trade/SKILL.md) for the full workflow with veto gates and a risk-index circuit breaker.
## 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](CONTEXT.md) | Runtime context for tool-using agents |
| [AGENTS.md](AGENTS.md) | Full integration guide: auth, invocation, errors, rate limits |
| [agents/tool-catalog.json](agents/tool-catalog.json) | 189 commands with parameter schemas, types, and safety flags |
| [agents/error-catalog.json](agents/error-catalog.json) | 9 error categories with retry guidance |
| [skills/](skills/) | 53 goal-oriented SKILL.md workflow packages |
| [CLAUDE.md](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 (enabled with `-v`). 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.
- **Full API surface.** 189 commands covering Spot, Futures, xStocks, Forex, Funding, Earn, Subaccounts, WebSocket streaming, paper trading for both spot and futures, and ChainVector signals intelligence.
- **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>
## 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
```
ChainVector intelligence requires only a ChainVector key:
```bash
export CHAINVECTOR_API_KEY="cv_live_..."
kraken signals snapshot --symbol BTC -o json
kraken strategy advise --symbol BTC -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
export CHAINVECTOR_API_KEY="cv_live_..." # for signals + strategy groups
```
### 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 |
| `CHAINVECTOR_URL` | `https://chainvector.com/api/v1` | ChainVector REST API base URL |
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 # read-only (market, account, paper, signals, strategy)
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,signals,strategy # 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", "market,paper,signals,strategy"],
"env": {
"CHAINVECTOR_API_KEY": "cv_live_YOUR_KEY"
}
}
}
}
```
### Service groups
| Service | Auth | Risk |
|---------|------|------|
| market | No | None |
| account | Kraken | Read-only |
| trade | Kraken | Orders (dangerous) |
| funding | Kraken | Withdrawals (dangerous) |
| earn | Kraken | Staking (dangerous) |
| subaccount | Kraken | Transfers (dangerous) |
| futures | Mixed | Orders (dangerous) |
| futures-paper | No | None (simulation) |
| paper | No | None (simulation) |
| signals | ChainVector | Read-only intelligence |
| strategy | ChainVector | Read-only advisors (never place orders) |
| auth | No | Read-only |
Default: `market,account,paper,signals,strategy`. 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 NDJSON (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](agents/error-catalog.json).
### Verbose (`-v`)
Request/response diagnostics go to stderr, keeping stdout clean:
```bash
kraken balance -o json -v 2>/dev/null | jq .
```
</details>
## Commands
189 commands across 15 groups. For machine-readable parameter schemas, load [agents/tool-catalog.json](agents/tool-catalog.json).
| Group | Commands | Auth | Description |
|-------|----------|------|-------------|
| market | 10 | No | Ticker, orderbook, OHLC, trades, spreads, asset info |
| account | 18 | Kraken | Balances, orders, trades, ledgers, positions, exports |
| trade | 9 | Kraken | Order placement, amendment, cancellation (spot, xStocks, forex) |
| funding | 10 | Kraken | Deposits, withdrawals, wallet transfers |
| earn | 6 | Kraken | Staking strategies and allocations |
| subaccount | 2 | Kraken | 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 | 10 | No | Spot paper trading simulation with live prices |
| signals | 32 | ChainVector | ChainVector market intelligence: regime, momentum, probability, whale flow, liquidations, funding, positioning |
| strategy | 6 | ChainVector | Composite trade advisors: ensemble, momentum, mean-reversion, squeeze, cascade-fade, carry |
| auth | 4 | No | Credential management |
| utility | 2 | No | Interactive setup and REPL shell |
34 commands are marked `dangerous` (orders, withdrawals, transfers, cancel-all, staking). The authoritative list is the `dangerous` field in [agents/tool-catalog.json](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 |
### 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) |
### ChainVector Signals (read-only, ChainVector key)
| Command | Description |
|---------|-------------|
| `kraken signals snapshot --symbol BTC` | One-call bot decision snapshot |
| `kraken signals regime --symbol BTC` | Market regime classifier with confidence and rationale |
| `kraken signals momentum --symbol BTC [--type perp\|spot] [--exchanges LIST]` | Cross-venue momentum -100..+100 |
| `kraken signals lead-lag --symbol BTC [--window 5m\|10m\|30m]` | Which venue moves first |
| `kraken signals probability --symbol BTC-USDT [--target P] [--horizon 15m] [--kind terminal\|touch\|range]` | Probability engine |
| `kraken signals volatility --symbol BTC-USDT [--window W] [--horizon H] [--percentile]` | Realized vol battery with expected-move bands |
| `kraken signals indicators --symbol BTC-USDT [--interval 15m] [--indicators rsi,macd]` | Server-side RSI, EMA/MA, MACD, ATR, Bollinger |
| `kraken signals risk-index [--symbol BTC] [--history]` | 0-100 market stress composite |
| `kraken signals whale-pressure --symbol BTC` | Net whale buy/sell pressure |
| `kraken signals whale-trades --symbol BTC` | Individual large prints |
| `kraken signals cascade-risk --symbol BTC` | Liquidation cascade probability |
| `kraken signals liquidations --symbol BTC` | Recent liquidation flow |
| `kraken signals heatmap --symbol BTC` | Liquidation cluster levels |
| `kraken signals funding --symbol BTC` | Cross-venue funding rates |
| `kraken signals funding-weighted --symbol BTC` | OI-weighted composite funding |
| `kraken signals funding-squeeze --symbol BTC` | Crowded-side unwind score |
| `kraken signals funding-arbitrage` | Cross-venue carry pairs |
| `kraken signals basis --symbol BTC` | Spot-perp basis |
| `kraken signals positioning --symbol BTC` | OI, funding, long/short composite |
| `kraken signals long-short --symbol BTC` | Long/short ratios |
| `kraken signals cvd --symbol BTC` | Cumulative volume delta |
| `kraken signals book-imbalance --symbol BTC` | Order book imbalance |
| `kraken signals book-walls --symbol BTC` | Large resting orders |
| `kraken signals open-interest --symbol BTC` | Open interest across venues |
| `kraken signals screener` | Rank all tracked assets |
| `kraken signals history --symbol BTC-USDT [--limit N]` | Historical bars |
| `kraken signals options-probability --symbol BTC-USDT` | Options-implied probabilities |
| `kraken signals prediction-markets` | Tracked prediction markets |
| `kraken signals prediction-quotes` | Prediction market quotes |
| `kraken signals prediction-stability` | Quote stability diagnostics |
| `kraken signals prediction-edge` | Model-vs-market edge |
| `kraken signals status` | ChainVector API health and entitlements |
### ChainVector Strategy Advisors (read-only, ChainVector key)
| Command | Description |
|---------|-------------|
| `kraken strategy advise --symbol BTC [--horizon-min 15] [--max-risk-index 65]` | Full ensemble: regime gate + EV weighting + veto stack |
| `kraken strategy momentum --symbol BTC [--min-score 55] [--min-breadth 0.7]` | Momentum-continuation check |
| `kraken strategy meanrev --symbol BTC [--rsi-oversold 30] [--rsi-overbought 70]` | Mean-reversion check |
| `kraken strategy squeeze --symbol BTC [--min-score 60]` | Funding-squeeze play |
| `kraken strategy cascade-fade --symbol BTC [--min-score 60]` | Fade an exhausting liquidation cascade |
| `kraken strategy carry [--base BTC] [--min-spread-apr 0.05]` | Delta-neutral funding-carry scan |
### 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`. Known differences: paper supports `market` and `limit` order types only; slippage and partial fills are not modeled.
**Agent pattern:**
```bash
kraken paper init --balance 10000 -o json
kraken paper buy BTCUSD 0.01 -o json
kraken paper sell BTCUSD 0.005 --type limit --price 70000 -o json
kraken paper status -o json
kraken paper reset -o json
```
**Human pattern:**
```bash
kraken paper init --balance 5000 --currency EUR
kraken paper buy BTCUSD 0.01
kraken paper balance
kraken paper status
kraken paper orders
kraken paper history
kraken paper reset
```
| Command | Description |
|---------|-------------|
| `kraken paper init [--balance 10000] [--currency USD]` | Initialize paper account |
| `kraken paper reset` | Reconcile pending orders, then reset |
| `kraken paper balance` | All balances (total, reserved, available) |
| `kraken paper buy <PAIR> <VOL> [--type limit --price P]` | Paper buy (market or limit) |
| `kraken paper sell <PAIR> <VOL> [--type limit --price P]` | Paper sell (market or limit) |
| `kraken paper orders` | Open limit orders |
| `kraken paper cancel <ORDER_ID>` | Cancel a limit order |
| `kraken paper cancel-all` | Cancel all limit orders |
| `kraken paper history` | Filled trade history |
| `kraken paper status` | Portfolio value, unrealized P&L, trade count |
Prices come from the public Kraken Ticker API (no auth needed). A 0.26% taker fee (Kraken Starter tier default) is applied to all fills. Limit orders fill at the limit price when the live market crosses the order price.
All output is labeled `[PAPER]` in table mode and includes `"mode": "paper"` in JSON mode.
### Futures Paper Trading
Near-parity with live `kraken futures order` commands. Supports all 8 order types (market, limit, post, stop, take-profit, ioc, trailing-stop, fok), leverage and margin tracking, position aggregation/netting, liquidation simulation, and funding rate accrual. Known differences: `order-status` accepts a single ID (live accepts multiple), post-only orders are cancelled rather than simulating maker queue priority, fills use the bid/ask snapshot with no depth-based slippage, and partial fills are not modeled. Switch between paper and live by replacing `futures paper` with `futures order`.
Successful JSON responses include `"mode": "futures_paper"`. Most table views are labeled `[FUTURES PAPER]` or `[FP]`.
**Agent pattern:**
```bash
kraken futures paper init --balance 10000 -o json
kraken futures paper buy PF_XBTUSD 1 --leverage 10 --type market -o json
kraken futures paper sell PF_ETHUSD 5 --leverage 20 --type market -o json
kraken futures paper positions -o json
kraken futures paper status -o json
kraken futures paper reset -o json
```
**Human pattern:**
```bash
kraken futures paper init --balance 10000 --currency USD
kraken futures paper buy PF_XBTUSD 1 --leverage 10 --type market
kraken futures paper sell PF_XBTUSD 1 --leverage 10 --type limit --price 70000
kraken futures paper positions
kraken futures paper balance
kraken futures paper fills
kraken futures paper history
kraken futures paper reset
```
| Command | Description |
|---------|-------------|
| `kraken futures paper init [--balance B] [--currency C] [--fee-rate R]` | 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` | Equity, P&L since start, unrealized P&L, position/order counts |
| `kraken futures paper buy <SYM> <SIZE> [--leverage L] [--type TYPE] ...` | Paper long (all 8 order types) |
| `kraken futures paper sell <SYM> <SIZE> [--leverage L] [--type TYPE] ...` | 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 a resting order |
| `kraken futures paper cancel --order-id <ID>` | Cancel order (also supports `--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, P&L |
| `kraken futures paper fills [--since TS]` | Fill history |
| `kraken futures paper history` | Closed positions and cancelled orders |
| `kraken futures paper leverage` | Current leverage preferences |
| `kraken futures paper set-leverage <SYM> <LEV>` | Set default leverage per symbol |
Prices come from the public Kraken Futures Ticker API (no auth needed). Taker fees are simulated. Positions track leverage, margin, and liquidation prices. Funding rates are accrued based on the public funding rate API. Spot paper and futures paper are fully independent: resetting one does not affect the other.
## Examples
### Conditional order based on live price
```bash
PRICE=$(kraken ticker BTCUSD -o json | jq -r '.[].c[0]')
kraken order buy BTCUSD 0.001 --type limit --price "$PRICE" -o json
```
### Portfolio rebalance check
```bash
BTC=$(kraken balance -o json | jq -r '.BTC // "0"')
if [ "$(echo "$BTC > 0.001" | bc)" -eq 1 ]; then
kraken order sell BTCUSD 0.001 --type market -o json
fi
```
### Real-time price stream
```bash
kraken ws ticker BTC/USD -o json | while read -r line; do
LAST=$(echo "$line" | jq -r '.data[0].last // empty')
[ -n "$LAST" ] && echo "BTC: $LAST"
done
```
### Stream multiple tickers
```bash
kraken ws ticker BTC/USD ETH/USD SOL/USD -o json
```
### Dead man's switch
```bash
kraken order cancel-after 60
```
Cancels all open orders if the CLI does not reset the timer within 60 seconds.
## Agent Skills
Ships with 53 agent skills covering ChainVector signals intelligence, trading strategies, market analysis, and portfolio management. See the full [Skills Index](skills/INDEX.md).
<details>
<summary>Troubleshooting</summary>
**macOS blocks the binary ("Apple could not verify")**
```bash
xattr -d com.apple.quarantine /usr/local/bin/kraken
```
**"EAPI:Invalid key" or authentication errors**
Check that `KRAKEN_API_KEY` and `KRAKEN_API_SECRET` are set correctly. Keys are case-sensitive. Verify the API key has the required permissions for the command (Query Funds for `balance`, Modify Orders for `order buy`, etc.).
**Rate limit errors**
The CLI does not pre-throttle or retry rate-limited requests. The Kraken API server enforces rate limits, and the CLI returns the error immediately with a `suggestion` field containing tier-specific limits and a `docs_url` pointing to the relevant Kraken documentation. Read the suggestion and adjust request frequency. For sustained high-frequency use, prefer WebSocket streaming over REST polling.
**"No tools found" in MCP client**
Verify `kraken` is on your PATH. Run `kraken mcp -s market` in a terminal to confirm the server starts. Check that your client configuration matches the JSON format in the [MCP Server](#mcp-server) section.
**Spot paper trading state errors**
Run `kraken paper reset` to clear and reinitialize.
**Futures paper trading state errors**
Run `kraken futures paper reset` to clear and reinitialize. Spot and futures paper states are independent.
</details>
<details>
<summary>Architecture</summary>
```
src/
main.rs -- CLI entry point, clap parsing, exit codes
lib.rs -- AppContext, shared dispatcher, module re-exports
auth.rs -- HMAC-SHA512 signing (Spot + Futures), nonce management
config.rs -- Config file I/O, credential resolution, secret wrappers
client.rs -- HTTP clients with transient-error retry and enriched rate-limit errors
chainvector.rs -- ChainVector API client (auth, retries, envelope parsing)
errors.rs -- Unified error types with category-based JSON envelopes
paper.rs -- Spot paper trading state engine (local simulation)
futures_paper.rs -- Futures paper trading engine (leverage, margin, liquidation, funding)
shell.rs -- Interactive REPL with rustyline
telemetry.rs -- Agent client identification, instance tracking, user-agent
commands/ -- One module per command group
mod.rs -- Module re-exports
helpers.rs -- Shared utilities (JSON extraction, output formatting)
market.rs -- Public market data
account.rs -- Private account data
trade.rs -- Spot trading
funding.rs -- Deposits, withdrawals, wallet transfers
earn.rs -- Staking/earn
subaccount.rs -- Subaccount management
futures.rs -- Futures trading and market data
futures_paper.rs -- Futures paper trading commands
futures_ws.rs -- Futures WebSocket v1 streaming
websocket.rs -- Spot WebSocket v2 streaming
paper.rs -- Spot paper trading commands
signals.rs -- ChainVector signals intelligence commands
strategy.rs -- ChainVector strategy advisor commands
auth.rs -- Credential management commands
utility.rs -- Setup wizard
mcp/ -- Built-in MCP server
mod.rs -- Service group parsing, streaming exclusion filters
server.rs -- ServerHandler impl, tool dispatch, env-based URL resolution
registry.rs -- Tool registry built from clap tree + tool-catalog.json
schema.rs -- JSON Schema generation from clap argument metadata
output/ -- Rendering layer
mod.rs -- Format dispatch, CommandOutput type
table.rs -- Human-readable table output
json.rs -- JSON output and NDJSON streaming
```
</details>
## Development
```bash
cargo build # dev build
cargo test # run tests
cargo clippy -- -D warnings # lint
```
## Contributing
Bug reports, feature requests, and pull requests are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
## License & Disclaimer
MIT. See [LICENSE](LICENSE).
This is experimental software. Commands interact with the live Kraken exchange and can result in real financial transactions. Orders, withdrawals, and transfers are irreversible once processed. The authors accept no liability for financial losses. See [DISCLAIMER.md](DISCLAIMER.md) for full terms.
MCP Config
Below is the configuration for this MCP Server. You can copy it directly to Cursor or other MCP clients.
mcp.json
Connection Info
You Might Also Like
No recommendations available