Tool
Planetary Aspects (astro-state)
market.planetary_aspects
Inputs
No typed inputs.
Outputs
A bundle of per-bar aspects: which planet pairs are in aspect, the aspect type, and how exact (orb) it is. Feed it into interpretor.aspect to read the geometry as a trading bias, or gate entries on the bars where a chosen aspect is active.
Planetary Aspects measures the geometric angles between the planets you pick and flags the classic aspects — conjunction (0 degrees), sextile (60), square (90), trine (120) and opposition (180). These planet-to-planet angles are the core timing signals of financial astrology.
How it works
The tool reads each selected body's zodiac longitude from the ephemeris and computes the angular separation between every pair. When a separation lands within an orb of an aspect angle (0, 60, 90, 120 or 180 degrees) that aspect is flagged for that bar. The frame setting picks whether angles are measured from Earth (geocentric) or the Sun (heliocentric), and zodiac picks tropical or sidereal sign references; the result is emitted as a per-bar bundle of active aspects.
Modes
Bodies options
Includes the Sun as one end of the aspect search, measuring its angle to the other selected bodies; the Sun marks the solar year and major seasonal turns.
When to use: Include for mid-frequency aspects.
Includes the Moon as one end of the aspect search, measuring its angle to the other selected bodies; the fast-moving Moon drives short, frequent timing signals.
When to use: Include for frequent, fast-changing aspects.
Includes Mercury as one end of the aspect search, measuring its angle to the other selected bodies; Mercury is watched for its frequent retrogrades and quick swings in sentiment.
When to use: Include for frequent, fast-changing aspects.
Includes Venus as one end of the aspect search, measuring its angle to the other selected bodies; Venus is associated with value, demand and risk appetite.
When to use: Include for frequent, fast-changing aspects.
Includes Mars as one end of the aspect search, measuring its angle to the other selected bodies; Mars is associated with volatility, momentum and aggression.
When to use: Include for mid-frequency aspects.
Includes Jupiter as one end of the aspect search, measuring its angle to the other selected bodies; Jupiter moves slowly and is tied to expansion and longer cycles.
When to use: Include for slow, heavyweight aspects between outer planets.
Includes Saturn as one end of the aspect search, measuring its angle to the other selected bodies; Saturn moves slowly and is tied to contraction, structure and major lows.
When to use: Include for slow, heavyweight aspects between outer planets.
Includes Uranus as one end of the aspect search, measuring its angle to the other selected bodies; Uranus is a slow outer planet linked to sudden, disruptive shocks.
When to use: Include for slow, heavyweight aspects between outer planets.
Includes Neptune as one end of the aspect search, measuring its angle to the other selected bodies; Neptune is a slow outer planet linked to bubbles, illusion and fading themes.
When to use: Include for slow, heavyweight aspects between outer planets.
Includes Pluto as one end of the aspect search, measuring its angle to the other selected bodies; Pluto is the slowest outer planet, linked to deep, generational turning points.
When to use: Include for slow, heavyweight aspects between outer planets.
Frame options
Measures every aspect angle as seen from Earth — the standard frame for financial astrology, where planets can appear to go retrograde.
When to use: The usual default; use it for classic, Earth-centred aspect timing.
Measures every aspect angle as seen from the Sun — a smoother, Sun-centred frame with no retrogrades, used by some longer-cycle models.
When to use: Use when you want the cleaner Sun-centred geometry for slow planetary cycles.
Zodiac options
Measures sign positions from the spring equinox (0 Aries = the equinox point). This is the Western default that ignores precession of the stars.
When to use: The usual default; use it for standard Western financial astrology.
Measures sign positions against the fixed stars, shifted from the tropical zodiac by the precession offset (ayanamsa). Sign boundaries land at different longitudes than tropical.
When to use: Use when your method is built on the star-aligned sidereal zodiac rather than the seasonal one.
Configuration
Which celestial bodies to include in the aspect search — the Sun, Moon, and planets Mercury through Pluto. This is a multi-select; aspects are computed between every pair of the bodies you turn on, so more bodies means more candidate aspects.
Reference frame for the angles: geocentric measures them as seen from Earth (the standard, where retrogrades exist), heliocentric measures them as seen from the Sun (smoother, no retrogrades).
Which zodiac the sign positions are measured against: tropical is anchored to the spring equinox (the Western default), sidereal is anchored to the fixed stars and offset by the precession ayanamsa.
Connects to
Examples
- Volatility watch: include Mars and Saturn and flag the bars where they form a square (90 degrees).
- Slow-cycle timing: include Jupiter and Saturn and mark their conjunctions and oppositions.
- Reference switch: run the same body set in heliocentric frame to drop retrograde noise from the aspect stream.
Common mistakes
- Turning on every body at once and then treating each flagged aspect as a trade — a large body set produces many simultaneous aspects; narrow the set to the pairs your method actually uses.
- Mixing up frame and zodiac — frame (geo/helio) changes the vantage point of the angle, while zodiac (tropical/sidereal) only shifts where the sign boundaries fall; they are independent switches.