Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Chart → Lunar Return Transits

AI-generated

Summary

Generate a list of astrological transits occurring to the lunar return chart of a subject within a specified date range, based on their birth data and optional lunar return date, using configurable chart options like house system, zodiac type, and active points.

Inputs

  • Subject Name — Optional name of the individual whose lunar return transits are being analyzed, used in report titles.
  • Year (required) — Birth year of the subject in four-digit format (e.g., 1990).
  • Month (required) — Birth month of the subject as a number from 1 (January) to 12 (December).
  • Day (required) — Birth day of the month for the subject (1-31).
  • Hour (required) — Birth hour in 24-hour format (0-23).
  • Minute (required) — Birth minute (0-59).
  • Second — Birth second (0-59) for extra precision, optional.
  • Location Type (required) — Method to specify birth location: by city name (which auto-detects coordinates) or by exact latitude and longitude coordinates.
  • City (required) — Birth city name; required if Location Type is 'City Name'.
  • Country Code (required) — Two-letter ISO country code for the birth city; required if Location Type is 'City Name'.
  • Latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90), required if Location Type is 'Coordinates'.
  • Longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180), required if Location Type is 'Coordinates'.
  • Return Date — Target date for the lunar return chart in YYYY-MM-DD format; if left empty, the current or next lunar return date is used.
  • Start Date (required) — Start date for the transit analysis period in YYYY-MM-DD format.
  • End Date (required) — End date for the transit analysis period in YYYY-MM-DD format.
  • Orb (Degrees) (required) — Maximum allowable orb in degrees for the aspects when finding transits; smaller values yield fewer but more precise transits.
  • House System (required) — Astrological house calculation system to use (e.g., Placidus, Whole Sign).
  • Zodiac Type (required) — Zodiac calculation method: Tropical (Western, season-based) or Sidereal (Vedic, star-based).
  • Active Points (required) — Predefined or custom selection of celestial points (planets, angles, asteroids, fixed stars) to include in the chart for transit calculations.
  • Custom Active Points (required) — If 'Custom' is selected for Active Points, specify which points to include.
  • Perspective (required) — Reference point for calculation: Geocentric (Earth-centered), Heliocentric, Draconic, or Barycentric.
  • Precision (required) — Decimal precision for degree calculations, from 0 to 8.
  • Simplify (required) — Whether to return a simplified response containing only key data or the full detailed API response.
  • Advanced Options (required) — Toggle to show advanced options such as including fixed stars and caching.
  • Include Fixed Stars Analysis (required) — Whether to include fixed star positions and aspects in the lunar return transit chart.
  • Fixed Star Presets (required) — Preset groups of fixed stars to include when fixed stars analysis is enabled.
  • Include Parans (required) — Whether to include paran calculations (stars co-rising, co-culminating, co-setting).
  • Include Heliacal (required) — Whether to include heliacal rising and setting phenomena.
  • Use Cache (required) — Whether to use cached calculations if available to improve performance.

Output shape

a structured object containing detailed information about the transits to the lunar return chart within the specified date range

The output includes transit aspects found within the date range to the lunar return chart based on provided birth and return date data; the response may be simplified or detailed depending on the 'Simplify' input setting.

Examples

Example 1: Calculate lunar return transits for a person born in London on June 15, 1990 to assess astrological influences from 2024-01-01 to 2024-12-31.

Provide birth data (1990-06-15 12:00, London, GB), optional subject name, specify an orb (e.g., 1°), choose a house system (e.g., Placidus), zodiac type (e.g., Tropical), select active points preset (e.g., Modern), set date range for transit analysis (2024-01-01 to 2024-12-31), optionally specify a lunar return date or leave blank for next lunar return, decide on simplification and advanced options like fixed stars and caching.

Links

Discussion