Zodiaco chino y calendario

El animal del año es la parte más conocida de la tradición y la más frecuentemente calculada incorrectamente. El año en BaZi no comienza el 1 de enero ni con el Año Nuevo chino, sino con 立春 Lichun, el momento en que la longitud aparente del Sol alcanza los 315°. En 2026 esto es 2026-02-03T20:02:08Z, es decir, el 4 de febrero a las 04:02 hora de Pekín. Quien nazca el 2 de febrero pertenece al animal anterior, aunque el calendario de la pared ya muestre el nuevo año.

Endpoints

| Endpoint | Credits | Qué devuelve | |---|:|---| | POST /v1/chinese/zodiac/animal | 10 | Animal del año, pilar, elementos de la rama y del tronco | | POST /v1/chinese/zodiac/element | 10 | Elemento fijo de la rama y elemento cíclico del tronco | | POST /v1/chinese/zodiac/inner-animal | 10 | Animal interno: rama del mes | | POST /v1/chinese/zodiac/secret-animal | 10 | Animal secreto: rama de la hora | | POST /v1/chinese/zodiac/compatibility | 10 | Compatibilidad de dos animales según 三合 y 六冲 | | POST /v1/chinese/lunar-date | 10 | Fecha lunar, mes intercalado, Año Nuevo chino | | POST /v1/chinese/solar-terms | 10 | Todos los 24 términos del año con precisión de segundo |

Tres animales, no uno

Los horóscopos en revistas conocen un animal. La tradición conoce tres, y responden a diferentes preguntas.

| Animal | Origen | Qué significa | |---|:|---| | Exterior | rama del año | Cómo los demás ven a la persona | | Interior | rama del mes | Motivaciones, el “yo” privado | | Secreto | rama de la hora | El estrato más profundo, a menudo oculto incluso a la propia persona |

El animal interno está limitado por los momentos exactos de los 節, no por la mitad del mes, por lo que nacidos el 5 de mayo y el 6 de mayo pueden tener animales 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."
  }
}

Dos elementos del año

Nacido en 1990 es el “Caballo de Metal”, y en este nombre hay dos elementos diferentes que se confunden fácilmente.

• Cíclico proviene del tallo celestial y cambia cada dos años: 庚 es metal.
• Fijo pertenece a la rama terrestre para siempre: 午 es fuego, y el caballo siempre es de fuego. /chinese/zodiac/element devuelve ambos por separado como campos fixedElement y cyclingElement, en lugar de elegir por el cliente.

Compatibilidad

La puntuación se basa en 三合 (tres armonías) y 六冲 (seis conflictos), es decir, en la geometría del círculo de las ramas, no en una lista de opiniones.

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

Сумісність тварин це один шар, а не карта

Comparar los animales del año es la división más gruesa: conoce exactamente un glifo de ocho sobre la persona. Para una lectura real, tome /v1/bazi/chart de ambos y observe las interacciones de los cuatro pilares.

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

El mes comienza con el día de Pekín que contiene la luna nueva. El mes intercalado repite el número del anterior y no contiene 中氣: esa es la razón de su existencia, no un efecto secundario.

До 1929 року

El calendario hasta 1929 se calcula según el tiempo medio local de Pekín (UTC+7:45:40), y esto es una base histórica, no nuestra convención. La luna nueva que cae en minutos cerca de la medianoche local puede colocar el mes un día más tarde respecto al almanaque impreso de esa época, ya que esos cálculos se hacían con precisión de día.

Veinticuatro términos solares

El término no es una fecha de una tabla, sino el instante en que la longitud aparente del Sol es múltiplo de 15°. Lo tomamos de las efemérides, por lo que la respuesta es la misma para cualquier año dentro del dominio y no depende de si alguien actualizó la tabla.

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

El array terms contiene todos los veinticuatro; aquí se muestra el primero:

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

Doce de los veinticuatro tienen opensPillarMonth: true: son los 節 que abren el mes del pilar. Los otros doce son 中氣, dividen el mes por la mitad y determinan cuál mes será intercalado.

Термін це мить, а не день, і день у нього різний

Lea utc, no beijing, si su usuario no está en China. China y Hong Kong usan UTC+8, Japón y Corea usan UTC+9, Vietnam usa UTC+7, así que una hora de los veinticuatro es una ventana en la que los almanaques nacionales imprimen diferentes días calendarios. En promedio es un término al año. En 2026 hay dos: 雨水 es el 18 de febrero en Pekín y el 19 de febrero en Tokio; 芒種 es el 5 y el 6 de junio. Nuestros instantes reproducen ambas publicaciones con precisión de minuto.

Idiomas

Los animales y elementos están traducidos a 21 idiomas. Agregue ?lang= o "language" en el cuerpo, y junto al token en inglés aparecerá el campo *Name.

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

Los campos en inglés permanecen en su lugar siempre: la localización agrega, no reemplaza.