Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Fixed Stars → Positions

AI-generated

Summary

Calculate the positions of selected fixed stars at a specified birth date and location, optionally including interpretations and managing the response detail level.

Inputs

  • subjectName (required) — Full name used for numerology calculations associated with the subject.
  • year (required) — Birth year in four-digit format (e.g., 1990).
  • month (required) — Birth month as a number from 1 to 12 (January=1, December=12).
  • 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).
  • locationType (required) — Specifies how the birth location is set: either by city name with country code or exact geographic coordinates.
  • city (required) — Name of the birth city used when locationType is set to 'City Name'.
  • countryCode (required) — Two-letter ISO country code for the birth city when locationType is 'City Name'.
  • latitude (required) — Latitude in decimal degrees (-90 to 90) used when locationType is 'Coordinates'.
  • longitude (required) — Longitude in decimal degrees (-180 to 180) used when locationType is 'Coordinates'.
  • starPresets (required) — One or more predefined fixed star sets to include in the calculation, such as Essential (10 stars) or Extended (20+ stars).
  • includeStarInterpretations — Flag to include textual interpretations of the fixed stars' placements.
  • simplify — Flag to return a simplified response containing key data only, omitting extensive metadata.

Output shape

a JSON object with data on fixed star positions relevant to the subject's birth data and location, including optional interpretations

The output can be simplified or detailed based on the 'simplify' parameter. The data reflects selected star groups and includes birth date/time and location context required for astrological calculations.

Examples

Example 1: Retrieve fixed star positions for a subject born on January 15, 1990 at noon in London, GB, including essential stars and their interpretations with simplified output.

subjectName=John Doe, year=1990, month=1, day=15, hour=12, minute=0, locationType=city, city=London, countryCode=GB, starPresets=[essential], includeStarInterpretations=true, simplify=true

Links

Discussion