AstrologyInstall

Summary

Analyzes a traditional natal chart using birth datetime and location parameters, returning aspects, dignities, and optional asteroid/fixed star positions with configurable orb and output simplification.

Inputs

• 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 month (1-31)
• hour (required) — Birth hour in 24-hour format (0=midnight, 12=noon)
• minute (required) — Birth minute (0-59)
• locationType (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', 'Kyiv')
• countryCode (required) — 2-letter ISO country code for the birth city (e.g., US, GB, UA, DE, FR)
• latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North)
• longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East)
• includeAsteroids — Whether to include asteroid positions in the analysis
• includeFixedStars — Whether to include fixed star analysis
• majorAspectsOrb — Orb in degrees for major aspects (0.5-10)
• simplify — Whether to return simplified response with key data only. Disable for full API response with all metadata.

Output shape

API response containing traditional natal chart analysis data. When simplify is true, returns top-level key data only; when false, returns full metadata with all specified positions and interpretations including aspects, dignities, and optionally asteroid and fixed star positions.

All birth datetime parameters (year, month, day, hour, minute) are required. Location specification depends on locationType: city and countryCode are required for city mode; latitude and longitude are required for coordinates mode. includeAsteroids and includeFixedStars toggle extra positional data. majorAspectsOrb controls the orb degree threshold for aspect detection.

Examples

Example 1: Basic natal analysis with simplified output

year=1990, month=6, day=15, hour=14, minute=30, locationType=city, city='London', countryCode='GB', simplify=true

Example 2: Full detailed analysis with coordinates and asteroids

year=1990, month=6, day=15, hour=14, minute=30, locationType=coordinates, latitude=50.45, longitude=30.52, includeAsteroids=true, includeFixedStars=false, majorAspectsOrb=2, simplify=false

Links

• n8n community nodes installation guide