Earnings-Termine

Nimmt eine Liste aus Tickern und/oder ISINs entgegen und liefert deren Kalendertermine innerhalb eines Fensters (heute + days, oder ein ausdruecklicher Zeitraum). ISINs werden ueber ticker_reference zu Tickern aufgeloest.

Kommende Kalendertermine (aus calendar_events) innerhalb eines Fensters — heute, die naechsten 5 oder 14 Tage, oder ein ausdruecklicher Zeitraum — angereichert um Ticker, Name und ISIN.

Listet alle Ticker, die derzeit im Termine-Cache liegen.

Verwirft die zwischengespeicherten Termine eines Tickers von Hand. Der naechste Aufruf von /confidence oder /fetch holt sie neu.

Liefert den Terminkalender eines Tickers, nach Konfidenz gefiltert.

Dieser Endpunkt liest nur aus MongoDB — er holt nichts live nach. Liegt der Ticker noch nicht vor, rufen Sie zuerst auf:

• GET /earnings/fetch/{identifier}?origin=yf (schnell, speichert immer)
• GET /earnings/confidence/{identifier} (alle Quellen, speichert ab

Konfidenz 0,9)

Nimmt Ticker, ISIN, CIK und WKN entgegen (rein numerische WKNs mit Praefix: wkn:623100).

Holt Termine aus allen Quellen und berechnet daraus einen quellenuebergreifenden Konfidenzwert. Das Ergebnis bleibt cache_hours Stunden gespeichert.

Zustand der Termine-Lane in einem Aufruf.

Beantwortet: wie viele Ticker haben ueberhaupt Termine, wie viele sind bestaetigt, wie gross ist der Repair-Rueckstand, und welche Quelle liefert tatsaechlich. Das ist der Endpunkt, an dem sich der Repair-Fortschritt ablesen laesst.

Holt Termine fuer mehrere Identifier parallel (hoechstens 5 gleichzeitig).

Nimmt eine Liste von Identifiern entgegen — jeder kann Ticker, ISIN, WKN (mit wkn:-Praefix), CIK oder jede andere Form sein, die auch der Einzelabruf versteht.

origin gilt fuer alle Eintraege des Aufrufs.

Startet einen Hintergrundjob, der Termine fuer eine grosse Liste von Identifiern holt.

Antwortet sofort mit einer job_id — Fortschritt ueber GET /earnings/jobs/{job_id}.

• identifiers: einfache Liste aus Tickern, ISINs, WKNs oder CIKs (ohne

Obergrenze)

• origin: yf (schnell, speichert immer) oder all (fuenf Quellen,

speichert ab Konfidenz 0,9)

• concurrency: parallele Abrufe (Vorgabe 10, hoechstens 50)

``json {

"identifiers": ["AAPL", "MSFT", "DE0006231004", "isin:US5949181045"],
"origin": "yf",
"concurrency": 20

} ``

Collect earnings data and save to MongoDB.

origin=tiered (Default) yfinance zuerst; liefert es nichts oder weniger

als Konfidenz 0.9, folgen die restlichen vier Quellen.
Beim Einzelabruf lohnt das Bestaetigen, deshalb wird hier
anders als im Bulk auch bei einem Treffer eskaliert.

origin=yf yfinance.info only. Diagnose-Modus — fuer Bulk ungeeignet:

genau diese Einstellung hat 28.497 leere Cache-Docs erzeugt.

origin=all All five sources, immer alle kontaktiert.

Gespeichert wird, sobald mindestens ein Termin gefunden wurde; die Guete steht im quality-Subdokument (confirmed ab Konfidenz 0.9). Frueher wurden Einzelquellen-Treffer verworfen.

Accepts any identifier:

Listet die juengsten Sammel-Jobs, neueste zuerst.

Fragt den Stand eines Sammel-Jobs ab.

Werte von status:

• pending — eingereiht, noch nicht begonnen
• running — laeuft (done / total zeigt den Fortschritt)
• done — beendet (failed nennt Teilfehler)

Startet einen Hintergrundjob, der die Termine fuer jeden Ticker neu holt, der bereits im earnings_cache liegt.

• stale_only: bei true werden nur Eintraege erneuert, die aelter als

stale_hours sind

• stale_hours: Altersschwelle in Stunden (Vorgabe 24)
• origin / concurrency: wie bei /fetch/bulk

Antwortet sofort mit einer job_id.

Startet einen Hintergrundjob, der Termine fuer alle Eintraege in ticker_reference holt, die bereits eine ISIN haben und zu den angefragten Gattungen passen.

Vorgaben:

• market="stocks"
• active=true
• type_filters=["CS", "ADRC"]
• include_untyped_stocks=false

ADRS wird als Synonym akzeptiert und auf ADRC normalisiert.

Startet einen Hintergrundjob, der Termine fuer jeden Ticker in ticker_reference holt (befuellt ueber POST /tickers/sync).

Die Filter grenzen ein, welche Ticker einbezogen werden (Vorgabe: aktive Aktien). Antwortet sofort mit einer job_id — Fortschritt ueber GET /earnings/jobs/{job_id}.

Arbeitet die Altlast der Termine-Lane ab.

Hintergrund: origin="yf" war Default auf vier Request-Modellen und kontaktiert nur yfinance. Fuer 28.497 der 29.358 Ticker fand yfinance keinen Termin, die anderen fuenf Quellen wurden nie gefragt, und weil der leere Write fetched_at gesetzt hat, galten die Docs anschliessend 14 Tage als frisch — der Zustand hat sich selbst stabilisiert.

Zwei Durchgaenge:

• only_empty=true (Default) — Docs ohne jeden Termin. Das

$exists-Praedikat auf dates.0 schliesst die 861 guten Docs
strukturell aus, sie koennen also nicht erneut Budget kosten.

• only_unconfirmed=true — Docs mit Terminen, aber quality.confirmed

false. Hebt Einzelquellen-Treffer von ~0.69 auf >=0.9, indem eskaliert
wird, bis eine zweite Quelle bestaetigt.

Fortsetzbar ohne Offsets: die Worklist wird aus probe_at und quality.empty_streak abgeleitet, sortiert nach probe_at aufsteigend. Ein Abbruch bei Item 12.000 kostet nichts — der naechste Aufruf leitet die verbleibenden neu ab. Ist nichts mehr faellig, kommt 422 zurueck; der Cron-Loop wertet das als Erfolg und terminiert damit von selbst.

Fortlaufender Termine-Sync. Geht ticker_reference durch und holt nur die Ticker neu, deren Termine im earnings_cache fehlen oder aelter als max_age_days sind (gemessen an earnings_cache.fetched_at).

Aufloesung je Ticker:

1. ticker_reference.isin            → isin:<ISIN>
2. ersatzweise yahoo_profiles.yahoo_symbol (ueber den Ticker verbunden)
   → ticker:<SYMBOL>
3. zuletzt der blosse Ticker          → ticker:<TICKER>

Geholt wird gestuft (origin=tiered). Liefert eine job_id — Fortschritt ueber GET /earnings/jobs/{job_id}.