trader.discovery.candidates module

A symbol a theme surfaced, and the evidence for it.

class trader.discovery.candidates.Candidate(symbol, theme, origin, headline=None, url=None, recommendation_mean=None)[source]

Bases: object

One discovered symbol, with the provenance that will explain it later.

headline and url are what answer “why did it buy UUUU?” three weeks afterwards, which is the whole reason watchlist_events records them.

recommendation_mean (issue #44) is the analyst-scan signal that earned an origin=”analyst_scan” candidate its slot — Yahoo’s 1..5 scale, the same field AnalystOpinion carries — snapshotted here so trader build-focus-list can persist it onto focus_list without a second live analyst lookup. None for every other origin; theme search never sets it.

Parameters:

  • symbol (str)

  • theme (str)

  • origin (str)

  • headline (str | None)

  • url (str | None)

  • recommendation_mean (float | None)

symbol: str
theme: str
origin: str
headline: str | None
url: str | None
recommendation_mean: float | None