chinese

BaZi Annual Pillar (Liu Nian)

Calculate the Heavenly Stem and Earthly Branch for any given Gregorian year (Liu Nian 流年 annual pillar). Optionally returns the NaYin resonance element.

Metering: 3 units per call.

post/chinese/bazi/annual-pillar

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/chinese/bazi/annual-pillar
  • 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

Request body

dayinteger

Optional day of month. When supplied together with month, the moment is classified under year_boundary and the resolved BaZi year is returned. Must be supplied together with month.

hourinteger

Optional hour (0–23), only meaningful when month and day are supplied. Defaults to 12 (noon).

monthinteger

Optional month (1–12). When supplied together with day, the moment is classified under year_boundary and the resolved BaZi year is returned. Must be supplied together with day.

yearinteger required

Gregorian year for the Liu Nian calculation. When month and day are supplied, the response echoes the resolved BaZi year, which may differ from this value.

year_boundary'lichun' | 'cny'

Year-pillar boundary convention. lichun rolls the year pillar at the Lichun (立春) solar term, around 4 February; cny rolls it at Chinese New Year.

Response

Annual pillar stem, branch, and NaYin.

animalstring required
branchstring required
branch_chinesestring required
calculation_metadataobject

Optional calculation provenance metadata (timing, engine flags, ayanamsa, etc.). Free-form; present when the handler attaches it. Present when month and day were supplied, i.e. when a specific moment was classified under year_boundary. Absent for a year-only request, which resolves no moment and therefore has no provenance to report.

elementstring required
polarity'Yang' | 'Yin' required
sexagenary_indexinteger required
stemstring required
stem_chinesestring required
successboolean
yearinteger required

Changes

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