// 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/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/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/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/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.