Portfolio analysis, P&L tracking, trade history, and export reports.
Use this skill for:
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
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
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
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
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.
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:
kraken export-delete <REPORT_ID> -o json 2>/dev/null
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
Spot margin positions:
kraken positions --show-pnl -o json 2>/dev/null
Futures positions:
kraken futures positions -o json 2>/dev/null
--offset and --limit for paginated queries.--without-count on large history queries to skip count computation.