| name | pre-earnings-full-stack |
| description | Workflow composite for a single ticker heading into an earnings print. Chains earnings-blackout (timing check) + event-study (prior print reaction distribution) + guidance-tracker (management raise/cut track record) + analyst-tracker (sell-side positioning) + mc-portfolio-simulator (P&L distribution at proposed weight over the horizon). Emits a posture verdict (constructive_setup / mixed_setup / avoid_or_hedge / no_imminent_print). Requires Stocks Basic; guidance-tracker and analyst-tracker sections skip gracefully without Benzinga entitlements. |
pre-earnings-full-stack
Full pre-earnings prep on a single ticker. Chains five sub-skills and
emits an integrated read plus a size-sensitive posture.
When to invoke
- Pre-print decision: "should I trade this print?"
- Position sizing given an outlook
- Reading the reaction distribution before committing conviction
- The user says "full pre-earnings", "earnings prep", "should I
trade the print"
What you need
- A ticker (
--ticker)
MASSIVE_API_KEY exported- Stocks Basic minimum
- Optional: Benzinga Corporate Guidance and Analyst Ratings add-ons
Optional:
--proposed-weight (default 0.10)--n-prior-quarters (default 8)--horizon-days (default 10)--n-paths (default 10000)
What you get back
Layer 1: JSON with all five sub-skill outputs nested + a
posture block containing verdict + signals + warnings +
reaction_take.
Layer 2: rendered note. Posture header + signals / warnings +
per-sub-skill summary blocks + Take.
How it works
- earnings-blackout: check timing.
- event-study (aggregate mode, last ~2 years): reaction distribution
for prior prints.
- guidance-tracker: management's own trajectory (Benzinga add-on).
- analyst-tracker: sell-side positioning (Benzinga add-on).
- mc-portfolio-simulator: forward P&L at proposed weight.
Verdict logic:
constructive_setup: >=2 signals, 0 warnings, print imminentavoid_or_hedge: >=2 warnings, <=1 signal, print imminentmixed_setup: everything else with print imminentno_imminent_print: no upcoming print detected
