Chinese dierenriem en kalender

Last updated 25 sep 2026 Openen als Markdown Agentinstellingen

Het Jaardier is het bekendste deel van de traditie en wordt het vaakst verkeerd berekend. Het BaZi-jaar begint niet op 1 januari en ook niet met het Chinese Nieuwjaar, maar met 立春 Lichun, het moment waarop de zichtbare lengtegraad van de Zon 315° bereikt. In 2026 is dit 2026-02-03T20:02:08Z, oftewel 4 februari om 04:02 Beijing-tijd. Iemand die op 2 februari is geboren, behoort tot het vorige dier, hoewel de kalender aan de muur al het nieuwe jaar aangeeft.

Endpoints

Endpoint	Credits	Retourneert
`POST /v1/chinese/zodiac/animal`	10	Jaardier, pilaar, elementen van tak en stam
`POST /v1/chinese/zodiac/element`	10	Vast element van de tak en cyclisch element van de stam
`POST /v1/chinese/zodiac/inner-animal`	10	Innerlijk dier: maantak
`POST /v1/chinese/zodiac/secret-animal`	10	Geheim dier: uurtak
`POST /v1/chinese/zodiac/compatibility`	10	Compatibiliteit van twee dieren volgens 三合 en 六冲
`POST /v1/chinese/lunar-date`	10	Maandatum, schrikkelmaand, Chinees Nieuwjaar
`POST /v1/chinese/solar-terms`	10	Alle 24 termen van het jaar tot op de seconde nauwkeurig

Drie dieren, niet één

Horoscopen in tijdschriften kennen één dier. De traditie kent er drie, en deze beantwoorden verschillende vragen.

Dier	Herkomst	Betekenis
Uiterlijk	jaartak	Hoe mensen jou zien
Innerlijk	maantak	Motieven, privé ‘ik’
Geheim	uurtak	De diepste laag, vaak verborgen voor jezelf

Het innerlijke dier is beperkt tot de exacte momenten van 節, en niet tot het midden van de maand, daarom kunnen geboortes op 5 mei en 6 mei verschillende dieren opleveren.

curl -X POST https://api.astroway.info/v1/chinese/zodiac/inner-animal \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":3}'

{
  "ok": true,
  "data": {
    "innerAnimal": "Snake",
    "glyph": "🐍",
    "description": "Inner animal = the BaZi month branch, bounded by the exact 節 instants. Represents internal motivations and the private self."
  }
}

Twee elementen van het jaar

Iemand geboren in 1990 is een ‘metalen paard’, en in deze naam zitten twee verschillende elementen die gemakkelijk te verwarren zijn.

Cyclisch komt van de hemelse stam en verandert elke twee jaar: 庚 is metaal.
Vast behoort voor altijd tot de aardse tak: 午 is vuur, en het paard is altijd vurig.

/chinese/zodiac/element retourneert beide in afzonderlijke velden, fixedElement en cyclingElement, in plaats van een keuze voor de client te maken.

Compatibiliteit

De beoordeling is gebaseerd op 三合 (drie harmonieën) en 六冲 (zes botsingen), dat wil zeggen op de geometrie van de takkencirkel, en niet op een lijst van meningen.

curl -X POST https://api.astroway.info/v1/chinese/zodiac/compatibility \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"date":"1990-05-15"},"person2":{"date":"1988-02-20"}}'

{
  "person1": { "solarYear": 1990, "animal": "Horse" },
  "person2": { "solarYear": 1988, "animal": "Dragon" },
  "compatibility": {
    "score": 65,
    "category": "good",
    "notes": ["Compatible enough; complementary differences."]
  }
}

Maandatum

curl -X POST https://api.astroway.info/v1/chinese/lunar-date \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-02-17"}'

{
  "gregorianDate": "2026-02-17",
  "lunar": { "month": 1, "isLeapMonth": false, "day": 1, "monthStart": "2026-02-17", "label": "month 1, day 1" },
  "chineseNewYear": "2026-02-17"
}

De maand begint met de Beijing-dag die de nieuwe maan bevat. Een schrikkelmaand herhaalt het nummer van de vorige en bevat geen 中氣: dit is de reden van zijn bestaan, niet een neveneffect.

Vierentwintig zonnetermen

Een term is geen datum uit een tabel, maar een moment waarop de zichtbare lengtegraad van de Zon een veelvoud van 15° wordt. We halen deze uit efemeriden, daarom is het antwoord hetzelfde voor elk jaar binnen het domein en hangt het er niet van af of iemand de tabel heeft bijgewerkt.

curl -X POST https://api.astroway.info/v1/chinese/solar-terms \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

De array terms bevat alle vierentwintig; hier wordt de eerste getoond:

{
  "year": 2026,
  "terms": [
    {
      "index": 0,
      "chinese": "立春",
      "pinyin": "Lichun",
      "english": "Start of Spring",
      "sunLongitude": 315,
      "utc": "2026-02-03T20:02:08Z",
      "beijing": "2026-02-04T04:02:08+08:00",
      "opensPillarMonth": true
    }
  ]
}

Twaalf van de vierentwintig hebben opensPillarMonth: true: dit zijn 節, die de pilaarmaand openen. De overige twaalf zijn 中氣, deze verdelen de maand in tweeën en bepalen welke maand een schrikkelmaand zal zijn.

Talen

Dieren en elementen zijn vertaald naar 21 talen. Voeg ?lang= of "language" toe in de body, en naast het Engelse token verschijnt een *Name-veld:

curl -X POST "https://api.astroway.info/v1/chinese/zodiac/animal?lang=es" \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15"}'

{ "animal": "Horse", "animalName": "Caballo", "element": { "fixed": "Fire", "fixedName": "Fuego" } }

De Engelse velden blijven permanent op hun plaats: lokalisatie voegt toe, het vervangt niet.

Wijziging voorstellen