Tool
Aspect
interpretor.aspect
Inputs
The planetary-positions bundle from a market.planetary_aspects node, carrying each body's longitude and speed so the aspect can be measured.
Outputs
A single boolean that is true on each bar the chosen aspect is in orb (and matches the selected polarity).
Aspect is a true/false gate that fires when two planets form a named angle to each other (like a square or conjunction) within a chosen tolerance. Financial astrologers watch these moments as candidate timing points, and it can also tell apart an aspect that is still tightening (applying) from one that is loosening (separating). Use it as a gate, not a prediction of direction.
How it works
It reads the bodies bundle from a market.planetary_aspects node and checks whether the chosen pair (or any selected pair) is within orb_degrees of the named aspect, optionally for a few bars after the exact hit. It uses the planets' relative speed to label the aspect applying or separating, and outputs a single BOOL.
Modes
Mode options
Watch one specific pair of planets (body_a and body_b) for the named aspect.
When to use: When your strategy keys off a single well-known pairing, like Mars-Saturn squares.
Fire when ANY of the selected bodies form the named aspect within orb.
When to use: When you care that the aspect is happening somewhere in the chart, not for one fixed pair.
Body a options
Place the Sun as the first body of the pair.
When to use: When the Sun anchors the pairing you are timing.
Place the Moon as the first body of the pair.
When to use: When the fast-moving Moon is your trigger body.
Place Mercury as the first body of the pair.
When to use: When you key timing off Mercury, often for news or communication cycles.
Place Venus as the first body of the pair.
When to use: When Venus is your anchor body for value or sentiment cycles.
Place Mars as the first body of the pair (the default).
When to use: The default; Mars is a common driver in volatility-timing pairs.
Place Jupiter as the first body of the pair.
When to use: When the slower Jupiter anchors a longer-cycle pairing.
Place Saturn as the first body of the pair.
When to use: When Saturn anchors a structural, slow-moving pairing.
Place Uranus as the first body of the pair.
When to use: When you watch Uranus for shock or breakout timing.
Place Neptune as the first body of the pair.
When to use: When Neptune anchors a very slow, long-horizon pairing.
Place Pluto as the first body of the pair.
When to use: When Pluto anchors the slowest, generational pairing.
Body b options
Place the Sun as the second body of the pair.
When to use: When the Sun is the partner body you aspect against body_a.
Place the Moon as the second body of the pair.
When to use: When the Moon is the fast partner body in the aspect.
Place Mercury as the second body of the pair.
When to use: When Mercury is the partner body in the aspect.
Place Venus as the second body of the pair.
When to use: When Venus is the partner body in the aspect.
Place Mars as the second body of the pair.
When to use: When Mars is the partner body aspected against body_a.
Place Jupiter as the second body of the pair.
When to use: When Jupiter is the slower partner body in the aspect.
Place Saturn as the second body of the pair (the default).
When to use: The default partner; Saturn is a common structural counter-body.
Place Uranus as the second body of the pair.
When to use: When Uranus is the partner body, often for shock timing.
Place Neptune as the second body of the pair.
When to use: When Neptune is the slow partner body in the aspect.
Place Pluto as the second body of the pair.
When to use: When Pluto is the slowest partner body in the aspect.
Aspect options
Fires when the two bodies sit at the same point on the dial (0 degrees apart).
When to use: The strongest major; mark moments when two influences merge.
Fires when the bodies are 60 degrees apart.
When to use: A soft, harmonious minor-major; gentle supportive timing.
Fires when the bodies are 90 degrees apart (the default).
When to use: A hard, tension aspect; classic volatility-timing window.
Fires when the bodies are 120 degrees apart.
When to use: The smoothest major; flowing, easy timing windows.
Fires when the bodies sit directly across the dial, 180 degrees apart.
When to use: A hard, polarizing major; often marks culmination or reversal windows.
Fires when the bodies are 30 degrees apart.
When to use: A weak minor; subtle adjustment timing, use with a tight orb.
Fires when the bodies are 45 degrees apart.
When to use: A hard minor; mild friction, a smaller cousin of the square.
Fires when the bodies are 135 degrees apart.
When to use: A hard minor; tension at one-and-a-half squares, use a tight orb.
Fires when the bodies are 150 degrees apart.
When to use: An awkward minor; mark unresolved-tension or adjustment windows.
Polarity options
Fire whether the aspect is tightening or loosening (the default).
When to use: When you only care that the aspect is in orb, not its direction.
Fire only while the aspect is still tightening toward exact.
When to use: When you want the build-up phase before the exact hit.
Fire only while the aspect is loosening away from exact.
When to use: When you want the release phase after the exact hit.
Configuration
Choose 'body_pair' to watch one specific pair, or 'any_within_orb' to fire when any of the selected bodies form the aspect.
The first planet in the pair (used in body_pair mode).
The second planet in the pair (used in body_pair mode).
Which named angle to watch - majors like conjunction, square, trine, opposition, plus minors at 30, 45, 135, and 150 degrees.
Whether to fire only while the aspect is tightening (applying), only while loosening (separating), or either.
How close to the exact angle counts as a hit; larger values make the gate fire more loosely.
Also keep firing for this many bars after the exact aspect; 0 means only the exact bar.
Connects to
Examples
- Use it as a filter that only allows entries when Mars and Saturn are square within 6 degrees.
- Combine it with an oscillator signal so a trade fires only near an applying conjunction.
Common mistakes
- Setting orb_degrees very wide, which keeps the gate true for long stretches and stops it being selective.
- Expecting an aspect to predict whether price goes up or down - it only marks a timing window.