bvb-research

Instrument personal de analiză pentru companiile listate la BVB. Plan: docs/plan.md, surse: docs/surse-date.md.

Proiect neoficial, fără legătură cu Bursa de Valori București. Repository-ul conține doar cod și documentație; nu include date de piață. Datele colectate de pe bvb.ro sunt, conform termenilor BVB (/Disclaimer.aspx), doar pentru uz personal, necomercial; copierea, stocarea pentru alții sau redistribuirea cer acordul scris al BVB. Istoricul de prețuri folosește API-ul intern, nedocumentat, al graficului BVB (ADR 0001). Dacă rulezi codul, răspunzi de respectarea termenilor surselor. Nimic din acest proiect nu reprezintă recomandare de investiții.

Cod sub licența MIT. Situațiile financiare de pe data.gov.ro sunt publicate de Ministerul Finanțelor sub CC-BY 4.0.

Instalare

Merge pe macOS, Linux și Windows: Python 3.12 cu uv sau doar Docker (vezi mai jos).

uv sync
uv run playwright install chromium
uv run bvb init-db

Prețuri EOD

uv run bvb ingest bvb            # sedintele noi de pe BVB (se opreste la prima zi existenta)
uv run bvb ingest bvb --full     # toata fereastra BVB (~30 zile), umple golurile
uv run bvb ingest history        # istoric complet din graficul BVB (brut + ajustat)
uv run bvb ingest yahoo          # optional: istoric Yahoo, pentru validare
uv run bvb reconcile             # inchideri sumar BVB vs grafic BVB (--other yahoo)
uv run bvb status

• Pagina de sumar BVB oferă doar ultimele ~30 de zile. Istoricul complet vine din API-ul graficului BVB (source = 'bvb_hist', adj_close = ajustat de BVB), folosit cu acordul utilizatorului pentru uz personal.
• View-ul prices dă un singur preț pe zi și simbol: sumar BVB > grafic BVB > Yahoo.
• HTML-ul brut al fiecărei ședințe BVB se păstrează în data/raw/bvb_summary/.
• Datele sunt doar pentru uz personal (termenii BVB).

Emitenți, indici, prețuri ajustate

uv run bvb ingest indices        # BET, BET-TR, BET-FI, BET-NG, ROTX etc.
uv run bvb ingest issuers        # fisa emitentului: ISIN, CUI, nr. actiuni, dividende, modificari capital
uv run bvb adjust                # recalculeaza prices_adj (adj_close, tr_close) + raport de verificare

• prices_adj.adj_close: ajustat pentru evenimente de capital (acțiuni gratuite, splituri, consolidări). Factorii vin din seria ajustată BVB; modificările de capital pe care BVB nu le-a ajustat se derivă din numărul de acțiuni, doar dacă saltul de preț le confirmă.
• prices_adj.tr_close: randament total cu dividende brute reinvestite (factor P_ex / (P_ex + D)).
• adjust_events: evenimentele aplicate (capital, capital_derived, unknown) și salturile BVB tratate ca dividend.
• Raportul „mișcări suspecte” = salturi > 40% care persistă 5 zile în randamentul total; majoritatea sunt acțiuni nelichide din anii '90–2000.

Analiză și backtest

uv run bvb stock TLV                              # randament/risc pe 1/3/5/10 ani vs BET-TR, lichiditate, dividende
uv run bvb screen --years 3 --min-traded 0.8      # tabel comparativ actiuni REGS
uv run bvb backtest "TLV=0.4,SNP=0.3,H2O=0.3" --start 2020-01-01 --rebalance quarterly
uv run bvb backtest "TLV,SNP" --tax 0 --fee 0 --csv nav.csv

• Randamentele folosesc tr_close (dividende brute reinvestite); benchmark BET-TR, prelungit cu BET (fără dividende) înainte de 2014-09-19.
• Backtest: tranzacții la închidere, comision procentual, impozit pe dividende pe cotele istorice (--tax auto: 16% până în 2015, 5% 2016–2022, 8% 2023–2024, 10% 2025, 16% din 2026), dividende reinvestite în aceeași acțiune (drip) sau păstrate cash.
• În zilele fără tranzacții prețul e reportat: pentru acțiuni nelichide volatilitatea e subestimată și execuția e optimistă — verifică mereu coloana de lichiditate.

Risc de portofoliu

uv run bvb ingest metadata                        # sector, industrie, moneda (o data)
uv run bvb risk "TLV=0.3,SNP=0.25,H2O=0.25,ARS=0.1,CRC=0.1" --value 200000 --horizon 1

• VaR/CVaR istoric (ferestre suprapuse pe orizont) și parametric (normal, covarianță Ledoit-Wolf), contribuția fiecărei poziții la risc.
• Corelații și beta pe randamente săptămânale (atenuează efectul prețurilor reportate la acțiunile nelichide).
• Stres: episoade istorice (2008, 2011, OUG 114/2018, COVID, Ucraina) și șocuri BET-TR prin beta; acțiunile nelistate atunci sunt aproximate prin beta (coloana proxied).
• Concentrare: HHI, sectoare, companii controlate de stat (din structura acționariatului), expunere non-RON.
• Lichiditate: zile necesare vânzării fiecărei poziții la max. 20% din valoarea medie zilnică (--participation).
• VaR-ul istoric reflectă doar fereastra aleasă (--years); o fereastră fără crize subestimează riscul — compară cu scenariile de stres.

Date fundamentale și evaluare

uv run bvb ingest fundamentals                    # situatii financiare anuale 2008+ (data.gov.ro, CC-BY 4.0)
uv run bvb fundamentals SNP                       # istoric financiar, ROE, marja, payout, multipli actuali
uv run bvb valuation --sort pe --min-traded 0.8   # multipli pentru toata piata

• Situațiile de pe data.gov.ro sunt individuale (nu consolidate): pentru holdinguri (ex. Electrica, MedLife) multiplii nu reflectă grupul.
• Exercițiul N e considerat disponibil din 1 iunie N+1; capitalizarea istorică folosește numărul de acțiuni ajustat pentru evenimentele de capital.
• Valorile indicatorilor de pe paginile BVB „Indicatori financiari” sunt afișate ca imagini (protecție anti-extragere) și nu sunt folosite.

Anunțuri, calendar, știri

uv run bvb watch add TLV SNP H2O                  # lista de urmarire
uv run bvb ingest reports --windows 3             # rapoarte curente, toti emitentii (~10 zile / fereastra)
uv run bvb ingest news                            # RSS ZF + Profit.ro, etichetate cu emitentii
uv run bvb ingest report-texts                    # text din PDF-urile rapoartelor (lista de urmarire)
uv run bvb reports -w --category insider          # categorii: insider, results, agm, dividend, buyback, nav, ...
uv run bvb reports --search "dividend special"
uv run bvb calendar -w --days 30                  # rezultate, AGA, date ex-dividend
uv run bvb news -w

Lista de urmărire

Companiile pe care le urmărești îndeaproape (tabelul watchlist). Se modifică din linia de comandă:

uv run bvb watch list                             # afiseaza lista
uv run bvb watch add EL TGN                       # adauga simboluri
uv run bvb watch remove BRD                       # scoate simboluri

Cu Docker, aceleași comenzi rulează în containerul de ingestie, în afara rulării programate (după 19:15 în zilele lucrătoare, sâmbătă de la 10:00):

docker compose run --rm ingest bvb watch add EL TGN

Unde contează lista:

• Emitent: filtrul „Doar lista de urmarire” și emitentul afișat implicit (primul din listă).
• Calendar și anunțuri: bifa „Doar lista de urmarire” limitează evenimentele, anunțurile și știrile.
• Portofoliu: ponderile implicite pornesc de la primele 5 simboluri.
• Ingestie zilnică: alertele (anunțuri noi, dată ex-dividend în 7 zile, mișcări de peste 5%) și extragerea textului din PDF-urile rapoartelor (ingest report-texts) se fac doar pentru lista de urmărire.

Dashboard-ul citește baza doar pentru citire, așa că nu poate modifica lista; o schimbare apare în dashboard după următoarea copie publicată (automat la finalul comenzii watch).

Dashboard, alerte, rulare zilnică

uv run bvb dashboard                              # http://localhost:8501 (Emitent, Screener, Portofoliu, Calendar, Invatare)
uv run bvb alerts                                 # anunturi noi, ex-dividend in 7 zile, miscari > 5%
uv run bvb alerts --notify                        # idem + notificare de sistem (doar macOS)
uv run bvb daily                                  # dupa 18:30: preturi, rapoarte, stiri, ajustari, alerte
uv run bvb daily --full                           # saptamanal: + istoric grafic, indici, fise emitenti

Dashboard-ul citește data/bvb_read.duckdb, o copie publicată automat la finalul fiecărei comenzi care scrie (sau manual cu uv run bvb snapshot). Poate rula deci în timpul colectărilor și arată datele de la ultima comandă terminată; când apare o copie nouă, se redeschide singur (ora apare în bara laterală).

Docker

Alternativă la rularea manuală: ingestia programată și dashboard-ul în containere (ADR 0004). Datele rămân în ./data pe calculatorul gazdă.

docker compose up -d --build                         # porneste ingestia programata si dashboard-ul
docker compose logs -f ingest                        # rularile: daily L-V 19:15, daily --full sambata 10:00
docker compose run --rm ingest bvb ingest history    # o comanda ocazionala in container
docker compose down                                  # oprire

• Dashboard: http://localhost:8501, publicat doar pe 127.0.0.1.
• Cât rulează containerul ingest, nu porni comenzi care scriu de pe calculatorul gazdă (uv run bvb ingest ..., adjust, watch): DuckDB acceptă un singur proces care scrie. Comenzile de citire pot rula oricând.
• --notify trimite notificări doar pe macOS și nu funcționează din container; alertele apar în docker compose logs ingest.

Companii delistate

uv run bvb ingest delisted        # lista BVB (cautare avansata, incl. delistate) + istoric din graficul BVB
uv run bvb adjust                 # include si simbolurile delistate
uv run bvb backtest "TLV,AZO" --start 2008-01-01

• ~5.900 de acțiuni delistate în lista BVB (majoritatea foste RASDAQ); se păstrează doar cele cu istoric pe BVB, cu market = 'DELISTED'. Verificarea e reluabilă (delisted_probe).
• În backtest, o acțiune delistată se vinde la ultimul preț după ultima zi cu tranzacții, iar ponderea ei se redistribuie la rebalansare. Prețul de ieșire real (ofertă de preluare, faliment) poate diferi.

Dezvoltare

Reguli pentru dezvoltare (inclusiv pentru agenți): AGENTS.md, CONTRIBUTING.md, arhitectura și docs/engineering.

python3 scripts/install_hooks.py   # o data per clona: blocheaza commit/push direct pe main
python3 scripts/verify.py          # verificari repo + ruff + pytest (ca in CI)