Merge branch 'main' of https://github.com/metalusmonk/crypto-pnl-tool

new read me online, merging with local.

Author: metalusmonk

README.md

@@ -61,17 +61,15 @@ Everything is scriptable and automation-friendly.
 
 ## Installation
 
-```bash
+
 pip install -r requirements.txt
 For development / tests:
 
-bash
-Copy code
+
 pip install -r requirements-dev.txt
 Configuration
 API Keys (Environment Variables)
-bash
-Copy code
+
 export COINBASE_API_KEY="..."
 export COINBASE_SECRET="..."
 
@@ -82,48 +80,42 @@ export BINANCEUS_API_KEY="..."
 export BINANCEUS_SECRET="..."
 Optional config.yaml
 yaml
-Copy code
+
 exchanges:
   - coinbase
   - kraken
-  # - binanceus
+  - binanceus
+
 Basic Usage
+
 Sync all configured exchanges
-bash
-Copy code
+
 python3 crypto_pnl_tool.py
 Sync only (no calculations)
-bash
-Copy code
+
 python3 crypto_pnl_tool.py --sync-only
 Skip syncing (use local DB only)
-bash
-Copy code
+
 python3 crypto_pnl_tool.py --no-sync
 Inspection & Audit Commands
 List deposits (for cost basis overrides)
-bash
-Copy code
+
 python3 crypto_pnl_tool.py --list-deposits --no-sync
 List withdrawals
-bash
-Copy code
+
 python3 crypto_pnl_tool.py --list-withdrawals --no-sync
 List recent trades
-bash
-Copy code
+
 python3 crypto_pnl_tool.py --list-trades --trade-limit 50 --no-sync
 Inspect open FIFO lots (audit view)
-bash
-Copy code
+
 # Single pair
 python3 crypto_pnl_tool.py --open-lots BTC/USD --no-sync
 
 # All quote pairs for a base asset
 python3 crypto_pnl_tool.py --open-lots BTC --no-sync
 Cost Basis Overrides (External Wallets)
-python
-Copy code
+
 from decimal import Decimal
 from crypto_pnl_tool import get_db_conn, add_cost_basis_override
 
@@ -139,88 +131,60 @@ add_cost_basis_override(
 Overrides create synthetic FIFO lots used in realized P&L.
 
 P&L Output
-bash
-Copy code
 python3 crypto_pnl_tool.py
 Example:
-
-makefile
-Copy code
 BTC/USD: P&L=-8.74 USD, Fees=1.23 USD
 ETH/USD: P&L=412.55 USD, Fees=4.10 USD
-Portfolio totals:
 
-bash
-Copy code
+Portfolio totals:
 python3 crypto_pnl_tool.py --portfolio
 8949-Style Tax Export
+
 Detailed FIFO export
-bash
-Copy code
 python3 crypto_pnl_tool.py \
   --tax-year 2025 \
   --export-8949 8949_2025.csv
 Optional rounding (export only)
-bash
-Copy code
+
 python3 crypto_pnl_tool.py \
   --tax-year 2025 \
   --export-8949 8949_2025.csv \
   --currency-decimals 2 \
   --asset-decimals 8
+
 Summary totals (separate file)
-bash
-Copy code
 python3 crypto_pnl_tool.py \
   --tax-year 2025 \
   --export-8949-summary 8949_summary_2025.csv
 Data Storage
 All data is stored locally in:
-
-Copy code
 crypto_pnl.sqlite
-Benefits:
 
+Benefits:
 Full auditability
-
 No repeated historical API calls
-
 Easy inspection with SQLite tools
-
 Testing
 Run FIFO unit tests:
-
-bash
-Copy code
 pytest -q
-Tests cover:
 
+Tests cover:
 FIFO math
-
 Partial lots
-
 Fees
-
 Deposit overrides
-
 Year filtering
 
 Docker (Optional)
 Docker is provided as a convenience only.
-
-bash
-Copy code
 docker build -t crypto-pnl-tool .
-bash
-Copy code
 docker run --rm \
   -e COINBASE_API_KEY="..." \
   -e COINBASE_SECRET="..." \
   -v "$(pwd):/app" \
   crypto-pnl-tool
+
 Project Structure
-text
-Copy code
 crypto-pnl-tool/
 ├── crypto_pnl_tool.py
 ├── crypto_pnl.sqlite
@@ -240,13 +204,9 @@ This tool is for accounting and analysis — not tax or legal advice.
 
 Roadmap (Optional)
 TurboTax-specific import mapping
-
 USD normalization for non-USD quotes
-
 FastAPI service wrapper
-
 Web dashboard
-
 Multi-year carryover validation
 
 License