Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Chinese → Yearly Forecast

AI-generated

Summary

Generate a detailed yearly Chinese astrology forecast based on birth date, time, and location, using specified interpretive tradition and analysis depth, optionally simplifying the returned data.

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).
  • Location Type (required) — Method to specify birth location: either 'City Name' with automatic coordinate detection or direct 'Coordinates' input.
  • City (required) — Name of the birth city (required if Location Type is 'City Name').
  • Country Code (required) — 2-letter ISO country code for the birth city (required if Location Type is 'City Name').
  • Latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90), positive values indicate North (required if Location Type is 'Coordinates').
  • Longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180), positive values indicate East (required if Location Type is 'Coordinates').
  • Tradition (required) — Interpretive tradition to use for analysis: Classical, Modern, or Simplified.
  • Analysis Depth (required) — Level of detail for the forecast analysis: Basic, Standard, Comprehensive, or Professional.
  • Language (required) — Language code for response text and interpretations (e.g., 'en' for English).
  • Simplify (required) — Flag to return a simplified response containing key data only; if false, the full API response with all metadata is returned.

Output shape

a single JSON object containing the yearly Chinese astrology forecast, including detailed interpretive data according to specified tradition and analysis depth.

The output can be simplified to key data only or include full metadata depending on the 'Simplify' input flag. All input fields are required to accurately compute the forecast for the specified birth details and location.

Examples

Example 1: Forecast for a person born on June 15, 1990, at 14:30 in London, UK, using Classical tradition with standard analysis depth in English and simplified output.

Year=1990, Month=6, Day=15, Hour=14, Minute=30, LocationType=city, City='London', CountryCode='GB', Tradition='classical', AnalysisDepth='standard', Language='en', Simplify=true.

Links

Discussion