lib_vsop87_mercuryLibrary "lib_vsop87_mercury"
Heliocentric and geocentric position calculations for Mercury
using VSOP87 theory. Provides longitude, latitude, radius, speed,
and declination functions.
@author BlueprintResearch (Javonnii)
@license MIT License - Free to use with attribution
@theory VSOP87A (Heliocentric rectangular coordinates)
@accuracy Truncated series (~10-15 terms per series) - arcsecond precision
@time_scale Julian millennia from J2000.0 (use core.get_julian_millennia)
@reference Meeus, Jean. "Astronomical Algorithms" (2nd Ed., 1998)
Bretagnon & Francou. "VSOP87 Solutions" (1988)
@showcase Includes commented showcase code with 250-bar future projection.
Uncomment to display Mercury data with polyline projections.
@open_source This library is part of an open-source alternative to
proprietary astronomical libraries. Study, modify, and
share freely. We believe knowledge of the cosmos belongs
to everyone.
════════════════════════════════════════════════════════════════
© 2025 BlueprintResearch / Javonnii
Licensed under MIT License
════════════════════════════════════════════════════════════════
@version=6
import BlueprintResearch/lib_vsop_core/1 as core
get_helio_lon(t)
Computes Mercury's heliocentric ecliptic longitude using VSOP87 theory.
Parameters:
t (float) : (float) Julian millennia from J2000.0 (use core.get_julian_millennia(time)).
Returns: (float) Heliocentric ecliptic longitude in degrees, normalized to range [0, 360).
get_helio_lat(t)
Computes Mercury's heliocentric ecliptic latitude using VSOP87 theory.
Parameters:
t (float) : (float) Julian millennia from J2000.0 (use core.get_julian_millennia(time)).
Returns: (float) Heliocentric ecliptic latitude in radians, range approximately . Note: Returns radians, not degrees.
get_helio_radius(t)
Computes Mercury's heliocentric radius (distance from Sun) using VSOP87 theory.
Parameters:
t (float) : (float) Julian millennia from J2000.0 (use core.get_julian_millennia(time)).
Returns: (float) Heliocentric radius in astronomical units (AU). Typical range is 0.31-0.47 AU.
get_geo_speed(t)
Computes Mercury's geocentric longitude speed (rate of change over time).
Parameters:
t (float) : (float) Julian millennia from J2000.0 (use core.get_julian_millennia(time)).
Returns: (float) Geocentric longitude speed in degrees per day. Negative values indicate retrograde motion (apparent backward movement).
get_geo_lon(t)
Computes Mercury's geocentric ecliptic longitude (as seen from Earth).
Parameters:
t (float) : (float) Julian millennia from J2000.0 (use core.get_julian_millennia(time)).
Returns: (float) Geocentric ecliptic longitude in degrees, normalized to range [0, 360).
get_geo_ecl_lat(t)
Computes Mercury's geocentric ecliptic latitude (as seen from Earth).
Parameters:
t (float) : (float) Julian millennia from J2000.0 (use core.get_julian_millennia(time)).
Returns: (float) Geocentric ecliptic latitude in degrees, range approximately .
get_geo_decl(t)
Computes Mercury's geocentric equatorial declination (as seen from Earth).
Parameters:
t (float) : (float) Julian millennia from J2000.0 (use core.get_julian_millennia(time)).
Returns: (float) Geocentric equatorial declination in degrees, range where positive is north.
Mercury
Financial Astrology Mercury SpeedMercury speed phases (stationary and retrograde) was closely observed by W. D. Gann in order to determine potential trend changes, in BTCUSD we can see some turning points close to the speed dips (when Mercury speed cross the zero line). However, what looks more interesting is that when the Mercury speed is accelerating the price range of the candles is larger, is the same pattern that we noted with the Moon speed indicator so we can conclude that speed acceleration periods produce more intense effects when Mercury aspects occurs.
Note: The Mercury speed indicator is based on an ephemeris array that covers years 2010 to 2030, prior or after this years the speed is not available, this daily ephemeris are based on UTC time so in order to align properly with the price bars times you should set UTC as your chart timezone.
Financial Astrology Mercury DeclinationSeems that Mercury in extreme declinations above or below 21 tends to produce trend turning points. When the points where the declination reverse from maximum or minimum value are observed, could be noted that in BTCUSD it correlates quite close with trend turning points.
This financial astrology rule needs to be researched in different markets, if you find correlation of this turning points in other instruments, leve us a comment with your observations so we can confirm the significance of this rule. Thanks.
Note: The Mercury declination indicator is based on an ephemeris array that covers years 2010 to 2030, prior or after this years the declination is not available, this daily ephemeris are based on UTC time so in order to align properly with the price bars times you should set UTC as your chart reference timezone.
Financial Astrology Mercury LongitudeMercury energy influence the mind, the intellect and mental temperament, in mundane astrology is well know that rules: news, science, debating, trading, commerce, contracts. telecommunication, short-distance travels, among others. W. D. Gann discovered that the Mercury speed phases (stationary, retrograde, direct) transitions was very relevant as trading signals, he used the Sun conjunction retrograde Mercury to confirm the formation of top and bottoms that seems to be a relevant leading indicator in multiples markets.
As part of the Financial Astrology Research Group experiments, we created hundreds of machine learning models that try to predict daily trend direction for a research portfolio of 10 crypto-currencies and is confirmed that including the Mercury speed and aspects features (variables) in the models increase the accuracy in a consistent manner. Therefore, there is enough evidence that Mercury is one of the most powerful mid term trading cycles.
This is the first open source PIneScript indicator that is able to plot the Mercury Tropical Longitude for the years 2010-2030, we publish as open source in order to support and simplify the research of the amazing astro-traders community at TradingView that have been working manually with annotations and lines to represent the Mercury longitude zodiac signs entries and the speed phases transitions. That manual work is over. Let's move faster in our cycles research!
We encourage all astro traders to continue researching and sharing your ideas of astro cycles trading strategies with us and contribute your experiments at our Github Financial Stats exploration project
so we can improve the cosmic energy models that influence traders behaviours.
Note: The Mercury longitude is based on an ephemeris array that covers years 2010 to 2030, prior or after this years the longitude is not available, this daily ephemeris are based on UTC time so in order to align properly with the price bars times you should set UTC as your chart reference timezone.
Others astro trading indicators from Financial Astrology Research Group:
