Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Chart → Natal Chart

AI-generated

Summary

Generate a detailed natal chart by providing birth date, time, and location information, along with customization options for house system, zodiac type, active celestial points, perspective, and advanced features such as fixed stars analysis. Returns the natal chart data, optionally simplified, suitable for astrological insights and reports.

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).
  • Minute (required) — Birth minute (0-59).
  • Second — Birth second (0-59) for extra precision.
  • Location Type (required) — Choose to specify birth location by city name (auto-detects coordinates) or exact geographic latitude/longitude.
  • City (required) — Birth city name (e.g., "London", "New York") if Location Type is 'City Name'.
  • Country Code (required) — 2-letter ISO country code for the birth city if Location Type is 'City Name'.
  • Latitude (required) — Geographic latitude in decimal degrees (-90 to 90, positive for North) if Location Type is 'Coordinates'.
  • Longitude (required) — Geographic longitude in decimal degrees (-180 to 180, positive for East) if Location Type is 'Coordinates'.
  • House System (required) — House calculation system to use for the chart, e.g., Placidus (default), Whole Sign, Koch, Equal Ascendant, etc.
  • Zodiac Type (required) — Zodiac calculation method: Tropical (Western, season-based) or Sidereal (Vedic, star-based).
  • Active Points (required) — Predefined set of celestial points to include (Basic, Modern, Traditional, Full) or select custom points manually.
  • Custom Active Points — Specific celestial points to include when the Active Points preset is set to Custom.
  • Perspective (required) — Reference point for calculations: Geocentric (Earth-centered), Heliocentric (Sun-centered), Draconic, or Barycentric.
  • Precision (required) — Decimal precision (0-8) for degree calculations in the chart.
  • Simplify (required) — Whether to simplify the response to key data only or return the full detailed API response.
  • Include Fixed Stars Analysis — Toggle to include fixed star positions and aspects in the chart analysis.
  • Fixed Star Presets — Preset groups of fixed stars to include when fixed stars analysis is enabled, e.g., Essential, Traditional.
  • Include Parans — Toggle to include paran calculations (stars co-rising, co-culminating, co-setting).
  • Include Heliacal — Toggle to include heliacal rising/setting phenomena in the chart.
  • Use Cache (required) — Whether to utilize cached calculations when available for faster responses.

Output shape

a data object containing the natal chart details as returned by the astrology API

The response includes detailed celestial positions, aspects, and house placements according to the specified parameters. Enabling 'Simplify' reduces the response to key information only. Advanced options like fixed stars, parans, and heliacal phenomena are optional and add detail if enabled.

Examples

Example 1: Create a natal chart for a subject born 1990-06-15 at 14:30:00 in New York, using tropical zodiac and Placidus houses with modern active points preset.

Set Year=1990, Month=6, Day=15, Hour=14, Minute=30, Second=0, Location Type=City, City='New York', Country Code='US', Zodiac Type='Tropic', House System='P', Active Points='modern', Simplify=true

Links

Discussion