kraken-portfolio-intel

name	kraken-portfolio-intel
version	1.0.0
description	Portfolio analysis, P&L tracking, trade history, and export reports.
metadata	{"openclaw":{"category":"finance"},"requires":{"bins":["kraken"]}}

kraken-portfolio-intel

Use this skill for:

• reading balances and computing portfolio value
• tracking trade history and P&L
• analyzing fee impact and volume tiers
• exporting reports for external analysis

Balance Overview

Simple balance:

kraken balance -o json 2>/dev/null

Extended balance (includes credit and held amounts):

kraken extended-balance -o json 2>/dev/null

Trade balance (margin, equity, free margin):

kraken trade-balance --asset USD -o json 2>/dev/null

Portfolio Valuation

Combine balances with current prices to compute total portfolio value:

# Get all balances
kraken balance -o json 2>/dev/null

# Get prices for held assets
kraken ticker BTCUSD ETHUSD SOLUSD -o json 2>/dev/null

# Agent calculates:
# value_per_asset = balance * price
# total_value = sum of all values
# weight_per_asset = value / total_value

Trade History

Recent trades:

kraken trades-history -o json 2>/dev/null

With ledger entries for cost basis:

kraken trades-history --ledgers -o json 2>/dev/null

Consolidated taker trades (merge partial fills):

kraken trades-history --consolidate-taker -o json 2>/dev/null

Time-filtered:

kraken closed-orders --start 1704067200 --end 1706745600 -o json 2>/dev/null

Query specific trades by TXID:

kraken query-trades <TXID1> <TXID2> -o json 2>/dev/null

Ledger Analysis

View all ledger entries (trades, deposits, withdrawals, staking):

kraken ledgers -o json 2>/dev/null

Filter by type:

kraken ledgers --type trade -o json 2>/dev/null
kraken ledgers --type deposit -o json 2>/dev/null
kraken ledgers --type withdrawal -o json 2>/dev/null
kraken ledgers --type staking -o json 2>/dev/null

Filter by asset:

kraken ledgers --asset BTC -o json 2>/dev/null

Time range:

kraken ledgers --asset BTC --type trade --start 1704067200 --end 1706745600 -o json 2>/dev/null

Fee Analysis

Check current volume and fee tier:

kraken volume --pair BTCUSD -o json 2>/dev/null

The response includes 30-day volume and the corresponding maker/taker fee rates.

Export Reports

Request a trade or ledger export for offline analysis:

kraken export-report --report trades --description "Q1 2024 trades" --format CSV --starttm 1704067200 --endtm 1711929600 -o json 2>/dev/null

Check export status:

kraken export-status --report trades -o json 2>/dev/null

Download when ready:

kraken export-retrieve <REPORT_ID> -o json 2>/dev/null

Clean up old reports (export-delete is flagged dangerous — the report is gone and must be regenerated, so confirm with the user first):

kraken export-delete <REPORT_ID> -o json 2>/dev/null

Futures Portfolio

Futures account summary:

kraken futures accounts -o json 2>/dev/null

Futures fill history:

kraken futures fills --since 2024-01-01T00:00:00Z -o json 2>/dev/null

Futures execution history:

kraken futures history-executions --sort desc -o json 2>/dev/null

Futures account log (CSV export):

kraken futures history-account-log-csv --since 2024-01-01T00:00:00Z -o json 2>/dev/null

Open Positions

Spot margin positions:

kraken positions --show-pnl -o json 2>/dev/null

Futures positions:

kraken futures positions -o json 2>/dev/null

Context Efficiency

• Use --offset and --limit for paginated queries.
• Use --without-count on large history queries to skip count computation.
• Filter by asset and time range to reduce response size.
• Use exports for bulk data instead of paginating through REST.

If you hit a mismatch between what you are trying to do and the CLI's interface or responses — including a mismatch between this skill and the installed CLI version's contract — feel free to submit feedback with kraken feedback.