Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Chinese → BaZi (Four Pillars)

AI-generated

Summary

Calculate a BaZi (Four Pillars) astrological profile for a person based on their complete birth date and time with geographic location, using Chinese astrology principles.

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' to enter city name and country code or 'coordinates' to enter exact latitude and longitude.
  • city (required) — Birth city name (required if locationType is 'city').
  • countryCode (required) — 2-letter ISO country code for the birth city (required if locationType is 'city').
  • latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North) (required if locationType is 'coordinates').
  • longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East) (required if locationType is 'coordinates').
  • gender — Gender required for calculations involving luck pillars ('male' or 'female').
  • includeLuckPillars — Whether to include 10-year luck period analysis (requires gender).
  • includeAnnualPillars — Whether to include yearly analysis within luck periods.
  • chineseTradition — Select interpretation tradition: 'classical', 'modern', or 'simplified'. Defaults to 'classical'.
  • analysisDepth — Level of detail in the analysis, options: 'basic', 'standard' (default), 'comprehensive', 'professional'.
  • language — Language for response text and interpretations, e.g., 'en' for English (default).
  • simplify — Whether to return a simplified response with key data only (default true). Disable to receive full API response with all metadata.

Output shape

A JSON object representing the BaZi analysis report, including the Four Pillars derived from the birth date and time, and optionally luck pillars and annual pillars analyses. The content and detail depend on chosen options.

The output may be either simplified to main fields or include comprehensive metadata based on the 'simplify' input. Including luck pillars requires specifying the gender. Language and interpretation tradition affect textual descriptions. The analysis depth controls how detailed the report is.

Examples

Example 1: Generate a basic BaZi profile for a birth on June 15, 1990, at 14:30 in London, UK, with city-based location input, using classical tradition and English language, without luck or annual pillars.

year=1990, month=6, day=15, hour=14, minute=30, locationType='city', city='London', countryCode='GB', includeLuckPillars=false, includeAnnualPillars=false, chineseTradition='classical', language='en', simplify=true

Links

Discussion