Venus Cycle Suite
Venus Star Points (VSP), stations, elongations, visibility phases, and the 8-year pentagram pattern.
Overview
The Venus Cycle Suite provides high-precision timing and metadata for Venus’ synodic cycle.
POST /ephemeris/venus-star-points
Compute the Venus Star Point cycle for a natal subject (the 5 conjunctions that define the birth star).
Request
{
"subject": {
"name": "Example Subject",
"birth_datetime": { "iso": "1990-06-15T14:30:00Z" },
"birth_location": {
"latitude": { "decimal": 40.7128 },
"longitude": { "decimal": -74.006 },
"timezone": { "iana_name": "America/New_York" }
}
}
}
Notes
- Conjunction events include
visibility(morning_star|evening_star) for correct UI labeling.
POST /ephemeris/venus-star-points/conjunctions
List Venus–Sun conjunction events within a date range.
Example
POST /ephemeris/venus-star-points/conjunctions
{ "start_date": "2026-01-01", "end_date": "2026-12-31" }
POST /ephemeris/venus-star-points/eight-year-star
Return the 5 vertices of the Venus 8-year star (pentagram) at a given moment.
Example
POST /ephemeris/venus-star-points/eight-year-star
{ "date": "2026-01-29" }
POST /ephemeris/venus-star-points/stations
Return exact degree + timestamp when Venus stations retrograde/direct.
{ "start_date": "2026-01-01", "end_date": "2026-12-31" }
POST /ephemeris/venus-star-points/elongations
Return Venus greatest elongation events (visibility and brightness inflection points).
{ "start_date": "2026-01-01", "end_date": "2026-12-31" }
POST /ephemeris/venus-star-points/phase
Return illumination and visibility metadata (including combust and under_beams flags).
Example
POST /ephemeris/venus-star-points/phase
{ "date": "2026-01-29" }