GPW CONSOLE — RETRO TERMINAL  v1.0  ::  gpwconsole.pl


  System skórowania spółek GPW połączony z live feedem komunikatów
  regulacyjnych ESPI/EBI i analizą sentymentu przez AI.
  Projekt hobbystyczny. Nie do celów komercyjnych.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## ŹRÓDŁO I CHARAKTERYSTYKA DANYCH
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Dane rynkowe    : biznesradar.pl — publiczne statystyki po sesji
  Odświeżanie     : automatyczne — pełny fetch Pn 03:00 (biznesradar, ~5 h)
                    szybki update cen Pn–Pt 09:30 i 17:35 (Yahoo Finance)
                    lub ręcznie: POST /api/v1/admin/fetch
  Komunikaty ESPI : co 2 sekundy, Pn–Pt 07:00–23:00 (Warsaw)
  Analiza AI      : Anthropic Claude — sentyment, typ, streszczenie

  Priorytety źródeł (kolejność stosowania):
  1. biznesradar.pl — rekomendacje analityków, dywidendy, ceny po sesji
                      (pełny fetch Pn 03:00; dane cotygodniowe)
  2. Yahoo Finance  — bieżące ceny i momentum intraday
                      (update 09:30 / 17:35; dobre dla akcji .WA)
                      Indeksy WIG/WIG20: alias WIG-POLAND.WA i WIG20.WA
                      (^WIG i ^WIG20 mają błędne mapowanie na Yahoo)
  3. gpw.pl         — kursy zamknięcia indeksów (WIG140, WIG20TR, mWIG40TR,
                      sWIG80TR) do porównania portfeli; po pełnym fetchu
  4. Zachowana wartość — jeśli żadne źródło nie odpowie, zostaje ostatni
                         znany wynik z poprzedniego fetcha

  ! Dane NIE są podawane w czasie rzeczywistym.
  ! Służą wyłącznie celom demonstracyjnym i edukacyjnym.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## ARCHITEKTURA I TECHNOLOGIA
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  System działa jako monolit FastAPI zintegrowany z modelami LLM.
  Do analizy komunikatów regulacyjnych (ESPI/EBI) wykorzystujemy
  Anthropic Claude (Sonnet).

  Import portfela XTB (zakładka [4] PORTFOLIO):
  Parsowanie     : przeglądarka (JavaScript + SheetJS)
  Przechowywanie : localStorage (lokalnie w przeglądarce użytkownika)
  Upload pliku   : BRAK — plik XLSX nigdy nie opuszcza urządzenia
  Sieć           : tylko anonimowe zapytania o ceny (GET /market/prices)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## OPIS ZAKŁADEK
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  [0] CHANGELOG
      Historia wersji projektu, pobierana na żywo z CHANGELOG.md.
      Legenda: [+] nowa funkcja · [*] ulepszenie · [-] bugfix ·
      [!] breaking change · [AI] Claude / ESPI.

  [1] TOP_10
      Ranking spółek GPW według systemu punktowego (maks. 110 pkt):

      A  20 pkt  Dyskonto kursu do mediany ceny docelowej (cap 30%,
                 rekomendacje starsze niż 180 dni pomijane)
      B  15 pkt  Jakość rekomendacji (liczba, domy, wiek, konsensus)
      C  25 pkt  Momentum relatywne vs WIG140, blend 3M/6M (info, patrz CF)
      D  10 pkt  Płynność obrotu; < 500 000 PLN/sesję: D = 0, poza Top 10
      E   5 pkt  Stopa dywidendy (cap 10%)
      F  25 pkt  Sentyment ESPI, ost. 60 dni, analiza AI (info, patrz CF)
      CF 50 pkt  Interakcja C×F — zastępuje C i F w sumie końcowej.
                 Wzór: CF = (0,5×C + 0,5×F) × korekta × 50
                 korekta = ×0,9 gdy |C−F| > 0,5 (sygnały sprzeczne)
                         = ×1,1 gdy C > 0,6 i F > 0,6 (silna zgodność)
                 C i F normalizowane do [0,1]; brak jednego z nich →
                 CF = drugi sygnał × 50, bez korekcji.
      G  10 pkt  Piotroski F-Score — jakość fundamentalna (zysk, bilans,
                 efektywność); 5 pkt neutral dla banków (inna metodologia)
      ─────────────────────────────────────────────────────────────────
      Filtr sektorowy: max 2 spółki z jednego sektora w Top 10.
      Klawisz [r] odświeża ranking bez przeładowania strony.
      Przycisk [+] przy pozycji rozwija uzasadnienie punktacji A-F w
      języku naturalnym (dyskonto, liczba rekomendacji, momentum vs
      WIG140, sentyment ESPI) na podstawie surowych danych z API.

  [2] AI_MORNING_BRIEF
      Dzienny skrót rynku generowany przez AI, odświeżany raz dziennie
      (Pon–Pt 08:15). Sekcje: MARKET (silne/słabe sektory — liczone
      deterministycznie), SPÓŁKI W CENTRUM UWAGI i SYGNAŁY ALERTÓW
      (wybór algorytmiczny z Top 10 / alertów ESPI, dane informacyjne —
      nie stanowią rekomendacji), PORTFOLIO (sygnały rebalancingu z
      Twojego lokalnego importu XTB), AI SUMMARY.

  [3] LIVE_ESPI
      Live feed komunikatów regulacyjnych ESPI/EBI z bankier.pl.
      Każdy komunikat analizowany przez AI: typ zdarzenia, sentyment
      (−1.0 … +1.0) oraz streszczenie w języku polskim.
      Filtry: ticker, typ zdarzenia, HIDE_ETF (ukrywa fundusze/ETF).
      Klawisz [f] pobiera najnowsze komunikaty.

  [4] PORTFOLIO
      Twój portfel: import z xStation 5 (eksport XLSX) i live P/L
      zaimportowanych pozycji (Yahoo Finance, odświeżane co 10 min).
      Sygnały rebalancingu dla Twoich pozycji: W TOP10 / NOWE /
      POZA TOP10 względem aktualnego Top 10 — z buforem 3 miejsc
      (Top11-13 trzymane bez zmian, sprzedaż dopiero poza Top13).
      W trybie buy-only (WIG140 < SMA30) lista POZA TOP10 jest
      informacyjna — decyzja o sprzedaży należy do Ciebie.
      Plik XLSX jest przetwarzany lokalnie — żadne dane nie opuszczają
      Twojego komputera.

  [5] STRATEGY
      Portfel strategii (serwerowy) — wyniki historyczne vs benchmark
      WIG140. Metryki: stopa zwrotu YTD, średni wynik miesięczny,
      Max Drawdown, Profit Factor, Win Rate.
      Log transakcji z historią rebalancingów (kupione / sprzedane).
      Otwarte pozycje strategii z live P/L (Yahoo Finance, odświeżane
      co 10 min) i sygnałami rebalancingu jak w [4].
      Generowanie miesięcznego raportu i wykonanie rebalancingu
      zgodnie z aktualnym rankingiem Top 10 (operacja nieodwracalna,
      tylko Admin).
      Tryb buy-only: gdy WIG140 < SMA30 (ostatnie 30 sesji; zanim
      zbierze się 30 sesji WIG140, sygnał liczony na WIG), sprzedaże
      i przycięcia pomijane automatycznie — amber banner [!] this is fine.
      Porównanie trzech portfeli (realny, AI Paper, mechaniczny Top 10)
      wobec WIG140 i 3×ETF: zwrot ważony czasem, brutto i po prowizji.
      Pełny raport, wykres i kalendarz ocen: strona /forward.
      AI Paper Portfolio: eksperymentalny portfel papierowy prowadzony
      przez Claude Sonnet 5 — agent ocenia propozycje rebalancingu
      algorytmu i może odroczyć wybrane transakcje (raz dziennie,
      Pn–Pt o losowej porze 11–15). Notatki między sesjami.

  [6] README
      Dokumentacja systemu — ta strona.

  [7] API
      Dokumentacja REST API. Endpointy, parametry, kody odpowiedzi
      i przykładowe payloady. Wymagany nagłówek X-API-Key.
      Interaktywna dokumentacja Swagger: https://gpwconsole.pl/docs

  [8] ROADMAP
      Plan rozwoju systemu: kamienie milowe, priorytety, status.
      Szczegóły w zakładce [8] ROADMAP.

  [9] CONTACT
      Dane kontaktowe: BIZNES (root@gpwconsole.pl), WSPARCIE / FEEDBACK
      (sysadmin@gpwconsole.pl), WYKOP Mikroblog (@gpw-console).

  [10] ANALYTICS
      Statystyki odwiedzin serwisu: łączna liczba zdarzeń, popularność
      zakładek, top referrerzy, najczęściej odwiedzane profile spółek
      oraz dzienny trend (PAGE LOAD). Zakres: ostatnie 30 dni (param days).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## STRATEGIA REBALANCINGU ([5] STRATEGY)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  PARAMETRY ALGORYTMU
  ─────────────────────────────────────────────────────────────────────
  Rebalancing           co miesiąc, ~15 dzień miesiąca
  Wpłata                1000 PLN/mies. (konfigurowalna)
  Liczba pozycji        max 10 nowych (bufor trzymania do TOP 13)
  Histereza (bufor)     pozycje #11–#13 trzymane bez zmian (nie sprzedawane)
  Histereza h=2         sprzedaż, gdy poza buforem także ≥7 dni wcześniej
  Tryb buy-only         blokada sprzedaży i przycięć gdy WIG140 < SMA30
  Minimalna transakcja  100 PLN (mniejsze różnice pomijane)
  Spółki bez ułamkowych całe akcje (weryfikacja brokera XTB)
  Podatek Belki         informacyjnie (nie odejmowany automatycznie)

  BENCHMARK — WIG140
  ─────────────────────────────────────────────────────────────────────
  Indeks                WIG140 (WIG20 + mWIG40 + sWIG80 = 140 spółek)
  Dlaczego WIG140       przekrój dużych/średnich/małych, bez mikrospółek
  Porównanie            wynik portfela vs zmiana indeksu w tym samym miesiącu
  Prowizje benchmarku   0% (indeks pasywny, bez kosztów transakcyjnych)

  Uwaga: strategia używa cen z zamknięcia sesji w dniu rebalancingu.
  Nie uwzględnia spreadów, prowizji ani poślizgu wykonania — wyniki
  są hipotetyczne. Benchmark WIG140 jest indeksem dochodowym (z
  dywidendami), a P/L portfela liczone jest z samych kursów.

  BACKTEST & WALIDACJA (2017–2026)
  ─────────────────────────────────────────────────────────────────────
  Okres testu           2017–2026 vs WIG140 (dochodowy), rebalans 30d
  Status                nie potwierdzono trwałej przewagi (prowizja 0,5%)*
  Ranking               Top 1–10 lepsze od dalszych rang tylko in-sample

  FORWARD TEST (od 2026-09-13)
  ─────────────────────────────────────────────────────────────────────
  Portfele              mechaniczny Top 10, AI Paper, realny
  Porównanie            WIG140 i 3×ETF, zwrot ważony czasem po kosztach
  Status                za wcześnie na wnioski — kalendarz ocen na /forward

  » Backtest i walidacja: pełny raport ->
  » Forward test na żywo + kalendarz ocen ->

  *Wyniki historyczne/hipotetyczne (m.in. survivorship bias, brak
  pełnej historii rekomendacji i ESPI); nie stanowią porady
  inwestycyjnej. Status hipotez i ograniczenia w raporcie.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## PUBLICZNE STRONY (poza zakładkami)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Poza tą aplikacją (SPA) serwis udostępnia osobne, indeksowalne
  strony HTML — bez logowania, bez klucza API:

  /gpw/{ticker}   Strona profilowa spółki: ranking, dystans do Top 10
                  (ile pkt brakuje i które komponenty są najsłabsze),
                  rozbicie score (A-E + CF), historia 6m, komunikaty ESPI,
                  podsumowanie AI, spółki powiązane z sektora.
  /top10          Aktualna dziesiątka najwyżej ocenianych
                  spółek, nowe wejścia, największe awanse/spadki.
  /ranking        Pełny ranking wszystkich ocenionych spółek,
                  statystyki, rozkład sektorowy, zmiany m/m.
  /backtest       Backtest i walidacja strategii (2017–2026) vs
                  WIG140: walk-forward, jakość rankingu, status
                  hipotez, ograniczenia. Link w zakładce [5] STRATEGY.
  /forward        Forward test na żywo: mechaniczny Top 10,
                  AI Paper vs WIG140 i 3×ETF (TWR po kosztach),
                  kalendarz ustalonych z góry ocen.

  Rankingi (/gpw, /top10, /ranking) odświeżane wraz z cotygodniowym
  fetchem (Pn 03:00); podsumowania AI per spółka raz w tygodniu.
  Strona /backtest jest statyczna (nie odświeża się automatycznie);
  /forward liczy się na żywo po każdym cotygodniowym fetchu.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## SKRÓTY KLAWISZOWE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  0 … 9           Przełączanie zakładek
  r               Odśwież scoring (zakładka 1)
  f               Pobierz ESPI (zakładka 3)
  s               Odśwież strategię (zakładka 5)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## WSPARCIE PROJEKTU
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Projekt jest w 100% niezależny i darmowy. Każda postawiona
  "kawa" zasila utrzymanie serwera i przyspiesza wdrażanie
  kolejnych funkcji. Podoba Ci się konsola? Wesprzyj:
  >> https://buycoffee.to/gpwconsole

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## ⚠  LEGAL DISCLAIMER — PRZECZYTAJ PRZED UŻYCIEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  [1] CHARAKTER INFORMACYJNY — NIE DORADZTWO INWESTYCYJNE
  ─────────────────────────────────────────────────────────
  Wszelkie treści publikowane przez gpwconsole.pl — w tym scoring spółek
  (A+B+CF+D+E+G), rankingi, sugestie rebalancingu portfela, analizy
  sentymentu komunikatów ESPI/EBI oraz raporty miesięczne — mają charakter
  wyłącznie INFORMACYJNY i EDUKACYJNY. Są one wynikiem w pełni
  zautomatyzowanego przetwarzania publicznie dostępnych danych rynkowych
  i nie uwzględniają indywidualnej sytuacji finansowej, celów
  inwestycyjnych, horyzontu czasowego ani skłonności do ryzyka
  konkretnego użytkownika.

  Metodologia scoringu (wzory, wagi, źródła danych) jest w pełni jawna —
  patrz zakładka [6] README, sekcja "OPIS ZAKŁADEK" → [1] TOP_10. Operator
  serwisu nie pobiera prowizji od transakcji, nie jest stroną żadnej z
  ocenianych spółek i nie ma interesu finansowego w konkretnym wyniku
  rankingu jakiejkolwiek spółki.

  Prezentowane treści NIE stanowią:
  • rekomendacji inwestycyjnej w rozumieniu art. 3 ust. 1 pkt 35
    Rozporządzenia Parlamentu Europejskiego i Rady (UE) nr 596/2014
    z dnia 16 kwietnia 2014 r. w sprawie nadużyć na rynku (MAR),
  • rekomendacji dotyczącej instrumentów finansowych w rozumieniu
    Rozporządzenia Delegowanego Komisji (UE) 2016/958,
  • doradztwa inwestycyjnego w rozumieniu art. 76 ust. 1 Ustawy z dnia
    29 lipca 2005 r. o obrocie instrumentami finansowymi (t.j. Dz.U.
    2023 poz. 646 z późn. zm.) ani usługi, o której mowa w art. 69
    ust. 2 pkt 5 tej ustawy,
  • usługi zarządzania portfelem instrumentów finansowych (art. 69
    ust. 2 pkt 4 ww. ustawy),
  • analizy inwestycyjnej ani analizy finansowej w rozumieniu
    Dyrektywy MiFID II (2014/65/UE) i aktów wykonawczych,
  • oferty ani zaproszenia do nabycia lub zbycia jakichkolwiek
    instrumentów finansowych.

  Operator serwisu gpwconsole.pl:
  • NIE jest podmiotem nadzorowanym przez Komisję Nadzoru Finansowego
    (KNF) ani żaden inny organ nadzoru finansowego,
  • NIE posiada zezwolenia na prowadzenie działalności maklerskiej,
  • NIE posiada licencji doradcy inwestycyjnego (lista KNF: knf.gov.pl),
  • NIE świadczy żadnych usług regulowanych w rozumieniu MiFID II /
    MiFIR ani polskiej ustawy o obrocie instrumentami finansowymi.

  Algorytm scoringowy A+B+CF+D+E+G jest narzędziem pomocniczym opartym
  na publicznie dostępnych danych. Jego wyniki NIE są prognozą kursów,
  NIE gwarantują zysku i NIE zastępują analizy przeprowadzonej przez
  uprawnionego doradcę inwestycyjnego lub dom maklerski.

  [2] RYZYKO INWESTYCYJNE
  ─────────────────────────────────────────────────────────
  Inwestowanie na Giełdzie Papierów Wartościowych w Warszawie (GPW)
  wiąże się z wysokim ryzykiem utraty części lub całości zainwestowanego
  kapitału. Wyniki historyczne nie gwarantują wyników przyszłych.
  Decyzje inwestycyjne podejmujesz wyłącznie na własną odpowiedzialność
  i ryzyko, po konsultacji z licencjonowanym doradcą inwestycyjnym.

  [3] ŹRÓDŁA DANYCH I ICH WIARYGODNOŚĆ
  ─────────────────────────────────────────────────────────
  Dane rynkowe pobierane są z publicznych serwisów (biznesradar.pl,
  finance.yahoo.com, bankier.pl). Serwis nie gwarantuje ich aktualności,
  kompletności ani poprawności. Komunikaty ESPI/EBI są analizowane
  automatycznie przez model AI (Anthropic Claude) — interpretacja AI
  może być błędna lub niepełna.

  [4] OCHRONA DANYCH OSOBOWYCH (RODO/GDPR)
  ─────────────────────────────────────────────────────────
  Komunikaty ESPI/EBI mogą zawierać dane osobowe (imiona i nazwiska
  członków zarządów, akcjonariuszy). Są to dane publicznie dostępne,
  opublikowane przez spółki w ramach ustawowych obowiązków
  informacyjnych (art. 17 MAR i art. 56 Ustawy o ofercie publicznej).
  Podstawa prawna przetwarzania: prawnie uzasadniony interes
  administratora (art. 6 ust. 1 lit. f RODO) — analiza regulacyjnych
  komunikatów spółek giełdowych w celach informacyjnych i badawczych.
  Obowiązek informacyjny z art. 14 RODO nie ma zastosowania na mocy
  art. 14 ust. 5 lit. b RODO — dane są pozyskiwane ze źródeł
  publicznie dostępnych w rozumieniu prawa.
  Okres retencji danych: 180 dni od daty publikacji komunikatu
  w bazie roboczej serwisu. Po tym czasie komunikat jest usuwany, a do
  archiwum trafia wyłącznie jego zanonimizowany ślad: ticker, nazwa
  spółki, data, typ zdarzenia, wartość finansowa i sentyment — bez
  treści, streszczenia i adresu komunikatu, a więc bez danych osobowych.
  Archiwum nie jest dostępne publicznie ani wykorzystywane w działaniu
  serwisu.
  Od 29.09.2026 komunikaty spółek spoza uniwersum serwisu nie są
  analizowane: przechowywany jest tylko adres komunikatu, symbol i nazwa
  spółki, przez 180 dni, po czym są usuwane bez archiwum. Komunikaty
  tych spółek przeanalizowane wcześniej usuwa standardowa retencja
  180 dni (najpóźniej do końca 2026 r.).
  Treść komunikatów spółek z uniwersum jest przekazywana do analizy przez
  Anthropic Inc. (USA) na podstawie Standardowych Klauzul Umownych
  (SCC, art. 46 ust. 2 lit. c RODO) i Data Processing Agreement
  Anthropic. Anthropic nie wykorzystuje tych danych do trenowania
  modeli na podstawie opt-out zgłoszonego przez administratora.
  Osobom, których dane dotyczą, przysługuje prawo dostępu (art. 15),
  sprzeciwu (art. 21), ograniczenia przetwarzania (art. 18) oraz
  wniesienia skargi do Prezesa UODO (uodo.gov.pl).
  Kontakt w sprawach RODO: sysadmin@gpwconsole.pl
  Pliki Excel importowane przez użytkownika są przetwarzane wyłącznie
  lokalnie w przeglądarce (JavaScript) i NIE są wysyłane na serwer.

  [5] WYŁĄCZENIE ODPOWIEDZIALNOŚCI
  ─────────────────────────────────────────────────────────
  Autor i operator serwisu gpwconsole.pl nie ponosi odpowiedzialności
  za jakiekolwiek straty finansowe, decyzje inwestycyjne ani inne
  szkody wynikłe z korzystania z prezentowanych danych lub narzędzi.
  Korzystanie z serwisu jest równoznaczne z akceptacją niniejszych
  warunków.

            GPW CONSOLE — REST API  v1.0  ::  gpwconsole.pl


  BASE URL  https://gpwconsole.pl
  DOCS      https://gpwconsole.pl/docs  (Swagger UI — interaktywna dokumentacja)

  AUTH      Nagłówek: X-API-Key: <twój-klucz>
            Bez klucza: GET /api/v1/health, /site-config, /changelog
            Dwa poziomy klucza:
              • publiczny — odczyt (scores/data/prices/report/
                morning-brief/portfolio/espi GET) — używa go ta strona
              • pełny — wszystko powyżej + POST /espi/sentiments,
                POST /espi/alerts, GET /espi/{id}
            /api/v1/admin/* — osobny mechanizm: tylko z 127.0.0.1,
            klucz API nieistotny (nie w tej warstwie ochrony)
            Brak → 401  ·  Zły klucz → 403  ·  Brak konfiguracji → 503
            Klucz API: napisz na sysadmin@gpwconsole.pl

  PRZYKŁAD  curl -H "X-API-Key: <klucz>" \
              https://gpwconsole.pl/api/v1/market/scores

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## QUICK REFERENCE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ── SYSTEM ─────────────────────────────────────────────────────────────────
  GET   /api/v1/health                  healthcheck, bez klucza
  GET   /api/v1/changelog               historia wersji, bez klucza

  ── PORTFOLIO ──────────────────────────────────────────────────────────────
  GET   /api/v1/portfolio                pozycje z P/L
  GET   /api/v1/portfolio/live           live P/L Yahoo Finance  (cache 3 min)
  GET   /api/v1/portfolio/history        historia rebalancingów  [?limit=12]

  ── MARKET / SCORING ───────────────────────────────────────────────────────
  GET   /api/v1/market/scores            pełny ranking (total: A+B+CF+D+E+G)
  GET   /api/v1/market/data              dane rynkowe (cache)
  GET   /api/v1/market/prices            live ceny  [?tickers=PKO,CDR,LPP]
  GET   /api/v1/report                   raport tekstowy [tylko localhost]
  GET   /api/v1/morning-brief            AI Morning Brief dzienny  (cache 1h)
  GET   /api/v1/market/mech-paper        mechaniczny portfel testowy  [?limit]
  GET   /api/v1/market/portfolios        porównanie portfeli (TWR)

  ── ESPI / KOMUNIKATY ──────────────────────────────────────────────────────
  GET   /api/v1/espi                     lista  [?ticker ?typ ?since ?limit …]
  GET   /api/v1/espi/{id}                szczegóły komunikatu
  POST  /api/v1/espi/sentiments          sentyment per ticker  {tickers, days}
  POST  /api/v1/espi/alerts              alerty  STRATA / RESTRUKTURYZACJA

  ── STRONY HTML (bez klucza, poza prefiksem /api/) ────────────────────────
  GET   /gpw/{ticker}                strona profilowa spółki (ranking, score, AI)
  GET   /top10                          strona: Top 10 spółek
  GET   /ranking                        strona: pełny ranking spółek
  GET   /sitemap.xml                    mapa strony (dynamiczna, per ticker)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## RESPONSE SCHEMAS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  GET /api/v1/health
  { "status": "ok", "espi_active": true,
    "next_rebalancing": "2026-07-31", "market_data_age_minutes": 42 }

  GET /api/v1/changelog
  { "status": { "VERSION": "v1.5.0", "COMMITS": "11", ... },
    "entries": [{ "date": "2026-07-02", "version": "v1.5.0",
      "items": [{ "tag": "+", "text": "Explainable scoring — ..." }] }] }

  GET /api/v1/portfolio/live
  { "mode": "portfolio"|"watchlist", "total_value": 5230.0,
    "total_pnl": 730.0, "total_pnl_pct": 16.2,
    "yahoo_ok": true, "fetched_at": "2026-07-01T10:15:00",
    "positions": [{ "ticker": "PKO", "shares": 10, "avg_price": 45.0,
      "price": 52.3, "pnl": 73.0, "pnl_pct": 16.2, "value": 523.0,
      "source": "live"|"avg" }],
    "recommendations": { "keep": [...], "buy": [...], "sell": [...] } }

  GET /api/v1/market/scores  (total: A+B+CF+D+E+G, C/F informacyjne)
  { "top10": [{ "ticker": "PKO", "score": 74.2,
      "A": 17.8, "B": 10.5, "C": 18.2, "D": 9.1, "E": 3.7, "F": 14.9,
      "CF": 33.1, "has_espi": true,
      "price": 52.30, "avg_target": 68.00, "discount_pct": 23.0,
      "sector": "Banki", "div_pct": 5.2, "age_days": 14,
      "n_recs": 4, "n_houses": 3, "n_buys": 3, "n_holds": 1, "n_sells": 0 }],
    "sector_victims": [...], "wig_mom3": 3.14, "wig_mom6": 5.02,
    "next_rebalancing": "2026-07-31", "warnings": [] }

  GET /api/v1/market/prices
  ?tickers=PKO,CDR,LPP                tickery oddzielone przecinkiem (max 50)
  { "prices": { "PKO": 103.34, "CDR": 224.20 },
    "yahoo_ok": true, "fetched_at": "2026-07-01T10:15:00" }

  GET /api/v1/morning-brief
  { "date": "2026-07-03", "generated_at": "2026-07-03T08:55:00",
    "data": { "date": "2026-07-03", "wig_change": 0.82,
      "strong_sectors": ["Banki"], "weak_sectors": ["Energetyka"],
      "opportunities": [{ "ticker": "PKO",
        "reasons": ["Dyskonto 18% do celu", "3 rekomendacje kupuj"],
        "confidence": 72 }],
      "risks": [{ "ticker": "CDR",
        "reasons": ["Obniżona prognoza wyników"], "confidence": 65 }],
      "summary": ["WIG w lekkim wzroście.", "Sektor bankowy najsilniejszy."] } }
  ("data": null gdy jeszcze nic nie wygenerowano — pierwszy brief pojawia
   się Pon-Pt o 08:55)

  GET /api/v1/espi
  ?ticker=PKO  ?typ_wydarzenia=KONTRAKT  ?min_sentyment=-1.0
  ?since=2026-06-01  ?limit=60  ?offset=0
  { "total": 142, "items": [{ "id": 1, "ticker": "PKO",
      "spolka": "Bacteromic S.A.", "typ_wydarzenia": "KONTRAKT",
      "sentyment": 0.7, "data_publikacji": "30.06.2026 09:14",
      "streszczenie": "...", "url": "https://..." }] }

  POST /api/v1/espi/sentiments
  body: { "tickers": ["PKO", "CDR"], "days": 60 }
  { "PKO": { "count": 4, "avg_sentiment": 0.12,
             "type_counts": { "WYNIKI": 2, "KONTRAKT": 2 } } }
  (tickery bez komunikatów w oknie nie pojawiają się w odpowiedzi)

  POST /api/v1/espi/alerts
  body: { "tickers": ["PKO", "CDR"], "days": 30 }
  [{ "ticker": "CDR", "typ_wydarzenia": "STRATA",
     "streszczenie": "...", "sentyment": -0.8 }]

                    GPW CONSOLE — PRODUCT ROADMAP


  Roadmap przedstawia kierunek rozwoju GPW Console.
  Priorytety są aktualizowane na podstawie opinii użytkowników
  oraz rzeczywistych potrzeb inwestorów.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[✓] MILESTONE 1 — CORE PLATFORM                                        COMPLETED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Fundamenty systemu GPW Console.

  ✓ Retro terminal interface
  ✓ GPW scoring engine (A+B+CF+D+E+G)
  ✓ Portfolio management + Live P/L
  ✓ XTB import
  ✓ AI ESPI analysis
  ✓ REST API + Swagger
  ✓ Public website
  ✓ Security & SEO
  ✓ Auto scheduler
  ✓ Changelog
  ✓ Explainable scoring
  ✓ AI Morning Brief

  Status: COMPLETED

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[ ] MILESTONE 2 — SMART INVESTING
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Rozbudowa narzędzi wspierających podejmowanie decyzji.

  Planned:

  □ AI Morning Brief 2.0
  □ Portfolio Insights
  □ Portfolio Simulator
  □ Custom Scoring
  □ Better AI explanations
  □ Smart Alerts

  Status: IN PROGRESS

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[ ] MILESTONE 3 — MARKET INTELLIGENCE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Rozszerzenie danych wykorzystywanych przez silnik scoringowy.

  Planned:

  □ Economic Calendar
  □ Macro events (NBP / FED / CPI / GDP)
  □ Financial statements
  □ Automatic financial ratios
  □ Better sector analytics

  Status: PLANNED

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[ ] MILESTONE 4 — OPEN PLATFORM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Rozwój ekosystemu oraz integracji.

  Planned:

  □ Contact backend
  □ Email notifications
  □ Broker integrations
  □ Public SDK
  □ Webhooks
  □ PWA support

  Status: PLANNED

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[ ] MILESTONE Ω — PROFESSIONAL MARKET DATA
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Długoterminowa wizja projektu.

  Cel:

  Przejście z publicznych źródeł danych na profesjonalny
  feed rynkowy czasu rzeczywistego.

  Vision:

  ◇ Native GPW market data
  ◇ Real-time quotations
  ◇ Tick-by-tick updates
  ◇ Instant portfolio valuation
  ◇ Live AI analysis
  ◇ Professional-grade infrastructure

  NOTE

  Realizacja wymaga komercyjnego dostępu do danych
  Giełdy Papierów Wartościowych w Warszawie
  oraz odpowiednich licencji.

  Status: LONG-TERM VISION

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Roadmap is continuously updated.

  Suggestions & feedback:

  >> sysadmin@gpwconsole.pl

                        GPW CONSOLE — CONTACT


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## DANE KONTAKTOWE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  BIZNES     Współpraca, partnerstwo, zapytania komercyjne
             >> root@gpwconsole.pl

  WSPARCIE   Pytania techniczne, dostęp API, zgłoszenia błędów
             >> sysadmin@gpwconsole.pl

  FEEDBACK   Pomysły, sugestie, opinie o projekcie
             >> sysadmin@gpwconsole.pl

  WYKOP      Mikroblog projektu, aktualizacje i dyskusje
             >> @gpw-console

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Projekt jest hobbystyczny i rozwijany w wolnym czasie.
  Czas odpowiedzi: do 48h w dni robocze.