Where does the name KREZUS come from?

The Polish word krezus means an extremely wealthy person or tycoon. It comes from Croesus, the historical king of Lydia who ruled in the 6th century BCE and was famed for his immense wealth...

1. Add assets in Transactions

1. Open Transactions and use the first card, Add asset.
2. Choose an item from the catalogue when available, or enter the asset name, class, account type and currency.
3. Enter the current price if known. If you already own the asset, enter quantity held and purchase price together, plus the purchase date. KREZUS creates one opening purchase transaction.
4. For new activity later, use the transaction form below. Do not add the same opening purchase twice.

Portfolio is now read-only: quantity held and cost are calculated from the transaction register. If an asset with the same name, class, currency and account already exists, KREZUS asks before creating a second one.

Account type abbreviations

These are short descriptions, not personal tax advice. Check current UK rules and product terms before relying on tax treatment.

2. Record transactions

Open Transactions, select the asset, transaction type and date, then fill in the relevant fields. For faster entry, use the dedicated “Record a dividend / interest” and “Record a Premium Bonds prize” buttons above the transaction form.

3. Keep prices and exchange rates up to date

• For manual pricing, open Settings from the footer and edit the asset's Current price. Portfolio is a read-only view. Totals and charts recalculate after the price is saved.
• Exchange rates for PLN, EUR and USD to GBP are requested when the tracker opens. You can also open Exchange rates to GBP and select Refresh exchange rates.
• Exchange rates come from Frankfurter and are reference rates, normally updated daily rather than live market quotes. If the connection fails, the tracker retains the last saved rates; initial rates may be examples, so check them before relying on calculations.
• Automatic asset prices use Twelve Data directly. Create a free account at Twelve Data API keys, copy your key. In Portfolio, use the visible Fetch current prices button for updates. For first-time setup, open Settings from the footer, then enter your key in Automatic prices, select Save API key, and run Test API key. No Worker or separate server is needed.
• Enter a supported symbol such as AAPL, BTC/USD, XAU/USD or SYMBOL:LSE. For exchange prices quoted in pence (GBX), set the multiplier to 0.01. Crypto and metals use USD pairs by default and are converted with the tracker's saved Frankfurter rates.
• The Basic free plan is limited to 8 API credits per minute and 800 per day, and covers only selected markets. Some UK-listed shares and funds are not available on this plan. When a symbol/market is unsupported, the tracker leaves the existing price unchanged and shows a status message; enter that valuation manually. The API key is stored locally in each browser and must be entered separately on every device. It is not encrypted by KREZUS.
• Check Twelve Data's current pricing and data-use terms before relying on price display. The Basic plan is labelled for internal non-display use, so a usage/display license may be needed depending on how you use the tracker.

How the new workflow fits together

Transactions → Portfolio → History and reports. Add assets and record every purchase, sale or income in Transactions. Portfolio is read-only: holdings and cost are calculated from the transaction register. Price changes and exchange-rate changes are managed in Settings and recalculate the views. The chart uses recorded changes and historical valuations; the History table keeps only one closing valuation per day.

4. Current value and history

• The Home page and read-only Portfolio table use the current holdings, transaction register, asset prices and exchange rates. Portfolio also includes allocation by asset class and account type.
• After a purchase, sale, income entry, asset-price change or exchange-rate change, KREZUS recalculates the portfolio and records a dated point in the change log. The value-over-time chart uses these change-log points as well as saved daily valuations. The first recorded state is shown as a single dot; later changes add points to the trend line.
• The History table keeps only one closing valuation per date. Further valuation saves for the same date replace that day's previous closing value, preventing duplicate daily rows.
• Use Save valuation to create or replace today's closing valuation. Use the historical valuation form only to enter a known value for a past date. Changing a historical value does not pretend that a current change happened on that old date.
• Re-fetching identical market prices or exchange rates does not add a duplicate chart point; only changed values create a new portfolio-history event. The first recorded state appears as a dot; further changes build the trend line.

5. Reports

• Portfolio includes allocation by asset class, account type and individual holding.
• Annual summary compares contributions, sales, valuations and results by calendar year or UK tax year.
• Capital gains (CGT) is an indicative overview only. The tracker does not apply every HMRC matching rule, historical transaction-date exchange rates or all loss carry-forwards. Do not use it as a substitute for checking your tax position.

6. Back up your data

1. Your working data is stored in the browser on the device you use. It does not automatically sync to another browser or device.
2. Select Create backup now or open Backups and data management → Backup (JSON). Store the downloaded file somewhere safe.
3. The tracker may offer to create a Krezus_Database folder if your browser supports direct folder access. Otherwise, the backup downloads as a file and can be moved manually.
4. To restore data, choose Restore backup and select the JSON file. Restoring replaces the data currently in this browser, so first export a backup of the current data if you may need it.

Important: make backups before clearing browser data, changing browser profiles or moving to another device. If the backup is encrypted with a PIN, you will need that PIN to restore it. The PIN cannot be recovered if forgotten.

Privacy first: local by design

Website visits are measured by Google Analytics 4 only after consent. This is separate from the local portfolio file; the downloaded ZIP version of the tracker does not include website analytics. You can change your choice in Cookie settings on the website.

• Your holdings, transactions and valuations are stored in this browser on this device. KREZUS does not upload your full portfolio to a KREZUS server and does not provide a KREZUS account or cloud storage.
• When automatic prices are enabled, your browser sends quote-symbol requests and your Twelve Data API key to Twelve Data. Currency-rate requests send currency codes to Frankfurter. These services receive the requests needed to return data, not the complete portfolio or transaction log.
• The Twelve Data API key is stored locally in each browser and is not encrypted by KREZUS. Enter it separately on each device you use.
• Backups are not automatically uploaded by KREZUS. The JSON file is saved wherever you choose to save it. For an offline copy, use a local folder, USB flash drive or external drive. If you choose a cloud-synced folder, that third-party service may upload the file.
• The tracker is free of charge and open source under the MIT License. Third-party services, trademarks and market data remain subject to their own terms. See LICENSE.txt.
• The tracker is a personal record-keeping tool, not a broker or investment, tax or legal adviser. Results depend on the entries, prices and exchange rates available in the tracker. PIN protection helps prevent casual access but does not replace device and backup security.

Skąd pochodzi nazwa KREZUS

Polskie słowo krezus oznacza osobę niezwykle bogatą lub potentata. Pochodzi od Krezusa (Croesus), historycznego króla Lidii, który panował w VI wieku p.n.e. i słynął z ogromnego majątku...

1. Dodawaj aktywa w zakładce Transakcje

1. Otwórz zakładkę Transakcje i użyj pierwszego kafelka Dodaj aktywo.
2. Wybierz pozycję z katalogu lub wpisz nazwę, klasę aktywów, rodzaj konta i walutę.
3. Wpisz aktualną cenę, jeśli ją znasz. Jeśli już posiadasz aktywo, podaj razem ilość i cenę zakupu oraz datę zakupu. KREZUS utworzy jedną transakcję początkową.
4. Kolejne operacje dodawaj w formularzu poniżej. Nie zapisuj tego samego zakupu ponownie.

Portfel jest teraz widokiem tylko do odczytu — ilość i koszt wynikają z rejestru transakcji. Jeśli aktywo o tej samej nazwie, klasie, walucie i koncie już istnieje, tracker zapyta przed utworzeniem drugiego wpisu.

Wyjaśnienie skrótów rodzajów kont

To krótkie objaśnienia, a nie indywidualna porada podatkowa. Przed zastosowaniem ulg sprawdź aktualne przepisy UK i warunki produktu.

2. Rejestruj transakcje

Otwórz Transakcje, wybierz aktywo, rodzaj operacji i datę, a następnie uzupełnij odpowiednie pola. Aby przyspieszyć wpisywanie, użyj przycisków „Dodaj dywidendę / odsetki” lub „Dodaj wygraną Premium Bonds” nad formularzem.

3. Aktualizuj ceny i kursy walut

• Przy ręcznej wycenie otwórz Ustawienia ze stopki i zmień pole Aktualna cena. Portfel jest widokiem tylko do odczytu. Sumy i wykresy przeliczą się po zapisaniu zmiany.
• Kursy PLN, EUR i USD do GBP są pobierane przy otwarciu trackera. Możesz też rozwinąć sekcję Kursy walut do GBP i wybrać Odśwież kursy walut.
• Kursy pochodzą z Frankfurter i są kursami referencyjnymi, zwykle aktualizowanymi raz dziennie, a nie notowaniami na żywo. Przy braku połączenia tracker zachowuje ostatnie zapisane kursy; kursy początkowe mogą być przykładowe, więc sprawdź je przed użyciem obliczeń.
• Automatyczne ceny aktywów korzystają bezpośrednio z Twelve Data. Załóż bezpłatne konto w Twelve Data API keys, skopiuj klucz. W zakładce Portfel korzystaj z widocznego przycisku Pobierz aktualne ceny. Przy pierwszej konfiguracji otwórz Ustawienia ze stopki, w sekcji Automatyczne ceny wklej klucz, kliknij Zapisz klucz API, a następnie Testuj klucz API. Nie potrzeba Workera ani osobnego serwera.
• Wpisz obsługiwany symbol, np. AAPL, BTC/USD, XAU/USD lub SYMBOL:LSE. Dla notowań w pensach (GBX) ustaw mnożnik 0,01. Dla krypto i metali domyślnie używana jest para w USD, a przeliczenie następuje z wykorzystaniem zapisanych w trackerze kursów Frankfurter.
• Bezpłatny plan Basic ma limit 8 kredytów API na minutę i 800 dziennie oraz obejmuje tylko wybrane rynki. Część akcji i funduszy notowanych w UK może być niedostępna. Jeśli symbol/rynek nie jest obsługiwany, tracker pozostawi dotychczasową cenę bez zmian i pokaże komunikat; taką wycenę należy wprowadzić ręcznie. Klucz API jest zapisywany lokalnie w każdej przeglądarce i trzeba go wpisać osobno na każdym urządzeniu. KREZUS go nie szyfruje.
• Przed korzystaniem sprawdź aktualne ceny i zasady wykorzystania danych Twelve Data. Plan Basic jest opisany jako przeznaczony do użytku wewnętrznego bez wyświetlania danych; w zależności od sposobu użycia trackera może być potrzebna odpowiednia licencja na wyświetlanie notowań.

Jak łączą się zakładki?

Transakcje → Portfel → Historia i raporty. Aktywa dodawaj i zapisuj zakupy, sprzedaże oraz dochody w Transakcjach. Portfel jest tylko do odczytu: ilość i koszt wynikają z rejestru transakcji. Ceny ręczne i ustawienia automatycznych notowań są w Ustawieniach, a zmiany przeliczają widoki. Wykres korzysta z zapisanych zmian i wycen historycznych; tabela Historii przechowuje jedną końcową wycenę na dzień.

4. Bieżąca wartość i historia

• Strona Start i widok Portfel korzystają z aktywów, rejestru transakcji, cen i kursów walut. Portfel pokazuje najpierw wykres alokacji i podsumowanie według klas aktywów, a poniżej tabelę posiadanych pozycji. Zawiera także alokację według kont i poszczególnych aktywów.
• Po zakupie, sprzedaży, dodaniu dochodu, zmianie ceny aktywa lub kursu waluty KREZUS przelicza portfel i zapisuje punkt w dzienniku zmian. Wykres wartości w czasie korzysta zarówno z punktów dziennika, jak i zapisanych wycen dziennych.
• Tabela Historia przechowuje tylko jedną końcową wycenę na dzień. Kolejny zapis dla tej samej daty zastępuje poprzednią wycenę, dzięki czemu nie powstają zduplikowane wiersze dzienne.
• Użyj przycisku Zapisz wycenę, aby utworzyć lub zastąpić dzisiejszą wycenę końcową. Formularz wyceny historycznej służy wyłącznie do wpisania znanej wartości z przeszłości. Zmiana historycznej wartości nie udaje, że obecna transakcja wydarzyła się w tamtym dniu.
• Ponowne pobranie identycznych cen rynkowych lub kursów nie dodaje zbędnego punktu na wykresie; nowy punkt pojawia się, gdy wartość faktycznie się zmieni. Pierwsza zapisana zmiana jest widoczna jako pojedynczy punkt, a kolejne zmiany tworzą linię trendu.

5. Raporty

• Portfel zawiera alokację według klas aktywów, kont i poszczególnych pozycji.
• Podsumowanie roczne porównuje wpłaty, sprzedaże, wyceny i wyniki w roku kalendarzowym lub brytyjskim roku podatkowym.
• Zyski kapitałowe (CGT) to tylko zestawienie orientacyjne. Tracker nie uwzględnia wszystkich reguł dopasowania HMRC, historycznych kursów walut z dat transakcji ani wszystkich strat przeniesionych z wcześniejszych lat. Nie traktuj go jako zamiennika sprawdzenia własnego rozliczenia podatkowego.

6. Rób kopie zapasowe

1. Dane robocze są zapisywane w przeglądarce na używanym urządzeniu. Nie synchronizują się automatycznie z inną przeglądarką ani urządzeniem.
2. Wybierz Utwórz kopię teraz albo otwórz Kopie zapasowe i zarządzanie danymi → Kopia zapasowa (JSON). Zachowaj pobrany plik w bezpiecznym miejscu.
3. Jeśli przeglądarka obsługuje bezpośredni dostęp do folderów, tracker może zaproponować utworzenie folderu Krezus_Database. W przeciwnym razie kopia zostanie pobrana jako plik i można ją przenieść ręcznie.
4. Aby odtworzyć dane, wybierz Przywróć kopię i wskaż plik JSON. Przywrócenie zastępuje dane aktualnie zapisane w tej przeglądarce, więc najpierw zrób kopię bieżących danych, jeśli mogą być jeszcze potrzebne.

Ważne: zrób kopię przed czyszczeniem danych przeglądarki, zmianą profilu lub przejściem na inne urządzenie. Jeśli kopia jest zaszyfrowana PIN-em, będzie on potrzebny do jej przywrócenia. Zapomnianego PIN-u nie można odzyskać.

Prywatność przede wszystkim — dane lokalnie

• Aktywa, transakcje i wyceny są przechowywane w tej przeglądarce na tym urządzeniu. KREZUS nie przesyła pełnego portfela na własny serwer i nie oferuje konta ani chmury KREZUS.
• Po włączeniu automatycznych cen przeglądarka wysyła do Twelve Data zapytania o symbole i klucz API. Zapytania o kursy walut przesyłają do Frankfurter kody walut. Te usługi otrzymują żądania niezbędne do zwrócenia danych, a nie cały portfel ani rejestr transakcji.
• Klucz API Twelve Data jest zapisany lokalnie w każdej przeglądarce i nie jest szyfrowany przez KREZUS. Wpisz go osobno na każdym używanym urządzeniu.
• KREZUS nie przesyła automatycznie kopii zapasowych do internetu. Plik JSON zapisuje się tam, gdzie zdecydujesz. Aby mieć kopię offline, użyj folderu lokalnego, pamięci USB/pendrive lub dysku zewnętrznego. Jeśli wybierzesz folder synchronizowany z chmurą, zewnętrzna usługa może wysłać plik do internetu.
• Tracker jest darmowy i open-source na licencji MIT. Zewnętrzne usługi, znaki towarowe i dane rynkowe podlegają własnym warunkom. Zobacz plik LICENSE.txt.
• KREZUS służy do prywatnej ewidencji; nie jest brokerem ani doradcą inwestycyjnym, podatkowym czy prawnym. Wyniki zależą od wpisów, cen i kursów walut. PIN utrudnia przypadkowy dostęp, ale nie zastępuje ochrony urządzenia i kopii zapasowych.