Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Chinese → Luck Pillars

AI-generated

Summary

Calculate the Chinese astrology Luck Pillars based on precise birth data and location to obtain detailed predictions of sequential 10-year luck periods.

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) — Method to specify birth location: 'City Name' with auto-detected coordinates or exact 'Coordinates'.
  • city (required) — Birth city name, needed when 'City Name' location type is chosen (e.g., "London").
  • countryCode (required) — Two-letter ISO country code for the birth city (e.g., US, GB). Required with city location type.
  • latitude (required) — Geographic latitude in decimal degrees (-90 to 90, positive=North). Required when coordinates location type is selected.
  • longitude (required) — Geographic longitude in decimal degrees (-180 to 180, positive=East). Required when coordinates location type is selected.
  • gender (required) — Gender of the individual ('female' or 'male'), required for luck pillar calculations in Chinese astrology.
  • language — Language code for response texts and interpretations (default 'en' for English).
  • simplify — Option to return a simplified response with key data only (default true); disable to receive the full API response with all metadata.

Output shape

a JSON object containing calculated Luck Pillars data for the given birth details, including successive 10-year luck cycles with Chinese astrological interpretation and timing details.

The response's verbosity depends on the 'simplify' parameter: when true, only essential data is returned; otherwise, full metadata and detailed interpretations are included. Accurate birth time and location inputs are essential for precise calculations.

Links

Discussion