Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Chart → Synastry Chart

AI-generated

Summary

Generate a Synastry Chart comparing the astrological birth details of two individuals to analyze their relationship dynamics.

Inputs

  • Subject Name — Optional name for the first person, used in report titles.
  • Year (required) — Birth year of the first person in 4-digit format, e.g., 1990.
  • Month (required) — Birth month of the first person as a number from 1 (January) to 12 (December).
  • Day (required) — Birth day of the month for the first person (1-31).
  • Hour (required) — Birth hour of the first person in 24-hour format (0-23).
  • Minute (required) — Birth minute of the first person (0-59).
  • Second — Optional birth second of the first person (0-59) for extra precision.
  • Location Type (required) — How the first person's birth location is specified: city name (with country) or exact coordinates.
  • City (required) — Birth city name of the first person when Location Type is 'City Name'.
  • Country Code (required) — Two-letter ISO country code for the first person's birth city.
  • Latitude (required) — Latitude in decimal degrees (-90 to 90) for the first person's birth location when Location Type is 'Coordinates'.
  • Longitude (required) — Longitude in decimal degrees (-180 to 180) for the first person's birth location when Location Type is 'Coordinates'.
  • Name (Subject 2) — Optional name of the second person, used in report titles.
  • Year (Subject 2) (required) — Birth year of the second person in 4-digit format.
  • Month (Subject 2) (required) — Birth month of the second person as a number (1-12).
  • Day (Subject 2) (required) — Birth day of the second person (1-31).
  • Hour (Subject 2) (required) — Birth hour of the second person in 24-hour format (0-23).
  • Minute (Subject 2) (required) — Birth minute of the second person (0-59).
  • Location Type (Subject 2) (required) — How the second person's birth location is specified: city name (with country) or exact coordinates.
  • City (Subject 2) (required) — Birth city of the second person when Location Type is 'City Name'.
  • Country Code (Subject 2) (required) — Two-letter ISO country code for the second person's birth city.
  • Latitude (Subject 2) (required) — Latitude of the second person's birth location in decimal degrees (-90 to 90) when Location Type is 'Coordinates'.
  • Longitude (Subject 2) (required) — Longitude of the second person's birth location in decimal degrees (-180 to 180) when Location Type is 'Coordinates'.
  • House System (required) — House calculation system to use for the chart, e.g., Placidus, Whole Sign, Koch, Equal, etc.
  • Zodiac Type (required) — Zodiac calculation method: Tropical (Western) or Sidereal (Vedic).
  • Active Points (required) — Predefined set or custom selection of celestial points (planets, asteroids, fixed stars) to include in the chart.
  • Custom Active Points — If Active Points is 'Custom', manually select specific celestial points included in the chart.
  • Perspective (required) — Reference point for calculating positions: Geocentric, Heliocentric, Draconic, or Barycentric.
  • Precision (required) — Decimal precision (0-8) for degree calculations.
  • Simplify (required) — Toggle to return a simplified response with key data only or full API response including metadata.
  • Advanced Options (required) — Toggle to reveal advanced options such as fixed stars and caching.
  • Include Fixed Stars Analysis — Whether to include fixed star positions and aspects in the chart analysis.
  • Fixed Star Presets — Select groups of fixed stars to include if fixed stars analysis is enabled.
  • Include Parans — Include paran calculations for stars co-rising, co-culminating, or co-setting.
  • Include Heliacal — Include heliacal rising and setting phenomena in the chart.
  • Use Cache (required) — Whether to use cached calculations when available for performance.

Output shape

A single astrological synastry chart object comparing two individuals' birth data.

The response includes detailed astrological data based on specified celestial points, house system, zodiac type, and perspective. The output may be simplified depending on the 'Simplify' input parameter; otherwise, it contains full metadata including fixed stars and paran details if enabled.

Examples

Example 1: User provides birth data for two people including dates, times, and locations. Sets advanced options to include fixed stars and uses the Tropical zodiac. The node returns a synastry chart object analyzing their relationship.

Subject1: Name (optional), complete birth date and time, city or coordinates location; Subject2: same data fields. Chart options including house system Placidus, zodiac type Tropical, active points preset Modern (12 Points), geocentric perspective, 2 decimal precision. Simplify enabled true to reduce verbosity.

Links

Discussion