Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Chart → Transit Chart

AI-generated

Summary

Generate a transit astrology chart overlaying a natal chart using specified birth data and a target transit date/time and location, optionally customizing chart options including house system, zodiac type, and celestial points.

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 a number from 1 (January) to 12 (December).
  • Day (required) — Birth day of the month (1-31).
  • Hour (required) — Birth hour in 24-hour format (0-23, where 0=midnight).
  • 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 (automatically detects coordinates) or by exact latitude/longitude.
  • City (required) — Birth city name if Location Type is 'City Name'.
  • Country Code (required) — 2-letter ISO country code for birth city if Location Type is 'City Name'.
  • Latitude (required) — Latitude for birth location (-90 to 90) if Location Type is 'Coordinates'.
  • Longitude (required) — Longitude for birth location (-180 to 180) if Location Type is 'Coordinates'.
  • Transit Year (required) — Year for the transit calculation.
  • Transit Month (required) — Month for the transit calculation (1-12).
  • Transit Day (required) — Day for the transit calculation (1-31).
  • Transit Hour (required) — Hour for the transit calculation in 24-hour format (0-23).
  • Transit Minute (required) — Minute for the transit calculation (0-59).
  • Transit Location Type (required) — How to specify the location for transit time: by city name or exact latitude/longitude.
  • Transit City (required) — City for the transit calculation if Transit Location Type is 'City Name'.
  • Transit Country Code (required) — 2-letter ISO country code for transit location if Transit Location Type is 'City Name'.
  • Transit Latitude (required) — Latitude of transit location (-90 to 90) if Transit Location Type is 'Coordinates'.
  • Transit Longitude (required) — Longitude of transit location (-180 to 180) if Transit Location Type is 'Coordinates'.
  • House System (required) — House calculation system to use (e.g., Placidus, Whole Sign, Koch, Equal, etc.).
  • Zodiac Type (required) — Zodiac calculation method: Tropical (Western) or Sidereal (Vedic).
  • Active Points (required) — Preset or custom selection of celestial points to include in the chart.
  • Custom Active Points — Specific celestial points to include when 'Custom' is selected as Active Points preset.
  • Perspective (required) — Reference point for calculating positions (Geocentric, Heliocentric, Draconic, Barycentric).
  • Precision (required) — Decimal precision for degree calculations (0-8).
  • Simplify (required) — Whether to return a simplified response containing only key data or the full API response with all metadata.
  • Advanced Options (required) — Whether to enable advanced options like fixed stars and caching.
  • Include Fixed Stars Analysis — Whether to include fixed star positions and aspects in the chart.
  • Fixed Star Presets — Groups of fixed stars to include if 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.
  • Use Cache (required) — Whether to use cached calculations when available.

Output shape

a JSON object representing the transit chart data overlaying the natal positions with optional fixed star details and other selected analysis, including planetary positions, aspects, houses, and additional metadata if simplification is disabled.

The output contains detailed astrological data for the transit chart. When 'Simplify' is enabled, only key fields are returned for easier handling. The response includes natal birth data combined with transit datetime and location, computed using the specified house system, zodiac type, active points, and perspective. Fixed stars and paran data are optionally included if enabled in advanced options.

Examples

Example 1: A workflow that generates a transit chart for a user's birth data for June 15, 2024 at noon in New York City, using Placidus house system and Tropical zodiac, returning simplified results with the modern active points preset.

Set birth date/time and location fields, set transit date/time and location fields, choose Placidus house system, Tropical zodiac, modern active points, enable simplify, leave advanced options disabled.

Links

Discussion