Skip to content
96Astro API
Get API Key

Chinese astrology

Available

Chinese Year Forecast API

The outlook for a year from how its animal and element meet the person's animal and day master.

  • POST /v1/chinese/chinese-year-forecast
  • 1 credit
Get a free key API reference
Request
curl https://api.96astroapi.com/v1/chinese/chinese-year-forecast \  -H "Authorization: Bearer $ASTRO_API_KEY" \  -H "Content-Type: application/json" \  -d '{
      "datetime": "1990-10-18T14:30:00",
      "timezone": "Asia/Kolkata",
      "latitude": 28.6139,
      "longitude": 77.209,
      "forecast_year": 2027
    }'

Overview

The outlook for a year from how its animal and element meet the person's animal and day master.

Call it with POST /v1/chinese/chinese-year-forecast. Input: birth details. Output: JSON, as a direct response. Each successful call costs 1 credit.

  • POST /v1/chinese/chinese-year-forecast
  • 1 credit
  • Birth details

How this is worked out

Traditions differ on this calculation. See the convention we follow and what each field means.

Try it

Runs the real calculation, free and without a key, a few times a minute. For more, and for AI readings, get a free sandbox key.

Response

Ready when you are

Press Run it to see the live response here.

Example response

Fields in dataMeasured from 6 real answers to different inputs: a required field was in every one.

  • zodiac_animalstring
  • day_masterobject
  • forecast_yearnumber
  • year_pillarobject
  • animal_relationstring
  • outlookstring
  • scorenumber
  • forecastarray of string
200Example response

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items and images are replaced by a placeholder.

Loading the example…

Request schema and every field: the Chinese astrology reference.

Related endpoints

FAQ

Chinese Year Forecast API: common questions

4answers

Ask the team
01What does the Chinese Year Forecast API return?

The outlook for a year from how its animal and element meet the person's animal and day master. The response's data object includes zodiac_animal, day_master, forecast_year, year_pillar, animal_relation, outlook, score and forecast. See the reference for an example response.

02What input does Chinese Year Forecast need?

Birth details.

03How much does a Chinese Year Forecast call cost?

1 credit per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.

04Can I try it before paying?

Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.