Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Traditional → Annual Profection

AI-generated

Summary

Calculate the annual profection (a traditional astrological technique) for the given birth date, time, location, and current age. Requires year, month, day, hour, minute; location (city/country or coordinates); and current age. Optionally simplify the response.

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)
  • 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') - required when locationType is 'city'
  • countryCode (required) — 2-letter ISO country code for the birth city (e.g., US, GB, UA, DE, FR) - required when locationType is 'city'
  • latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North) - required when locationType is 'coordinates'
  • longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East) - required when locationType is 'coordinates'
  • currentAge (required) — Current age for profection calculations
  • simplify — Whether to return simplified response with key data only. Disable for full API response with all metadata.

Output shape

Returns annual profection data from the astrology API. If simplify is true, returns only key data (top-level fields up to 10); otherwise returns full API response.

Exact response structure depends on the API but typically includes profection sign, house, and related interpretations.

Examples

Example 1: Calculate annual profection for age 25

Set birth date (e.g., 1990-06-15 14:30), location (e.g., London, GB), currentAge=25

Links

Discussion