Zodíaco chinês e calendário

O animal do ano é a parte mais conhecida da tradição e a mais frequentemente calculada incorretamente. O ano no BaZi não começa a 1 de janeiro nem com o Ano Novo Chinês, mas com 立春 Lichun, o momento em que a longitude visível do Sol atinge 315°. Em 2026, isso é 2026-02-03T20:02:08Z, ou seja, 4 de fevereiro às 04:02, hora de Pequim. Quem nasce a 2 de fevereiro pertence ao animal anterior, embora o calendário na parede já mostre o novo ano.

Endpoints

Endpoint	Créditos	O que retorna
POST /v1/chinese/zodiac/animal	10	Animal do ano, pilar, elementos do ramo e do tronco
POST /v1/chinese/zodiac/element	10	Elemento fixo do ramo e elemento cíclico do tronco
POST /v1/chinese/zodiac/inner-animal	10	Animal interior: ramo do mês
POST /v1/chinese/zodiac/secret-animal	10	Animal secreto: ramo da hora
POST /v1/chinese/zodiac/compatibility	10	Compatibilidade de dois animais por 三合 e 六冲
POST /v1/chinese/lunar-date	10	Data lunar, mês bissexto, Ano Novo Chinês
POST /v1/chinese/solar-terms	10	Todos os 24 termos do ano com precisão de segundo

Três animais, não apenas um

Os horóscopos nas revistas conhecem um animal. A tradição conhece três, e eles respondem a diferentes perguntas.

Animal	De onde	O que significa
Exterior	ramo do ano	Como as pessoas te veem
Interior	ramo do mês	Motivos, o ‘eu’ privado
Secreto	ramo da hora	A camada mais profunda, muitas vezes escondida de ti mesmo

O animal interior é limitado pelos momentos exatos de 節, e não pelo meio do mês, por isso nascimentos a 5 de maio e 6 de maio podem resultar em animais diferentes.

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."
  }
}

Dois elementos do ano

Quem nasceu em 1990 é um ‘cavalo de metal’, e neste nome há dois elementos diferentes que são fáceis de confundir.

• Cíclico vem do tronco celestial e muda a cada dois anos: 庚 é metal.
• Fixo pertence ao ramo terrestre para sempre: 午 é fogo, e o cavalo é sempre de fogo.

/chinese/zodiac/element retorna ambos em campos separados, fixedElement e cyclingElement, em vez de escolher por ti.

Compatibilidade

A avaliação baseia-se em 三合 (três harmonias) e 六冲 (seis confrontos), ou seja, na geometria do círculo dos ramos, e não numa lista de opiniões.

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."]
  }
}

Compatibilidade de animais é uma camada, não um mapa

A comparação de animais do ano é o corte mais grosseiro: sabe sobre a pessoa exatamente um ideograma dos oito. Para uma leitura real, usa /v1/bazi/chart de ambos e observa as interações de todos os quatro pilares.

Data lunar

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"
}

O mês começa no dia de Pequim que contém a lua nova. O mês bissexto repete o número do anterior e não contém 中氣: esta é a razão da sua existência, e não um efeito secundário.

Antes de 1929

O calendário antes de 1929 é calculado pela hora média local de Pequim (UTC+7:45:40), e esta é a base histórica, não a nossa convenção. Uma lua nova que ocorre minutos antes da meia-noite local pode colocar o mês um dia à frente do almanaque impresso daquele dia, porque estes eram calculados com precisão de dia.

Vinte e quatro termos solares

Um termo não é uma data de uma tabela, mas um momento em que a longitude visível do Sol se torna um múltiplo de 15°. Nós obtemos isso das efemérides, por isso a resposta é a mesma para qualquer ano dentro do domínio e não depende de alguém ter atualizado a tabela.

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}'

O array terms contém todos os vinte e quatro; aqui é mostrado o primeiro:

{
  "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
    }
  ]
}

Doze dos vinte e quatro contêm opensPillarMonth: true: estes são os 節 que abrem o mês dos pilares. Os restantes doze são 中氣, que dividem o mês ao meio e determinam qual mês será bissexto.

Um termo é um momento, não um dia, e o dia é diferente

Lê utc, e não beijing, se o teu utilizador não estiver na China. A China e Hong Kong contam por UTC+8, o Japão e a Coreia por UTC+9, o Vietname por UTC+7, então uma hora das vinte e quatro é uma janela na qual os almanaques nacionais imprimem diferentes dias de calendário. Em média, é um termo por ano. Em 2026, há dois: 雨水 é 18 de fevereiro em Pequim e 19 de fevereiro em Tóquio, 芒種 é 5 e 6 de junho. Os nossos momentos reproduzem ambas as publicações com precisão de minuto.

Idiomas

Os animais e elementos são traduzidos para 21 idiomas. Adiciona ?lang= ou "language" no corpo, e um campo *Name aparecerá ao lado do token em inglês:

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" } }

Os campos em inglês permanecem no lugar para sempre: a localização adiciona, não substitui.