Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Ziwei → Chart

AI-generated

Summary

Generate Ziwei Dou Shu natal chart reading from birth data

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 — 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)
  • countryCode (required) — 2-letter ISO country code for the birth city (e.g., US, GB, UA, DE, FR)
  • latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North)
  • longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East)
  • gender (required) — Gender is required for luck pillar calculations in Chinese astrology
  • language — Language for response text and interpretations
  • simplify — Whether to return simplified response with key data only. Disable for full API response with all metadata.

Output shape

Ziwei Dou Shu chart reading with palace layout, star numbers, and luck pillar interpretations. When simplify is true, response contains key data only; otherwise includes full API response with all metadata. Language of text and interpretations matched to language parameter.

Consumes exact birth datetime (year, month, day, hour, minute) and location (city with country code, or latitude/longitude). Gender required for luck pillar calculations. Language optional, defaults to English. Simplify flag controls response granularity.

Examples

Example 1: Full natal Ziwei chart with simplified output

subjectName: John Doe; year: 1990; month: 6; day: 15; hour: 14; minute: 30; locationType: city; city: London; countryCode: GB; gender: male; language: en; simplify: true

Links

Discussion