Skip to content
96Astro API
Get API Key

Chinese astrology

Available

Chinese Zodiac and Four Pillars API

Zodiac animal by the lunar new year, year, month, day and hour pillars, day master, compatible animals and clash.

  • POST /v1/chinese/chinese-chart
  • 1 credit
Get a free key API reference
Request
curl https://api.96astroapi.com/v1/chinese/chinese-chart \  -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
    }'

Overview

Zodiac animal by the lunar new year, year, month, day and hour pillars, day master, compatible animals and clash.

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

  • POST /v1/chinese/chinese-chart
  • 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.

  • lunar_yearnumber
  • new_year_datestring
  • zodiac_animalstring
  • elementstring
  • polaritystring
  • traitsstring
  • pillarsobject
  • day_masterobject
  • compatible_animalsarray of string
  • clash_animalstring
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 Zodiac and Four Pillars API: common questions

4answers

Ask the team
01What does the Chinese Zodiac and Four Pillars API return?

Zodiac animal by the lunar new year, year, month, day and hour pillars, day master, compatible animals and clash. The response's data object includes lunar_year, new_year_date, zodiac_animal, element, polarity, traits, pillars and day_master. See the reference for an example response.

02What input does Chinese Zodiac and Four Pillars need?

Birth details.

03How much does a Chinese Zodiac and Four Pillars 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.