Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Insights → Wellness: Timing

AI-generated

Summary

Generate wellness timing insights based on planetary transits over a specified date range for the given birth data, focusing on selected wellness areas (diet, exercise, mental health, sleep, stress).

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-23, where 0=midnight, 12=noon)
  • Minute (required) — Birth minute (0-59)
  • 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', 'Kyiv') (shown when Location Type is 'City Name')
  • Country Code (required) — 2-letter ISO country code for the birth city (e.g., US, GB, UA, DE, FR) (shown when Location Type is 'City Name')
  • Latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North) (shown when Location Type is 'Coordinates')
  • Longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East) (shown when Location Type is 'Coordinates')
  • Wellness Focus — Areas of wellness to focus on (options: Diet, Exercise, Mental Health, Sleep, Stress; default: ['exercise', 'sleep'])
  • Start Date (required) — Start date for transit analysis period (YYYY-MM-DD format)
  • End Date (required) — End date for transit analysis period (YYYY-MM-DD format)
  • Language — Language for response text and interpretations (options: en, ru, de, es, fr, it, pt, zh, ja, ko; default: en)
  • Simplify — Whether to return simplified response with key data only. Disable for full API response with all metadata. (default: true)

Output shape

Returns wellness timing insights data for the specified date range, typically including daily or period-based assessments of planetary transits affecting the selected wellness aspects. The exact structure depends on the API response and the 'simplify' setting.

When 'simplify' is enabled (default), the response contains only key insights. When disabled, the full API response with all metadata is returned.

Examples

Example 1: Get wellness timing insights for exercise and sleep from January 1 to December 31, 2024 for a person born on July 15, 1990 at 14:30 in London, GB.

Set Year=1990, Month=7, Day=15, Hour=14, Minute=30, Location Type=City Name, City=London, Country Code=GB, Wellness Focus=['exercise','sleep'], Start Date=2024-01-01, End Date=2024-12-31

Links

Discussion