// astrology api
Astrology API by technique
AstroWay endpoints grouped by astrological technique: each page ships a runnable request, a parameters table, and the real credit cost.
POST /v1/chart
API de carta natal
Convierte un único momento de nacimiento en una carta natal completa y estructurada - planetas, cúspides de casas, aspectos y datos angulares - en un solo POST. Zodíaco tropical, trece sistemas de casas, precisión de Swiss Ephemeris, salida en JSON.
POST /v1/synastry
API de sinastría
Compara dos cartas natales en una sola llamada y obtén la malla de aspectos cruzados que impulsa cualquier funcionalidad de compatibilidad: quién aspecta a quién, con qué ángulo, con qué orbe y en qué dirección. Entran dos cartas, sale la relación entre ellas.
POST /v1/transits
API de tránsitos
Captura el cielo en cualquier fecha objetivo y superponlo sobre el marco de casas natales de una persona en un solo POST. Planetas en tránsito, las cúspides natales en las que caen, la malla de aspectos entre los cuerpos en tránsito, más paralelos y antiscia: precisión de Swiss Ephemeris, salida en JSON.
POST /v1/composite
API de carta compuesta
Fusiona dos cartas natales en una. La carta compuesta de puntos medios toma cada par planetario y los dos conjuntos de ángulos, halla el punto medio de cada uno y devuelve una única carta derivada que modela la relación como una entidad propia. Entran dos cartas, sale una compuesta, en JSON.
POST /v1/progressions
API de progresiones secundarias
Avanza la carta natal de forma simbólica: un día de movimiento planetario en las efemérides representa un año de vida. Proporciona una carta natal y una fecha objetivo y obtén la carta progresada - planetas, casas, aspectos - para esa edad. Precisión de Swiss Ephemeris, salida en JSON.
POST /v1/symbolic-directions
API de Direcciones de Arco Solar
El arco solar mueve todo el gráfico hacia adelante en un número: la distancia que el Sol ha recorrido por progresión secundaria. Cada planeta, cada cúspide y ambos ángulos se desplazan por ese mismo arco, por lo que un aspecto natal que estaba a dos grados de exacto llega a ser exacto unos dos años después. Este endpoint devuelve el gráfico dirigido y el arco que lo produjo.
POST /v1/profections
API de Proyecciones Anuales
Las proyecciones anuales son la técnica de temporización más simple del conjunto helenístico y una de las más usadas: la carta avanza una casa por cada año de vida, y el gobernante del signo en esa casa se vuelve el señor del año. Un número entra, un planeta sale, y todo el año tiene una firma.
POST /v1/harmonics
API de Gráficos Armónicos
Un gráfico armónico multiplica cada longitud planetaria por un número entero y devuelve el resultado al círculo. La aritmética es trivial pero el efecto no: los aspectos que son difíciles de ver en el gráfico natal se convierten en conjunciones en el armónico, así que el patrón que estabas escudriñando aparece como una pila.
POST /v1/almuten
API de Almuten Figuris
El almuten figuris es la respuesta tradicional a una pregunta que el gráfico moderno evita: ¿qué planeta tiene el reclamo más fuerte sobre esta natividad? Se decide contando la dignidad en los lugares clave del gráfico y tomando al ganador, y el endpoint devuelve tanto al ganador como el recuento completo.
POST /v1/hd/hologenetic
API del Perfil Hologénetico de Gene Keys
El perfil hologénetico organiza once esferas en tres secuencias, cada esfera lleva una puerta y una línea derivada de una posición planetaria al nacer o al momento del diseño. Este endpoint devuelve todo el perfil en una llamada: Activación, Venus y Perla, con la puerta y la línea de cada esfera.
POST /v1/solar-return
API de revolución solar
Levanta la carta para el instante exacto en que el Sol vuelve a su grado natal en un año elegido: el cumpleaños astrológico. Pasa una carta natal y un año, obtén la carta de revolución solar de ese ciclo. Tropical, Sol-a-Sol-natal, precisión de Swiss Ephemeris, salida en JSON.
POST /v1/lunar-return
API de revolución lunar
Halla el siguiente momento en que la Luna regresa a su longitud natal en una fecha elegida o después de ella - aproximadamente cada 27,3 días - y levanta la carta para él en la ubicación que elijas. Pasa datos natales y una fecha de inicio, obtén la carta de revolución lunar. Precisión de Swiss Ephemeris, salida en JSON.
POST /v1/draconic
API de carta dracónica
Reancla todo el zodíaco al Nodo Norte de la Luna. Desliza 0° de Aries sobre el Nodo Norte natal y cada planeta se relee en longitud nodal - «dracónica» - . Pasa una carta natal, obtén planetas, casas y aspectos expresados en el marco dracónico. Precisión de Swiss Ephemeris, salida en JSON.
POST /v1/heliocentric
API de carta heliocéntrica
Traslada al observador al Sol. En lugar del cielo habitual centrado en la Tierra, esto devuelve el sistema solar tal como se ve desde el Sol: la Tierra se convierte en un cuerpo, la Luna y el Ascendente desaparecen, y cada planeta se da en longitud heliocéntrica. Pasa un momento, obtén la carta heliocéntrica. Precisión de Swiss Ephemeris, salida en JSON.
POST /v1/relocation
API de carta de relocalización
Mantén los planetas, mueve el mapa. Una carta de relocalización conserva cada longitud planetaria natal exactamente como al nacer, pero reconstruye el marco de casas - Ascendente, Medio Cielo, cúspides - para un lugar nuevo. Pasa datos natales y una ubicación objetivo, obtén ambas cartas más el delta angular. Precisión de Swiss Ephemeris, salida en JSON.
POST /v1/astrocartography
API de astrocartografía
La astrocartografía toma un único momento de nacimiento y lo proyecta sobre todo el planeta: en lugar de preguntar dónde estaban los planetas en el cielo, pregunta dónde sobre la Tierra estaba angular cada planeta. El endpoint devuelve la geometría de líneas que trazas en un mapamundi para ver qué longitudes activan qué energía planetaria.
POST /v1/parans
API de Parans
Un parán es el punto donde dos líneas de astrocartografía se cruzan: un lugar donde dos planetas estaban angularmente simultáneamente. Este endpoint devuelve cada cruce para un momento de nacimiento, con las coordenadas de cada uno, para que puedas marcar en el mapa los puntos donde dos temas planetarios se fusionan en lugar de simplemente correr uno al lado del otro.
POST /v1/parans/star
API de paralajes estrella-planeta
Una estrella y un planeta están en paralaje cuando ambos están angulares al mismo tiempo, y si eso puede suceder depende solo de la latitud. Así que un paralaje es una latitud, que es como Bernadette Brady lo tabula, y este endpoint devuelve latitudes en lugar de puntos. 953 estrellas están disponibles, 36 en el conjunto predeterminado.
POST /v1/acg/best-places
API de mejores lugares
Clasifica ciudades reales contra las líneas de astrocartografía de un gráfico, para una de las diecinueve áreas de la vida. 34,028 lugares de GeoNames, puntuados según lo cerca que cada uno se sienta de las líneas de las que se compone el área, con el lado de apoyo y el lado desafiante reportados por separado.
POST /v1/reports/gemstone
Informe PDF de gemas (ratna)
La prescripción de gemas Jyotish como un documento que guardas. Cada piedra recomendada tiene una página: lo que su graha significa clásicamente, la base en la propiedad de la casa, mineral y sustitutos, peso en ratti con conversiones a gramos y quilates, día de la semana, dedo, metal, mantra y el próximo día auspicioso para usarla por primera vez.
POST /v1/reports/relocation
Informe de reubicación PDF
Hasta cinco lugares comparados para un mapa natal, como un PDF de varias páginas que un cliente puede conservar. Por lugar: los ángulos reubicados con su desplazamiento respecto al nacimiento, qué planetas cambiaron de casa, cada línea de astrocartografía que pasa dentro de 300 km con su interpretación, y puntuaciones de apoyo y desafío en las diecinueve áreas de la vida.
POST /v1/local-space
API de astrología de espacio local
El espacio local hace una pregunta diferente a la astrocartografía: no dónde en la Tierra un planeta estaba angular, sino en qué dirección de brújula estaba desde el lugar de nacimiento. El endpoint devuelve una azimut y una altitud para cada cuerpo, además de la gran trayectoria circular que esa dirección traza a través del globo.
POST /v1/geodetic
API de carta equivalente geodésica
Una carta geodésica obtiene los cuatro ángulos solo a partir de la geografía. Cero grados de Aries está fijado al meridiano de Greenwich, cada grado de longitud se convierte en un grado del zodíaco, y cualquier lugar en la Tierra adquiere un Midheaven y un Ascendant sin que se necesite la hora de nacimiento.
POST /v1/solar-acg
API de cartografía astrológica de retorno solar
La cartografía astrológica natal responde dónde funciona una carta. La cartografía astrológica de retorno solar responde dónde funciona este año. El endpoint calcula el momento exacto en que el Sol regresa a su longitud natal en el año que especificas, luego mapea esa carta en todo el mundo como su propio conjunto de líneas angulares.
POST /v1/acg/by-category
API de interpretación de astrocartografía
La geometría de las líneas por sí sola no le dice a un usuario dónde mudarse. Este endpoint toma un área de la vida, selecciona las líneas de astrocartografía que realmente la gobiernan, las clasifica según su fuerza y proximidad aplicada, y devuelve el texto de interpretación para cada una. Una sola llamada reemplaza el mapeo planeta-tema que cada producto de reubicación tendría que inventar internamente.
POST /v1/essential-dignities
API de dignidades esenciales
Las dignidades esenciales miden con qué comodidad se sitúa cada planeta en el signo y el grado que ocupa. Este endpoint pasa cada cuerpo por el esquema tradicional quíntuple - regencia, exaltación, triplicidad, término y faz - junto con las dos debilidades, y devuelve tanto un desglose por planeta como un único total ponderado.
POST /v1/fixed-stars
API de estrellas fijas
Más allá de los planetas en movimiento, la capa más antigua de la astrología lee las estrellas fijas - Régulo, Spica, Algol, Aldebarán y sus pares - . Este endpoint escanea una carta natal en busca de conjunciones ajustadas a esas estrellas mayores y devuelve cada contacto con su orbe, para que puedas incorporar el carácter atribuido a una estrella en una lectura.
POST /v1/arabic-parts
API de partes árabes
Las partes árabes, o suertes helenísticas, son puntos calculados que se derivan mediante aritmética sobre la carta en lugar de leerse directamente del cielo. Este endpoint calcula la Suerte de la Fortuna, del Espíritu, de Eros y las demás a partir de fórmulas sobre el Ascendente y dos planetas, manejando la inversión entre nacimiento diurno y nocturno que exige la práctica real de las suertes.
POST /v1/midpoint-trees
API de árboles de puntos medios
La cosmobiología lee una carta a través de los puntos medios: el grado exactamente a mitad de camino entre dos planetas, y cualquier tercer planeta que caiga sobre él. Este endpoint calcula la estructura de puntos medios de una carta, ensambla el árbol de puntos medios de cada planeta y señala las simetrías que la tradición del disco de 90° trata como los puntos más activos de la carta.
POST /v1/parallel-aspects
API de aspectos de declinación
La mayor parte del trabajo de aspectos ocurre a lo largo de la eclíptica en longitud, pero dos cuerpos también pueden relacionarse por declinación: su distancia al norte o al sur del ecuador celeste. Este endpoint trabaja en esa segunda dimensión, hallando paralelos y contraparalelos, los análogos en declinación de la conjunción y la oposición, y señalando cuándo un cuerpo está fuera de límites.
POST /v1/vedic/dashas/vimshottari/maha
API de Mahadasha Vimshottari
Vimshottari es el ciclo de períodos planetarios de 120 años que ancla el cómputo de fechas védico. Este endpoint lee la posición sidérea de la Luna al nacer, localiza el nakshatra que ocupa y, desde ese único punto, despliega la cadena ordenada de Mahadashas - los grandes períodos de vida, cada uno gobernado por uno de los nueve grahas - con las fechas de calendario exactas que los delimitan.
POST /v1/vedic-divisional
API de cartas divisionales
Las cartas Varga son las lentes de aumento del Jyotish: cada una subdivide cada signo en un armónico elegido y remapea los planetas sobre una cuadrícula más fina que habla de un dominio de la vida. Este endpoint toma un momento de nacimiento y una división solicitada - D1 hasta D60 - y devuelve dónde cae cada planeta en esa varga.
POST /v1/vedic/varshaphal
Carta anual Tajika (Varshaphal)
La carta védica para un año de vida, calculada en el momento en que el Sol sidéreo regresa a su longitud natal. Devuelve la entrada del año al segundo, la carta anual, la muntha con su casa y señor, la fuerza quíntuple para los siete grahas, los cinco candidatos de los que se elige un señor del año, y el propio señor del año bajo ambas lecturas que las fuentes respaldan.
POST /v1/vedic/shadbala/full
API de Shadbala
Shadbala - literalmente «fuerza séxtuple» - es la forma clásica de cuantificar cuánto puede realmente cumplir un planeta con sus promesas en una carta. Este endpoint calcula la fuerza total de cada graha como la suma de sus seis balas constituyentes, devolviendo una puntuación por planeta en rupas para que puedas clasificar los planetas según con qué fuerza están posicionados para actuar.
POST /v1/numerology/pythagorean/life-path
API de numerología
Este endpoint calcula el número del camino de vida pitagórico: el dígito único que condensa una fecha de nacimiento en su firma numerológica central. Es uno de los cálculos dentro de una suite más amplia que abarca cuatro sistemas y aproximadamente diez cálculos cada uno, y se ejecuta como aritmética pura sin efemérides ni astrología de por medio.
POST /v1/tarot/rider-waite/draw/three-card
API de tarot
Este endpoint realiza una tirada sembrada y reproducible del mazo Rider-Waite-Smith de 78 cartas para la tirada de tres cartas. Devuelve los metadatos de la tirada, la semilla entera que gobernó el barajado, y las cartas extraídas con sus posiciones, orientaciones y significados, de modo que cualquier lectura pueda repetirse exactamente devolviendo la semilla.
POST /v1/bazi/chart
API BaZi (Cuatro Pilares)
Un momento de nacimiento dentro de todo el aparato clásico: cuatro pilares, los tallos que cada rama alberga, na yin, las doce etapas de la vida, equilibrio de elementos en los ocho caracteres, un veredicto de fuerza del marco nombrado, las estrellas simbólicas y las interacciones rama-tallo. Una llamada, JSON de salida, 21 idiomas.
POST /v1/human-design
API de Human Design
Este endpoint calcula el bodygraph de Human Design a partir de un único evento de nacimiento. Combina la carta de Personalidad natal con la carta de Diseño - tomada aproximadamente 88° de arco solar antes del nacimiento, unos tres meses antes - y deriva los elementos mecánicos del bodygraph: Tipo, Estrategia, Autoridad, Perfil, Centros, Canales, Puertas y la Cruz de Encarnación.
POST /v1/horoscope/daily
API de horóscopo con IA
Este endpoint genera un horóscopo diario escrito para un signo del zodíaco en una fecha dada llamando a nuestra pasarela de LLM. Devuelve el texto del horóscopo, un descargo de responsabilidad, el modelo que lo produjo y el idioma de la salida. A diferencia de los endpoints de cálculo, es orientación generada en lugar de un resultado determinista.
POST /v1/chinese/zodiac/compatibility
API de compatibilidad del zodiaco chino
Dos fechas de nacimiento de entrada, una puntuación de compatibilidad de salida, construida sobre la geometría de las doce ramas en lugar de una tabla de opiniones. El animal del año se determina en el instante exacto de Li Chun, por lo que un nacimiento en febrero corresponde al animal que realmente le pertenece.
POST /v1/chinese/feng-shui/flying-star
API de feng shui de estrellas voladoras (Xuan Kong)
Una dirección orientada y un período de construcción producen el completo gráfico de nueve palacios de estrellas voladoras: la estrella del período, la estrella de la montaña y la estrella orientada en cada uno de los nueve sectores, con el elemento, la naturaleza y el significado de cada una.
POST /v1/chinese/tong-shu/select
API de selección de fechas Tong Shu
Escanea un período de días y obtén solo aquellos que el almanaque aprueba para una tarea específica, con la razón por la que cada día sobrevivió y un recuento de lo que se descartó y por qué.
POST /v1/chinese/true-solar-time
API de tiempo solar verdadero
El reloj en la pared y el sol sobre el lugar de nacimiento son dos tiempos diferentes, y en una zona horaria amplia se separan por horas. Este endpoint devuelve el segundo, desglosado para que veas de dónde viene cada minuto.
POST /v1/ziwei/chart
Zi Wei Dou Shu (Purple Star) API
Una fecha de nacimiento, una hora y un sexo generan la carta completa: doce palacios con sus tallos, los catorce astros principales, los auxiliares, treinta y un astros menores, las doce etapas de la vida, los límites de década y las cuatro transformaciones marcadas en los astros que los llevan.