Kraken PnL Calculator

Tool to compute Profit & Loss (PnL) from Kraken spot trades using FIFO accounting, including historical FX conversion to a target currency.

---

Features

• FIFO-based PnL calculation for crypto trades
• Multi-pair support (BTC/EUR, BTC/USD, etc.)
• Asset-level filtering (e.g. BTC across multiple pairs)
• Historical FX conversion using Kraken OHLC data
• Multi-currency support with explicit target currency
• Year-based filtering for PnL reporting
• Fee-aware cost basis calculation
• Verbose logging mode for debugging pipeline steps

---

Project Structure

.
├── README.md: Current file
├── requirements.txt: Project's main requirements (solely first order dependencies)
├── .gitignore: Files to be ignored
└── src
    ├── apply_fifo.py: FIFO accounting logic
    ├── extract_asset_data.py: Asset data retrieval
    ├── gen_columns.py: Feature engineering / enrichment
    ├── main.py: Entry point (CLI orchestration)
    ├── utils_csv.py: CSV <-> DataFrame utilities
    ├── utils_fx.py: FX rate retrieval (Kraken OHLC)
    └── utils_log.py: Logging utilities

---

Download & Install dependencies

python3 -m pip install --upgrade pip
pip install -r requirements.txt

---

Usage

Run the script via CLI:

python3 src/main.py -i <input_csv> -o <output_csv> -a <asset> -c <currency> -y <year> -f <cache_file> -d <debug_dir> -v

---