Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Chart → Solar Return Chart

AI-generated

Summary

Calculate a Solar Return Chart to forecast the planetary positions and astrological influences for a specific birthday year based on the subject's natal 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, January=1).
  • Day (required) — Birth day of the 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) — How to specify birth location: by city name (auto-detect coordinates) or exact latitude/longitude.
  • City (required) — Birth city name when location type is city.
  • Country Code (required) — 2-letter ISO country code for birth city when location type is city.
  • Latitude (required) — Latitude in decimal degrees (-90 to 90) when location type is coordinates.
  • Longitude (required) — Longitude in decimal degrees (-180 to 180) when location type is coordinates.
  • Return Year (required) — Year of the birthday to analyze for the solar return chart.
  • Use Relocated Location — Whether to calculate the solar return chart for a location other than the birth place (relocation astrology).
  • Return Location Type (required) — How to specify the relocated return location: city name or coordinates (shown only if relocation is used).
  • Return City (required) — City name where the subject will be on their birthday (for relocated return).
  • Return Country Code (required) — 2-letter ISO country code for the return city (relocated location).
  • Return Latitude (required) — Latitude for relocated return location (decimal degrees, -90 to 90).
  • Return Longitude (required) — Longitude for relocated return location (decimal degrees, -180 to 180).
  • House System (required) — House calculation system (e.g., Placidus, Whole Sign, Koch, Equal, etc.).
  • Zodiac Type (required) — Zodiac calculation method: Tropical (Western, season-based) or Sidereal (Vedic, star-based).
  • Active Points (required) — Predefined set or custom selection of celestial points to include in the chart (e.g. basic planets, traditional points, fixed stars).
  • Custom Active Points — Specific celestial points manually selected when using a custom active points preset.
  • Perspective (required) — Reference point for calculating positions: geocentric, heliocentric, draconic, or barycentric.
  • Precision (required) — Decimal precision for degree calculations (0-8).
  • Simplify (required) — Whether to return a simplified response with key data only or the full detailed API response.
  • Include Fixed Stars Analysis — Whether to include analysis of fixed star positions and aspects (advanced option).
  • Fixed Star Presets — Preset groups of fixed stars to include when fixed stars analysis is enabled.
  • Include Parans — Whether to include paran calculations (stars co-rising, co-culminating, co-setting).
  • Include Heliacal — Whether to include heliacal rising/setting phenomena for fixed stars analysis.
  • Use Cache (required) — Whether to use cached calculations when available to improve performance.

Output shape

The operation returns structured data representing the calculated Solar Return Chart, including planetary positions, houses, aspects, and optionally fixed stars and parans analysis.

The response can be simplified to include only key data fields or provide the full detailed API response with all metadata depending on the 'Simplify' input. When relocation is enabled, the chart is calculated for the specified return location, otherwise for the natal birth location.

Links

Discussion