Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Fixed Stars → Conjunctions

AI-generated

Summary

Calculate conjunction and opposition aspects between natal positions and fixed stars based on provided birth data and selected star presets.

Inputs

  • subjectName (required) — Full name for numerology calculations (required for name-based numbers).
  • 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 if Location Type is 'City Name'.
  • countryCode (required) — 2-letter ISO country code for the birth city (e.g., US, GB, UA, DE, FR); required if Location Type is 'City Name'.
  • latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North); required if Location Type is 'Coordinates'.
  • longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East); required if Location Type is 'Coordinates'.
  • starPresets — Select star preset groups to include in conjunction analysis, such as Essential (10 stars), Traditional (13 stars), Behenian (15 stars), and Extended (20+ stars). Defaults to Essential.
  • conjunctionOrb — Maximum orb in degrees for conjunction aspects (0.5-5.0). Default is 2 degrees.
  • oppositionOrb — Maximum orb in degrees for opposition aspects (0.5-3.0). Default is 1.5 degrees.
  • includeStarInterpretations — Toggle to include interpretations for star placements in the response. Defaults to true.
  • simplify — Whether to return a simplified response with key data only. Defaults to true; disable to receive full API response with all metadata.

Output shape

a JSON object containing fixed star conjunctions and oppositions with respect to the natal chart computed from the provided birth data and location.

Output includes aspects within user-defined orbs for conjunction and opposition, filtered by chosen fixed star presets. If 'includeStarInterpretations' is enabled, characteristic interpretations for the fixed stars are included. Setting 'simplify' to true returns a reduced dataset focusing on essential details; otherwise full metadata is returned.

Links

Discussion