Tool
Planet State
interpretor.planet_state
Inputs
The planetary bodies bundle from a market.planetary_aspects node, carrying each planet's longitude, sign, speed, and retrograde flag.
Outputs
A boolean that is true on each bar the chosen condition holds for the selected planet.
Planet State is a true/false gate that checks one condition about a single planet: whether it is retrograde, sitting in a named zodiac sign, or moving faster than a speed you set. It hands you a clean, bounded condition for shaping when a strategy is active. Treat it as a context filter, not a directional signal.
How it works
It reads the bodies bundle from a market.planetary_aspects node and outputs a BOOL. Pick the planet with `body` and what to check with `test`: retrograde state, the current zodiac sign (matched against `sign`), or whether the body's longitude speed exceeds `speed_threshold`.
Modes
Body options
Test the Sun's state on the dial.
When to use: Frame seasonal / solar-driven regimes around the Sun's position.
Test the Moon's state on the dial.
When to use: Tie short-term timing to the fast-moving Moon.
Test Mercury's state on the dial.
When to use: The default, and the classic body for retrograde gating.
Test Venus's state on the dial.
When to use: Gate around Venus cycles when your model favors them.
Test Mars's state on the dial.
When to use: Frame momentum / aggression regimes via Mars.
Test Jupiter's state on the dial.
When to use: Slower expansion cycles where Jupiter's sign matters.
Test Saturn's state on the dial.
When to use: Long, structural regimes keyed to Saturn.
Test Uranus's state on the dial.
When to use: Very slow, disruption-themed cycles via Uranus.
Test Neptune's state on the dial.
When to use: Long-horizon framing keyed to Neptune.
Test Pluto's state on the dial.
When to use: The slowest body — for very long structural eras.
Test options
True while the chosen body appears to move backward (retrograde). Ignores `sign` and `speed_threshold`.
When to use: The classic Mercury-retrograde block on new entries.
True while the chosen body sits in the zodiac sign you set in `sign`.
When to use: Allow trades only while a planet occupies a favored sign.
True while the body's longitude speed exceeds `speed_threshold` (degrees per day). Ignores `sign`.
When to use: Distinguish a fast direct planet from a near-stationary one.
Sign options
Match the chosen body against Aries (sign 1).
When to use: Gate when the body is in fiery, initiating Aries.
Match the chosen body against Taurus (sign 2).
When to use: Gate when the body is in steady, grounded Taurus.
Match the chosen body against Gemini (sign 3).
When to use: Gate when the body is in changeable Gemini.
Match the chosen body against Cancer (sign 4).
When to use: Gate when the body is in tidal, lunar Cancer.
Match the chosen body against Leo (sign 5).
When to use: Gate when the body is in bold, solar Leo.
Match the chosen body against Virgo (sign 6).
When to use: Gate when the body is in precise, analytical Virgo.
Match the chosen body against Libra (sign 7).
When to use: Gate when the body is in balancing Libra.
Match the chosen body against Scorpio (sign 8).
When to use: Gate when the body is in intense Scorpio.
Match the chosen body against Sagittarius (sign 9).
When to use: Gate when the body is in expansive Sagittarius.
Match the chosen body against Capricorn (sign 10).
When to use: Gate when the body is in disciplined Capricorn.
Match the chosen body against Aquarius (sign 11).
When to use: Gate when the body is in inventive Aquarius.
Match the chosen body against Pisces (sign 12).
When to use: Gate when the body is in dreamy Pisces.
Configuration
Which planet to test.
What to check: whether the body is retrograde, which zodiac sign it's in, or whether its speed is above a threshold.
The zodiac sign to match; only used by the in_sign test.
Longitude speed in degrees per day that the body must exceed; only used by the speed_above test.
Connects to
Examples
- Use is_retrograde on Mercury as a filter that blocks new entries during Mercury retrograde.
- Use in_sign to only allow trades while Mars is in Aries.
Common mistakes
- Mixing up the test and its setting — 'in_sign' needs the sign field, and 'speed_above' needs speed_threshold.
- Assuming a planet's state predicts price direction rather than just framing a period of time.