Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Chart → Solar Return Transits

AI-generated

Summary

Calculate transits to a specified solar return chart over a given date range, identifying planetary aspects within a defined orb using detailed birth data and optional relocated return location.

Inputs

  • Subject Name — Optional name for the chart subject (used in report titles).
  • Year (required) — Birth year in 4-digit format.
  • Month (required) — Birth month as number 1-12.
  • Day (required) — Birth day of month (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.
  • Location Type (required) — Specify birth location either by city name (auto-detected coordinates) or exact latitude/longitude.
  • City (required) — Birth city name (if Location Type is city).
  • Country Code (required) — 2-letter ISO country code for birth city (if Location Type is city).
  • Latitude (required) — Latitude of birth location in decimal degrees if Location Type is coordinates.
  • Longitude (required) — Longitude of birth location in decimal degrees if Location Type is coordinates.
  • Return Year (required) — Year for the solar return chart (the birthday year to analyze).
  • Use Relocated Location (required) — Whether to calculate the solar return from a relocated birth place (relocation astrology).
  • Return Location Type (required) — How to specify relocated return location: city or coordinates (shown only if Use Relocated Location is true).
  • Return City (required) — City name of relocated location (if Return Location Type is city).
  • Return Country Code (required) — 2-letter ISO country code for relocated city (if Return Location Type is city).
  • Return Latitude (required) — Latitude of relocated return location (if Return Location Type is coordinates).
  • Return Longitude (required) — Longitude of relocated return location (if Return Location Type is coordinates).
  • Start Date (required) — Start date of transit analysis period (YYYY-MM-DD).
  • End Date (required) — End date of transit analysis period (YYYY-MM-DD).
  • Orb (Degrees) (required) — Maximum orb in degrees to consider for transit aspect exactness.
  • House System (required) — House calculation system to use for the chart.
  • Zodiac Type (required) — Zodiac calculation method: Tropical or Sidereal.
  • Active Points (required) — Predefined or custom set of celestial points to include in the chart.
  • Custom Active Points — Specific celestial points selected when Active Points preset is 'custom'.
  • Perspective (required) — Reference point for celestial position calculations (e.g., geocentric).
  • Precision (required) — Decimal precision for degree calculations (0-8).
  • Simplify (required) — Whether to return a simplified response with key data only.
  • Advanced Options (required) — Toggle to show advanced chart options like fixed stars and caching.
  • Include Fixed Stars Analysis (required) — Whether to include fixed stars in the chart calculations.
  • Fixed Star Presets (required) — Groups of fixed stars to include when fixed stars analysis is enabled.
  • Include Parans (required) — Whether to include paran calculations (co-rising/culminating/setting stars).
  • Include Heliacal (required) — Whether to include heliacal rising and setting phenomena.
  • Use Cache (required) — Whether to use cached calculations if available.

Output shape

a detailed transit analysis report object or a simplified version based on user preference

The output includes transit aspects between solar return planets over the specified date range filtered by orb. It supports advanced astrological options including fixed stars, parans, and heliacal phenomena. Response can be simplified to key data or provide full metadata.

Examples

Example 1: User provides birth data, selects a return year to generate the solar return chart, specifies a date range for transit analysis, and sets orb and chart options.

Birth data with datetime and location (city or coordinates), return year 2024, date range from 2024-01-01 to 2024-12-31, orb 1 degree, house system Placidus, tropical zodiac, modern active points, geocentric perspective, precision 2 decimals, simplified output enabled.

Links

Discussion