chinese

Chinese zodiac animal and element for a year

Quick lookup of the Chinese zodiac animal, element, and Yin/Yang polarity for any Gregorian year. Also returns the year's Heavenly Stem and Earthly Branch.

The 12-animal cycle: Rat, Ox, Tiger, Rabbit, Dragon, Snake, Horse, Goat, Monkey, Rooster, Dog, Pig.

The 5-element cycle: Wood, Fire, Earth, Metal, Water (each element governs two consecutive years).

Metering: 1 unit per call.

get/chinese/zodiac

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/chinese/zodiac
  • Auth: one of:
    • HTTP bearer
    • API key in header X-OpenEphemeris-API-Key
    • API key in header X-API-Key
    • API key in header X-Service-Key

Query parameters

yearinteger required

Gregorian year to look up.

Example:2024
formatstring

Response format: json (full) or llm (compact).

Headers

authorizationstring nullable
X-API-Keystring nullable
X-OpenEphemeris-API-Keystring nullable
apikeystring nullable

Response

Zodiac animal, element, polarity, and stem/branch.

animalstring required
branchobject required

Year's Earthly Branch

elementstring required
polaritystring required

Yin or Yang

stemobject required

Year's Heavenly Stem

successboolean
yearinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.