kraken-tax-export

name: kraken-tax-export version: 1.0.0 description: "Export trade history, ledgers, and cost basis data for tax reporting." metadata: openclaw: category: "finance" requires: bins: ["kraken"] skills: ["kraken-portfolio-intel"]

Use this skill for:

exporting trades and ledgers for tax preparation
generating CSV exports for import into tax software
computing realized gains from trade history
auditing deposits and withdrawals for completeness

Trade Export

Request a full trade export for a tax year:

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

Check 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 after download:

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

Ledger Export

Ledgers capture all account activity (trades, deposits, withdrawals, staking rewards, fees):

kraken export-report --report ledgers --description "2024 full ledger" --format CSV --starttm 1704067200 --endtm 1735689600 -o json 2>/dev/null

JSON Trade History (Alternative)

For smaller date ranges, query directly:

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

Filter by time:

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

Futures History

Futures trades are exported separately:

kraken futures history-executions --since 2024-01-01T00:00:00Z --before 2025-01-01T00:00:00Z --sort asc -o json 2>/dev/null

Futures account log (CSV):

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

Deposit and Withdrawal Records

Complete picture for tax reconciliation:

kraken deposit status --start 1704067200 --end 1735689600 -o json 2>/dev/null
kraken withdrawal status --start 1704067200 --end 1735689600 -o json 2>/dev/null

Earn/Staking Rewards

Staking rewards appear as ledger entries of type staking:

kraken ledgers --type staking --start 1704067200 --end 1735689600 -o json 2>/dev/null

Cost Basis Workflow

Export all trades for the tax year (CSV).
Import into tax software (Koinly, CoinTracker, etc.).
Verify deposit/withdrawal records match exchange data.
Cross-reference staking rewards from ledger entries.
Generate tax report.

Hard Rules

Export data is read-only; no dangerous operations involved.
Verify export completeness by checking trade counts against trades-history totals.
Keep exports secure; they contain full trading history.
Futures and spot exports are separate; ensure both are included.