BaZi: los cuatro pilares

BaZi (八字, “ocho caracteres”) son los cuatro pilares del nacimiento: año, mes, día y hora, cada uno formado por su tronco celeste y su rama terrestre. Los pilares son la superficie. La lectura clásica se construye sobre lo que hay debajo.

Endpoints

Pilares

Endpoint	Créditos	Qué devuelve
POST /v1/bazi/four-pillars	10	Los cuatro pilares
POST /v1/bazi/day-master	10	El maestro del día y su arquetipo
POST /v1/bazi/ten-gods	10	Los diez dioses respecto al maestro del día
POST /v1/bazi/luck-pillars	10	Pilares de la suerte 大運 con la edad real de inicio 起運

Análisis de la carta

Endpoint	Créditos	Qué devuelve
POST /v1/bazi/chart	20	Todo lo de abajo en una sola llamada
POST /v1/bazi/hidden-stems	10	藏干: lo que oculta cada rama, con su rol y su peso
POST /v1/bazi/element-balance	10	Balance de elementos sobre los ocho caracteres, de tres maneras
POST /v1/bazi/na-yin	10	納音, el elemento sonoro de cada pilar
POST /v1/bazi/life-stages	10	十二長生, las doce etapas
POST /v1/bazi/symbolic-stars	10	神煞: flor de melocotón, caballo, dosel, noble, espada, vacío
POST /v1/bazi/interactions	10	刑冲合害: combinaciones, choques, daños, castigos
POST /v1/bazi/strength	10	Fuerza del maestro del día en el marco 扶抑

Troncos ocultos 藏干

Cada rama oculta de uno a tres troncos, y ahí vive la mayor parte de los elementos de la carta. Una carta sin ningún Agua visible puede estar empapada de ella.

Roles: 本氣 principal, 中氣 intermedio, 餘氣 residual. En las cuatro ramas almacén (丑辰未戌) el rol intermedio corresponde al elemento que la rama almacena, no al segundo de la lista: 丑 almacena metal, 辰 agua, 未 madera, 戌 fuego. El orden de la lista sigue los días de 人元司令, así que en estas cuatro el segundo lugar lo ocupa el residuo de la estación anterior.

Balance de elementos

Tres recuentos, no uno, porque los practicantes usan realmente métodos distintos, y un solo número sería una elección de escuela disfrazada de hecho.

Campo	Qué cuenta
balance.visible	Los cuatro troncos más el tronco oculto principal de cada rama: los ocho clásicos
balance.withHiddenStems	Cada tronco oculto entero
balance.weighted	La rama se reparte entre lo que oculta, así que la suma sigue siendo ocho

Campos obsoletos

elementCounts, dominantElement y missingElements en el nivel superior cuentan solo el año y el mes, cuatro caracteres de ocho, y no abren las ramas. Siguen respondiendo igual que antes hasta el 2027-09-08, y llevan las cabeceras Deprecation y Sunset según el RFC 8594. Lo nuevo está en balance.

Dónde divergen las escuelas

Cinco puntos, y en cada uno se devuelven ambas lecturas, no una.

Qué	Una lectura	La otra
Dirección de los troncos yang y yin en las doce etapas	陽順陰逆 (stageSchool=classical)	陰陽同生同死 (stageSchool=unified)
Espada yin 陰刃	según 帝旺	según 祿前一位
Noble 天乙貴人 para 庚	三命通會: 丑 y 未	淵海子平: 午 y 寅
Elemento de la combinación 午未	Tierra	la pareja “sol y luna”, sin elemento
Umbrales de fuerza	0.55 / 0.45, convención nuestra	no hay regla canónica

Fuerza del maestro del día

El marco es uno y tiene nombre: 扶抑, apoyo frente a desgaste. Todo lo que genera al maestro del día o coincide con él lo apoya; el resto lo desgasta.

Dos límites se dicen explícitamente en la propia respuesta. La rama del mes cuenta igual que las otras tres, aunque la tradición pone el mes por encima de todo, y los umbrales 0.55 / 0.45 son convención nuestra, no canon. Por eso los tres criterios clásicos (得令 estación, 得地 raíz, 得勢 aliados) se devuelven sin peso junto a la proporción: un lector que pondere el mes llegará a su propia conclusión con los mismos datos de entrada.

調候, 通關, 病藥 y 專旺 son otros marcos, no se aplican aquí y pueden dar un veredicto opuesto.

Hora solar verdadera

curl -X POST https://api.astroway.info/v1/bazi/chart \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1995-06-15",
    "time": "09:20:00",
    "timezoneOffset": 8,
    "longitude": 75.9,
    "trueSolarTime": true
  }'

La corrección afecta al día y a la hora, y ahí se detiene: el año y el mes vuelven a los instantes del reloj universal. Detalles y el coste de equivocarse en la página de convenciones.

Ejemplo

Carta completa

curl -X POST https://api.astroway.info/v1/bazi/chart \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 8, "language": "uk" }'

Solo la fuerza

curl -X POST https://api.astroway.info/v1/bazi/strength \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 8 }'