Chinese Horoscope

Calculate Chinese zodiac signs and yearly forecasts based on a person's birth date.

---

Chinese Zodiac Sign

Calculate a person's Chinese zodiac sign and element based on their birth year.

Required Module

Requires the chinese-horoscope:calc module.

curl -X POST "https://api.astroapi.cloud/api/calc/chinese-horoscope" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15",
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

Parameters

Parameter	Type	Required	Description
birthDate	string	Yes	Birth date in YYYY-MM-DD format
language	string	No	Language code for text content (default: "en")
includeText	boolean	No	Include interpretation text (default: false)
includeReadableEntities	boolean	No	Include human-readable titles for sign and element (default: false)

Response

{
    "data": {
        "sign": "horse",
        "element": "metal",
        "year": 1990,
        "signTitle": "Horse",
        "elementTitle": "Metal",
        "text": "People born in the Year of the Horse are energetic, active, and enjoy being in a crowd. They are quick to learn and love adventure..."
    }
}

Response Fields

Field	Type	Description
sign	string	Chinese zodiac animal sign
element	string	Associated element (wood, fire, earth, metal, water)
year	number	Birth year used for calculation
signTitle	string | null	Human-readable sign name (only if includeReadableEntities: true)
elementTitle	string | null	Human-readable element name (only if includeReadableEntities: true)
text	string | null	Interpretation text (only if includeText: true)

Chinese Zodiac Signs

The 12-year cycle of Chinese zodiac animals:

Sign	Cycle Years (examples)
rat	1948, 1960, 1972, 1984, 1996, 2008, 2020
ox	1949, 1961, 1973, 1985, 1997, 2009, 2021
tiger	1950, 1962, 1974, 1986, 1998, 2010, 2022
rabbit	1951, 1963, 1975, 1987, 1999, 2011, 2023
dragon	1952, 1964, 1976, 1988, 2000, 2012, 2024
snake	1953, 1965, 1977, 1989, 2001, 2013, 2025
horse	1954, 1966, 1978, 1990, 2002, 2014, 2026
goat	1955, 1967, 1979, 1991, 2003, 2015, 2027
monkey	1956, 1968, 1980, 1992, 2004, 2016, 2028
rooster	1957, 1969, 1981, 1993, 2005, 2017, 2029
dog	1958, 1970, 1982, 1994, 2006, 2018, 2030
pig	1959, 1971, 1983, 1995, 2007, 2019, 2031

Chinese New Year

The Chinese zodiac year begins on Chinese New Year (late January or early February), not January 1st. Birthdays in January or early February may belong to the previous zodiac year.

---

Chinese Yearly Forecast

Calculate a yearly forecast for a person based on their Chinese zodiac sign.

Required Module

Requires the chinese-forecast:calc module.

curl -X POST "https://api.astroapi.cloud/api/calc/chinese-forecast" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1990-06-15",
    "forecastYear": 2024,
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

Parameters

Parameter	Type	Required	Description
birthDate	string	Yes	Birth date in YYYY-MM-DD format
forecastYear	number	No	Year to generate forecast for (default: current year)
language	string	No	Language code for text content (default: "en")
includeText	boolean	No	Include interpretation text (default: false)
includeReadableEntities	boolean	No	Include human-readable sign title (default: false)

Response

{
    "data": {
        "sign": "horse",
        "year": 2024,
        "signTitle": "Horse",
        "text": "The Year of the Dragon 2024 brings dynamic energy to the Horse. Your natural charisma is amplified this year, drawing new opportunities and connections into your life...",
        "categories": {
            "Love": "This year brings exciting romantic possibilities. Single Horses may meet someone special through social activities. Those in relationships will find new depth and understanding...",
            "Career": "Professional growth is highlighted in 2024. Your innovative ideas gain recognition, and a promotion or new opportunity may present itself mid-year...",
            "Health": "Pay attention to stress levels and ensure adequate rest. Regular exercise and a balanced diet will help maintain your characteristically high energy levels...",
            "Finance": "Financial prospects improve steadily through 2024. Avoid impulsive spending in the first quarter, and by mid-year you will be in a stronger position to invest..."
        }
    }
}

Response Fields

Field	Type	Description
sign	string	Chinese zodiac animal sign
year	number	Forecast year
signTitle	string | null	Human-readable sign name (only if includeReadableEntities: true)
text	string | null	General yearly forecast text (only if includeText: true)
categories	object	Forecast broken down by life area
categories.Love	string	Romantic and relationship forecast
categories.Career	string	Professional and career forecast
categories.Health	string	Health and wellbeing forecast
categories.Finance	string	Financial forecast