mirror of
https://github.com/farcasclaudiu/xtb-investment-tools.git
synced 2026-06-22 07:01:58 +03:00
34 lines
1.6 KiB
Markdown
34 lines
1.6 KiB
Markdown
# XTB Report Format Notes
|
|
|
|
Load this when XTB parsing details matter.
|
|
|
|
## Workbook Layout
|
|
|
|
- XTB exports are `.xlsx` files.
|
|
- Metadata is in rows 1-4.
|
|
- Column headers begin on row 5, so pandas should use `header=4`.
|
|
- Main sheets:
|
|
- `Cash Operations`: trades, deposits, withdrawals, dividends, taxes, interest, conversions, and broker `Total` row.
|
|
- `Closed Positions`: realized trade summary; can be empty for still-open accounts.
|
|
- `Open Positions`: optional live/open-position sheet.
|
|
|
|
## Trade Reconstruction
|
|
|
|
- The review reconstructs trades primarily from `Cash Operations` comments such as `OPEN BUY 6 @ 301.50` and `CLOSE SELL 2 @ 100.00`.
|
|
- Use the real `Ticker` column as the instrument key, not only descriptive instrument text.
|
|
- Process trades chronologically before FIFO matching.
|
|
- Split-fill notation like `OPEN BUY 1/100 @ 14.3130` means executed quantity is `1`; use the numerator, not `0.01`.
|
|
- Some XTB stock sales appear as `CLOSE BUY` while the row type is `Stock sell` and amount is positive. Treat these economically as sales.
|
|
|
|
## Valuation
|
|
|
|
- Live prices come from `yfinance` daily closes at or before the report end date.
|
|
- Use trusted same-instrument symbol aliases only. Do not substitute a different share class as a proxy.
|
|
- If no trusted price exists, hold the ticker at cost and surface `price_source = cost` plus the reason.
|
|
|
|
## Cash And Performance
|
|
|
|
- Reconciliation compares computed ending cash with the broker `Total` row.
|
|
- Dividends and interest are internal cash flows unless withdrawn; do not count them as external cash flows for XIRR.
|
|
- XIRR may be `n/a` if the cash-flow signs or solver conditions are insufficient.
|