Tool
Astro Events
market.astro_events
Inputs
No typed inputs.
Outputs
A bundle of per-bar astro-event flags: which event types fired, on which bodies, plus event metadata. Feed it into interpretor.astro_event to turn the raw flags into a trading read, or gate entries on the bars where a chosen event lands.
Astro Events flags astronomical events for the planets you pick — retrograde and direct stations, sign ingresses, and solar or lunar eclipses — and tells you on which bar each one lands. It is a pure timing tool: it turns the sky's calendar into dated markers you can gate trades on.
How it works
For each selected body the tool reads its ephemeris position over time and detects the chosen event classes: a station is where the planet's apparent motion changes sign (retrograde vs direct), an ingress is where its zodiac longitude crosses a 30 degree sign boundary, and eclipses are Sun-Moon conjunctions (solar) or oppositions (lunar) near the lunar nodes. Events landing within cluster_window_bars of each other are merged, and the result is emitted as a bundle of flags and event metadata per bar.
Modes
Event types options
Flags the day a planet appears to halt and turn retrograde (begins moving backward against the stars). Retrograde stations are the classic 'change of direction' timing markers.
When to use: Use when you trade direction-change windows — Mercury and the faster planets turning retrograde are the most-watched.
Flags the day a retrograde planet halts and turns direct again (resumes forward motion). It pairs with the retrograde station to bracket a retrograde period.
When to use: Use to mark the END of a retrograde window — often read as a release of the prior stall.
Flags when a planet crosses from one zodiac sign into the next. Ingresses are treated as a change of 'mode' for that planet's influence.
When to use: Use to time the slower planets shifting sign — these mark longer thematic changes.
Flags a new-moon eclipse where the Moon blocks the Sun. Eclipses are the highest-impact astro events, often used as major turning-point markers.
When to use: Use to mark rare, high-weight timing dates — eclipses near a chart level are watched closely.
Flags a full-moon eclipse where the Earth's shadow falls on the Moon (Sun and Moon opposite). Like solar eclipses, these are read as major turning-point markers.
When to use: Use to mark high-weight full-moon eclipse dates, the opposition counterpart to a solar eclipse.
Bodies options
Scans the Sun for the selected event types; the Sun marks the solar year and major seasonal turns.
When to use: Include for mid-frequency timing signals.
Scans the Moon for the selected event types; the fast-moving Moon drives short, frequent timing signals.
When to use: Include for very frequent, short-horizon timing.
Scans Mercury for the selected event types; Mercury is watched for its frequent retrogrades and quick swings in sentiment.
When to use: Include for very frequent, short-horizon timing.
Scans Venus for the selected event types; Venus is associated with value, demand and risk appetite.
When to use: Include for mid-frequency timing signals.
Scans Mars for the selected event types; Mars is associated with volatility, momentum and aggression.
When to use: Include for mid-frequency timing signals.
Scans Jupiter for the selected event types; Jupiter moves slowly and is tied to expansion and longer cycles.
When to use: Include for major, slow-moving turning points.
Scans Saturn for the selected event types; Saturn moves slowly and is tied to contraction, structure and major lows.
When to use: Include for major, slow-moving turning points.
Scans Uranus for the selected event types; Uranus is a slow outer planet linked to sudden, disruptive shocks.
When to use: Include for major, slow-moving turning points.
Scans Neptune for the selected event types; Neptune is a slow outer planet linked to bubbles, illusion and fading themes.
When to use: Include for major, slow-moving turning points.
Scans Pluto for the selected event types; Pluto is the slowest outer planet, linked to deep, generational turning points.
When to use: Include for major, slow-moving turning points.
Configuration
Which classes of astronomical event to detect: retrograde station, direct station, sign ingress, solar eclipse, lunar eclipse. This is a multi-select — turn on every event class you want flagged.
Which celestial bodies to scan for the selected events — the Sun, Moon, and the eight planets Mercury through Pluto. This is a multi-select; fast bodies (Moon, Mercury) fire often, slow outer planets (Saturn, Uranus, Neptune, Pluto) fire rarely but carry more weight.
How many bars on either side of a raw event are collapsed into one signal, so a cluster of near-simultaneous events (for example several planets stationing within a few days) is reported once instead of many times. 0 reports every event on its exact bar; larger windows merge nearby events — roughly 0–20 bars, more = coarser clustering.
Connects to
Examples
- Timing gate: flag every Mercury retrograde station and block new entries for the bars around it.
- High-impact dates: turn on solar_eclipse + lunar_eclipse for the Sun and Moon and mark those bars on the chart.
- Slow-cycle turns: scan Saturn and Pluto ingresses to date major thematic shifts.
Common mistakes
- Leaving cluster_window_bars at 0 when you scan many bodies — a busy week of stations and ingresses then fires a flood of separate signals instead of one clustered marker.
- Expecting an event flag to be a buy or sell on its own — these are neutral timing markers; pair them with interpretor.astro_event or a price filter to get a direction.