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:
bashkraken balance -o json 2>/dev/null
Extended balance (includes credit and held amounts):
bashkraken extended-balance -o json 2>/dev/null
Trade balance (margin, equity, free margin):
bashkraken trade-balance --asset USD -o json 2>/dev/null
Portfolio Valuation
Combine balances with current prices to compute total portfolio value:
bash# 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:
bashkraken trades-history -o json 2>/dev/null
With ledger entries for cost basis:
bashkraken trades-history --ledgers -o json 2>/dev/null
Consolidated taker trades (merge partial fills):
bashkraken trades-history --consolidate-taker -o json 2>/dev/null
Time-filtered:
bashkraken closed-orders --start 1704067200 --end 1706745600 -o json 2>/dev/null
Query specific trades by TXID:
bashkraken query-trades <TXID1> <TXID2> -o json 2>/dev/null
Ledger Analysis
View all ledger entries (trades, deposits, withdrawals, staking):
bashkraken ledgers -o json 2>/dev/null
Filter by type:
bashkraken 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:
bashkraken ledgers --asset BTC -o json 2>/dev/null
Time range:
bashkraken ledgers --asset BTC --type trade --start 1704067200 --end 1706745600 -o json 2>/dev/null
Fee Analysis
Check current volume and fee tier:
bashkraken 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:
bashkraken export-report --report trades --description "Q1 2024 trades" --format CSV --starttm 1704067200 --endtm 1711929600 -o json 2>/dev/null
Check export status:
bashkraken export-status --report trades -o json 2>/dev/null
Download when ready:
bashkraken 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):
bashkraken export-delete <REPORT_ID> -o json 2>/dev/null
Futures Portfolio
Futures account summary:
bashkraken futures accounts -o json 2>/dev/null
Futures fill history:
bashkraken futures fills --since 2024-01-01T00:00:00Z -o json 2>/dev/null
Futures execution history:
bashkraken futures history-executions --sort desc -o json 2>/dev/null
Futures account log (CSV export):
bashkraken futures history-account-log-csv --since 2024-01-01T00:00:00Z -o json 2>/dev/null
Open Positions
Spot margin positions:
bashkraken positions --show-pnl -o json 2>/dev/null
Futures positions:
bashkraken futures positions -o json 2>/dev/null
Context Efficiency
- Use
--offsetand--limitfor paginated queries. - Use
--without-counton 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.
