Kraken Exchange

1. Install the binary

cargo install tentactl

Or download from GitHub Releases (Linux, macOS, Windows).

2. Configure API keys (optional)

Market data tools work without any keys. For account and trading tools:

echo "KRAKEN_API_KEY=your-key" > ~/.tentactl.env
echo "KRAKEN_API_SECRET=your-secret" >> ~/.tentactl.env
chmod 600 ~/.tentactl.env

Or use the 1Password setup script: scripts/setup-keys.sh

Key permissions: Create keys at https://www.kraken.com/u/security/api

• Read-only: enable Query Funds and Query Open Orders & Trades
• Trading: also enable Create & Modify Orders

Usage

# Market data (no auth)
scripts/kraken.sh get_ticker '{"pair":"XBTUSD"}'
scripts/kraken.sh get_orderbook '{"pair":"ETHUSD","count":5}'
scripts/kraken.sh futures_tickers '{}'

# Live WebSocket streams
scripts/kraken.sh ws_subscribe_ticker '{"symbols":["BTC/USD"]}'
scripts/kraken.sh ws_subscribe_book '{"symbols":["ETH/USD"],"depth":10}'
scripts/kraken.sh wf_subscribe_ticker '{"product_ids":["PI_XBTUSD"]}'
scripts/kraken.sh ws_status '{}'

# Account (needs API keys)
scripts/kraken.sh get_balance '{}'
scripts/kraken.sh futures_open_positions '{}'

# Trading (needs API keys) ⚠️ REAL MONEY
scripts/kraken.sh place_order '{"pair":"XBTUSD","direction":"buy","order_type":"limit","volume":"0.001","price":"50000","validate":true}'
scripts/kraken.sh ws_add_order '{"symbol":"BTC/USD","side":"buy","order_type":"limit","limit_price":"50000","order_qty":"0.001","validate":true}'

Tools Reference

See references/tools.md for full parameter docs on all 114 tools.

Safety Rules

• ALWAYS use validate: true first when placing orders
• ALWAYS confirm with the user before placing real orders
• NEVER place orders without explicit user approval
• Market orders execute IMMEDIATELY — prefer limit orders
• Display validation result and ask for confirmation before removing validate
• Trading tools are marked with ⚠️ REAL MONEY in their descriptions

Trading Pairs

• Spot REST: Kraken format — XBTUSD, ETHUSD, SOLUSD
• Spot WebSocket: Standard format — BTC/USD, ETH/USD, SOL/USD
• Futures: Product IDs — PI_XBTUSD, PI_ETHUSD, PF_SOLUSD

Automation Patterns

DCA (Dollar Cost Average)

openclaw cron add --schedule "0 9 * * 1" --task "Buy $50 of BTC on Kraken using the kraken skill. Use validate first, then execute."

Price Alerts

Subscribe to WebSocket ticker, check thresholds in heartbeat/cron, notify via WhatsApp/Telegram.

Portfolio Monitoring

Cron job that checks balances + positions + current prices, calculates P&L, alerts on significant changes.

Funding Rate Arbitrage

Subscribe to futures tickers, monitor funding rates, alert when rates diverge significantly.