get

/api/v1/chinese-calendar/year/{year}

Get Chinese year information

Overview

Returns comprehensive Chinese lunar calendar information for a Gregorian year, including zodiac animal, element, sexagenary cycle, and Chinese New Year date.

Parameters

Name	Type	In	Required	Description
`year`	string	path	Yes	Gregorian year (1900-2100)

Response

200 — Chinese year information

gregorianYear integer required

chineseYear integer required

sexagenaryCycle object required

yearInCycle integer required

stem object required

index integer required
chinese string required
pinyin string required
element string required: Enum:
WoodFireEarthMetalWater
polarity string required: Enum:
YangYin

branch object required

index integer required
chinese string required
pinyin string required
animal string required: Enum:
RatOxTigerRabbitDragonSnakeHorseGoatMonkeyRoosterDogPig

combined string required

combinedPinyin string required

zodiacAnimal object required

english string required: Enum:
RatOxTigerRabbitDragonSnakeHorseGoatMonkeyRoosterDogPig
chinese string required
pinyin string required
characteristics array required: array of string
compatibleWith array required: array of string
incompatibleWith array required: array of string

element object required

english string required: Enum:
WoodFireEarthMetalWater
chinese string required
pinyin string required

polarity string required

Enum:

YangYin

newYear object required

date string required
gregorianDate string required

hasLeapMonth boolean required

leapMonth integer required

totalDays integer required

Example Request

cURL

curl "https://api.almuten.io/api/v1/chinese-calendar/year/{year}" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "gregorianYear": 0,
  "chineseYear": 0,
  "sexagenaryCycle": {
    "yearInCycle": 1,
    "stem": {
      "index": 0,
      "chinese": "",
      "pinyin": "",
      "element": "Wood",
      "polarity": "Yang"
    },
    "branch": {
      "index": 0,
      "chinese": "",
      "pinyin": "",
      "animal": "Rat"
    },
    "combined": "",
    "combinedPinyin": ""
  },
  "zodiacAnimal": {
    "english": "Rat",
    "chinese": "",
    "pinyin": "",
    "characteristics": [
      ""
    ],
    "compatibleWith": [
      "Rat"
    ],
    "incompatibleWith": [
      "Rat"
    ]
  },
  "element": {
    "english": "Wood",
    "chinese": "",
    "pinyin": ""
  },
  "polarity": "Yang",
  "newYear": {
    "date": "",
    "gregorianDate": ""
  },
  "hasLeapMonth": true,
  "leapMonth": 1,
  "totalDays": 0
}