Estrellas Voladoras (玄空飛星)

Xuan Kong Fei Xing (玄空飛星) es la escuela de feng shui que levanta la carta no de una persona, sino de un edificio. Bastan dos datos, y ambos son obligatorios: el periodo en que se ocupó el edificio y la dirección hacia la que mira. De ellos se derivan tres números para cada uno de los nueve sectores.

Tres estrellas en cada palacio

Estrella	中文	Qué se lee
De montaña	山星	Personas, salud, relaciones
Del periodo	運星	La época a la que pertenece el edificio
De fachada	向星	Dinero, oportunidades, movimiento

El número de la estrella y su vuelo son aritmética exacta. Lo que significa un par de números en una habitación concreta ya es una tradición interpretativa, con más de una escuela. En la respuesta estas dos mitades están separadas, y notes indica dónde termina el cálculo.

Endpoints

Endpoint	Créditos	Qué devuelve
POST /v1/chinese/feng-shui/flying-star	10	Carta natal del edificio: nueve palacios, tipo de carta, patrones especiales
POST /v1/chinese/feng-shui/annual-stars	10	Estrellas anuales y aflicciones del año, opcionalmente la capa mensual

Precaución

El periodo no tiene valor por defecto. Sin period ni occupiedDate la petición devuelve 400. Un edificio ocupado en 1998 pertenece al periodo 7, y una carta del periodo 9 dada con seguridad sería simplemente una respuesta incorrecta con aspecto de correcta.

Ejemplo

cURL

curl -X POST https://api.astroway.info/v1/chinese/feng-shui/flying-star \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "period": 8, "facing": 180, "year": 2026 }'

Node

const res = await fetch('https://api.astroway.info/v1/chinese/feng-shui/flying-star', {
  method: 'POST',
  headers: { 'X-Api-Key': process.env.ASTROWAY_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ occupiedDate: '2011-06-01', facingMountain: 'S2' }),
});
const { data } = await res.json();
console.log(data.chartType.id, data.palaces.find((p) => p.palace === 'S').pair);

La orientación se puede indicar en grados en el sentido de las agujas del reloj desde el norte verdadero (facing: 180) o con el nombre de una de las 24 montañas: por código (S2), en pinyin (Wu) o con el carácter (午). Con el periodo pasa lo mismo: un número (period: 8) o la fecha de ocupación (occupiedDate), y en ese caso el año se cuenta desde el momento exacto de Li Chun, no desde un 4 de febrero fijo.

Tipo de carta

Cuatro disposiciones canónicas, y la respuesta nombra la que ha salido:

id	中文	Lectura
wang-shan-wang-shui	旺山旺水	La más favorable: las personas detrás, el dinero delante
shang-shan-xia-shui	上山下水	La invertida; justo aquí el practicante pregunta por el paisaje exterior
double-facing	雙星到向	Ambas estrellas delante: bueno para el dinero, hace falta un apoyo detrás
double-sitting	雙星到坐	Ambas detrás: bueno para las personas, hace falta agua delante

Qué comprobamos y con qué

La regla del vuelo de la estrella se formula mal más a menudo que bien. Lo que envía la estrella hacia delante o hacia atrás no es la polaridad de la montaña hacia la que mira el edificio, sino la polaridad de la montaña en la misma posición ordinal dentro del sector del propio trigrama de la estrella.

La lectura ingenua reproduce 6 de las 24 cartas publicadas del periodo 8 y falla en 18. Una o dos comprobaciones la habrían dejado pasar, por eso los tests contienen todo el conjunto publicado: 24 cartas, 9 palacios, 3 estrellas, 648 números, y todos coinciden.

La estrella 5 no tiene trigrama propio y toma prestada la polaridad de la estrella del periodo. La otra versión difundida (“la polaridad del palacio del que vino el 5”) es la misma versión: el 5 siempre acaba en el palacio con el número Lo Shu 10 − період, y ese número siempre tiene la paridad del periodo. Está demostrado para los nueve periodos, no se ha dejado como salvedad.

Nota

Las 替卦 (estrellas de sustitución) no están implementadas a propósito. Algunas escuelas las aplican cuando la medición cae cerca del límite de una montaña. Eso cambia la carta, y las escuelas no se ponen de acuerdo sobre las condiciones. En lugar de elegir en silencio, la respuesta avisa: si tu medición está a menos de 1.5° de un límite, warnings incluirá la distancia y la montaña vecina.

Estrellas anuales y aflicciones

POST /v1/chinese/feng-shui/annual-stars da las nueve estrellas anuales y las cuatro o cinco aflicciones del año. La diferencia entre ellas importa a quien piensa actuar:

• Tai Sui (太歲) y Sui Po (歲破) ocupan una montaña cada una, 15°.
• San Sha (三煞) es un sector entero, 45°.
• El Cinco Amarillo (五黃) y el Dos Negro (二黑) son sectores de la carta anual.

Para 2026 la respuesta sitúa el Cinco Amarillo en el sur, Tai Sui en S2 (午), Sui Po en N2 y San Sha en el norte, lo que coincide con los almanaques publicados; estos cuatro valores están fijados en un test.

El año aquí es solar y empieza en Li Chun. Una fecha de enero pertenece al año anterior, y por eso no se asume nada por defecto: sin year ni date habrá un 400.

Qué hay al lado

El resto de la superficie de feng shui ya existía en la API y sigue en su sitio: POST /v1/chinese/feng-shui/kua (número Kua), /lucky-directions (las ocho direcciones personales) y /bagua (el mapa de las nueve áreas de vida).