AstrologyInstall

Summary

Calculate natal transit astrological data for a specified birth chart subject over a given date range, providing insights into planetary transits affecting the natal chart during that period.

Inputs

• Subject Name — Optional name for the chart subject, used in report titles.
• Year (required) — Birth year in 4-digit format (e.g., 1990).
• Month (required) — Birth month as number 1-12 (January=1, December=12).
• Day (required) — Birth day of the month (1-31).
• Hour (required) — Birth hour in 24-hour format (0-23, where 0=midnight, 12=noon).
• Minute (required) — Birth minute (0-59).
• Second — Birth second (0-59) for extra precision.
• Location Type (required) — Choose how to specify birth location: by city name (auto-detects coordinates) or exact latitude/longitude.
• City (required) — Birth city name (e.g., "London", "New York") if Location Type is City Name.
• Country Code (required) — Two-letter ISO country code for the birth city if Location Type is City Name.
• Latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North) if Location Type is Coordinates.
• Longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East) if Location Type is Coordinates.
• Start Date (required) — Start date for transit analysis period in YYYY-MM-DD format.
• End Date (required) — End date for transit analysis period in YYYY-MM-DD format.
• House System — House calculation system to use (e.g., Placidus, Whole Sign). Default is Placidus.
• Zodiac Type — Zodiac calculation method: Tropical (Western) or Sidereal (Vedic). Default is Tropical.
• Active Points — Preset set of celestial bodies to include in the chart (e.g., Basic, Modern, Full, or Custom selection).
• Custom Active Points — Specific celestial points to include when Active Points preset is Custom.
• Perspective — Reference point for calculating positions: Geocentric (Earth-centered), Heliocentric (Sun-centered), Draconic, or Barycentric. Default is Geocentric.
• Precision — Decimal precision for degree calculations (0-8). Default is 2.
• Simplify — Whether to return a simplified response with key data only (default true). Disable to get full API response with all metadata.
• Advanced Options — Show advanced options such as including fixed stars and caching.
• Include Fixed Stars Analysis — Whether to include fixed star positions and aspects in the chart.
• Fixed Star Presets — Preset groups of fixed stars to include when fixed stars analysis is enabled (e.g., Essential, Traditional).
• Include Parans — Whether to include paran calculations (stars co-rising, co-culminating, co-setting).
• Include Heliacal — Whether to include heliacal rising/setting phenomena.
• Use Cache — Whether to use cached calculations when available (default true).

Output shape

a JSON object containing transit analysis data for the natal chart over the specified date range

Output includes detailed astrological transit information based on the birth data and selected options; enabling Simplify returns a concise summary with key fields, while disabling it returns full API metadata.

Examples

Example 1: Analyze the natal transits for a subject born on 1990-01-15 at 14:30 in London, GB, from 2024-01-01 to 2024-12-31 using the Placidus house system and Tropical zodiac, including modern active points and fixed stars analysis.

Input birth date/time and location, set date range for transit analysis, choose chart options and celestial points, then execute to receive transit period data.

Links

• n8n community nodes installation guide