// 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 del tema natale
Trasforma un momento di nascita in un tema natale completo e strutturato - pianeti, cuspidi delle case, aspetti e dati angolari - in un unico POST. Zodiaco tropicale, tredici sistemi di case, precisione Swiss Ephemeris, output JSON.
POST /v1/synastry
API Sinastria
Confronta due temi natali in una sola chiamata e ottieni la griglia di cross-aspect che alimenta ogni caratteristica di compatibilità – chi aspetta chi, a che angolo, con quale orb, in quale direzione. Due temi dentro, la relazione tra loro fuori.
POST /v1/transits
API del Grafico dei Transiti
Cattura il cielo in qualsiasi data target e sovrapponilo al tema natale di una persona in un unico POST. Pianeti in transito, le cuspidi natali in cui cadono, la griglia degli aspetti tra i corpi in transito, più paralleli e antiscia – precisione Swiss Ephemeris, output JSON.
POST /v1/composite
API Carta composita
Fondi due carte natali in una sola. La composita a punto medio prende ogni coppia planetaria e i due insiemi di angoli, trova il punto medio di ciascuna e restituisce una carta derivata unica che modella la relazione come sua entità. Due carte dentro, una composita fuori, JSON.
POST /v1/progressions
API delle Progressioni Secondarie
Muovi simbolicamente il tema natale in avanti: un giorno efemeride di moto planetario corrisponde a un anno di vita. Fornisci un tema natale e una data target e ricevi il tema progressivo - pianeti, case, aspetti - per quell'età. Precisione Swiss Ephemeris, output in JSON.
POST /v1/symbolic-directions
API Direzioni delle Arci Solari
L'arco solare sposta l'intero grafico avanti di un numero: la distanza che il Sole ha percorso per progressione secondaria. Ogni pianeta, ogni cuspide e entrambe le angolazioni si spostano di quell'arco stesso, quindi un aspetto natale che era a due gradi dalla precisione raggiunge la precisione circa due anni dopo. Questo endpoint restituisce il grafico diretto e l'arco che lo ha prodotto.
POST /v1/profections
API di Profezioni Annuali
Le profezioni annuali sono la tecnica di timing più semplice nel toolkit ellenistico e una delle più utilizzate: il tema avanza di una casa all'anno di vita, e il governatore del segno su quella casa diventa il signore dell'anno. Un numero in, un pianeta fuori, e tutto l'anno ha una firma.
POST /v1/harmonics
API Grafici Armonici
Un grafico armonico moltiplica ogni longitudine planetaria per un numero intero e riporta il risultato nel cerchio. L'aritmetica è banale ma l'effetto non lo è: gli aspetti difficili da vedere nel grafico natale diventano congiunzioni nell'armonico, quindi il pattern che stavi cercando appare come una pila.
POST /v1/almuten
Almuten Figuris API
L'almuten figuris è la risposta tradizionale a una domanda che il grafico moderno evita: quale singolo pianeta ha la pretesa più forte su questa natalità. Si decide contando la dignità nei punti chiave del grafico e prendendo il vincitore, e l'endpoint restituisce sia il vincitore sia il conteggio completo.
POST /v1/hd/hologenetic
API del Profilo Ologenetico Gene Keys
Il profilo ologenetico organizza undici sfere in tre sequenze, ogni sfera ha una porta e una linea derivata da una posizione planetaria alla nascita o al momento del design. Questo endpoint restituisce l'intero profilo in una sola chiamata: Activation, Venus e Pearl, con la porta e la linea per ogni sfera.
POST /v1/solar-return
API Ritorno Solare
Calcola il tema per l'istante esatto in cui il Sole torna al suo grado natale in un anno scelto - il compleanno astrologico. Passa un tema natale e un anno, ottieni il tema del ritorno solare per quel ciclo. Tropicale, Sole-su-Sole-natale, precisione Swiss Ephemeris, output JSON.
POST /v1/lunar-return
API Ritorno Lunare
Trova il prossimo momento in cui la Luna torna alla sua longitudine natale sulla o dopo una data scelta - circa ogni 27.3 giorni - e traccia il grafico per quella posizione che scegli. Passa i dati natali e una data di inizio, ottieni il grafico del ritorno lunare. Precisione Swiss Ephemeris, output in JSON.
POST /v1/draconic
API Carta Draconica
Riposiziona l'intero zodiacale sul Nodo Nord della Luna. Sposta 0° Ariete sul Nodo Nord natale e ogni pianeta viene riletto in longitudine nodale – 'draconica'. Fornisci una carta natale, ottieni pianeti, case e aspetti espressi nel quadro draconico. Precisione Swiss Ephemeris, output JSON.
POST /v1/heliocentric
API Grafico Eliocentrico
Sposta l'osservatore al Sole. Invece del consueto cielo centrato sulla Terra, questo restituisce il sistema solare visto dal Sole - la Terra diventa un corpo, la Luna e l'Ascendente scompaiono, e ogni pianeta è dato in longitudine eliocentrica. Passa un momento, ottieni il grafico eliocentrico. Precisione Swiss Ephemeris, JSON in output.
POST /v1/relocation
API Grafico di Rilocazione
Mantieni i pianeti, sposta la mappa. Un grafico di rilocazione mantiene ogni longitudine planetaria natale esattamente come nata ma ricostruisce la struttura delle case - Ascendente, Medium Coeli, cuspidi - per un nuovo luogo. Passa i dati natali e una destinazione, ottieni entrambi i grafici più il delta angolare. Precisione Swiss Ephemeris, output in JSON.
POST /v1/astrocartography
Astrocartography API
Astrocartography prende un singolo momento di nascita e lo proietta su tutto il pianeta: invece di chiedere dove fossero i pianeti nel cielo, chiede dove sulla Terra ogni pianeta fosse angolare. L'endpoint restituisce la geometria della linea che tracci su una mappa mondiale per vedere quali longitudini attivano quale energia planetaria.
POST /v1/parans
Parans API
Un paran è il punto in cui due linee di astrocartografia si incrociano: un luogo in cui due pianeti erano contemporaneamente angolari. Questo endpoint restituisce ogni incrocio per un momento di nascita, con le coordinate di ciascuno, in modo da poter contrassegnare i punti della mappa in cui due temi planetari si fondono anziché semplicemente correre fianco a fianco.
POST /v1/parans/star
Star-planet parans API
Una stella e un pianeta sono in paran quando entrambi sono angolari nello stesso momento, e se ciò può accadere dipende solo dalla latitudine. Quindi un paran è una latitudine, come la tabula Bernadette Brady, e questo endpoint restituisce latitudini invece di punti. Sono disponibili 953 stelle, 36 nel set predefinito.
POST /v1/acg/best-places
API Migliori luoghi
Classifica città reali rispetto alle linee di astrocartografia di un tema, per una delle diciannove aree della vita. 34,028 luoghi da GeoNames, valutati in base a quanto vicino si trova ciascuna alle linee da cui quell'area è costruita, con il lato supportivo e quello sfidante riportati separatamente.
POST /v1/reports/gemstone
Rapporto gemme (ratna) PDF
La prescrizione di gemme Jyotish come documento che un cliente conserva. Ogni pietra raccomandata ottiene una pagina: cosa il suo graha indica classicamente, la base nella proprietà della casa, minerali e sostituti, peso in ratti con conversioni grammi e carati, giorno della settimana, dito, metallo, mantra, e il prossimo giorno propizio per indossarla per la prima volta.
POST /v1/reports/relocation
Report di rilocalizzazione PDF
Fino a cinque luoghi confrontati per una carta natale, come PDF multipagina che il cliente può conservare. Per ogni luogo: gli angoli rilocalizzati con il loro spostamento dalla nascita, quali pianeti hanno cambiato casa, ogni linea di astrocartografia entro 300 km con la sua interpretazione, e i punteggi di supporto e sfida nei diciannove ambiti della vita.
POST /v1/local-space
Local space astrology API
Local space chiede una domanda diversa dall'astrocartografia: non dove sulla Terra un pianeta era angolare, ma in quale direzione della bussola si trovava dal luogo di nascita. L'endpoint restituisce un'azimut e un'altitudine per ogni corpo, più il percorso del cerchio massimo che quella direzione traccia sul globo.
POST /v1/geodetic
API di carta equivalente geodetica
Una carta geodetica deriva i quattro angoli esclusivamente dalla geografia. Zero gradi di Ariete è fissato al meridiano di Greenwich, ogni grado di longitudine diventa un grado dello zodiaco, e qualsiasi luogo sulla Terra acquisisce un Medium Coeli e un Ascendente senza che sia coinvolta alcuna ora di nascita.
POST /v1/solar-acg
API di astrocartografia del ritorno solare
L'astrocartografia natale ti dice dove funziona una carta. L'astrocartografia del ritorno solare ti dice dove funziona quest'anno. L'endpoint calcola il momento esatto in cui il Sole ritorna alla sua longitudine natale nell'anno che specifichi, poi mappa quella carta sul globo come un proprio insieme di linee angolari.
POST /v1/acg/by-category
API di interpretazione di astrocartografia
La geometria delle sole linee non dice a un utente dove trasferirsi. Questo endpoint prende un'area della vita, seleziona le linee di astrocartografia che la governano effettivamente, le classifica per forza e pertinenza, e restituisce il testo di interpretazione per ciascuna. Una singola chiamata sostituisce la mappa pianeta-tema che ogni prodotto di rilocazione dovrebbe altrimenti inventare internamente.
POST /v1/essential-dignities
API Dignità Essenziali
Le dignità essenziali misurano quanto comodamente ogni pianeta si trova nel segno e nel grado che occupa. Questo endpoint analizza ogni corpo celeste secondo lo schema tradizionale a cinque parti - dominio, esaltazione, triplicità, termine e faccia - insieme alle due debilità, e restituisce sia una suddivisione per pianeta che un totale unico ponderato.
POST /v1/fixed-stars
API Stelle Fisse
Oltre ai pianeti in movimento, lo strato più antico dell'astrologia legge le stelle fisse – Regulus, Spica, Algol, Aldebaran e i loro pari. Questo endpoint scandisce una carta natale alla ricerca di congiunzioni strette con quelle stelle principali e restituisce ogni contatto con il suo orbe, così puoi inserire il carattere reputato di una stella in una lettura.
POST /v1/arabic-parts
API delle Parti Arabiche
Le Parti Arabiche, o Parti Ellenistiche, sono punti calcolati derivati da operazioni aritmetiche sul grafico anziché letti direttamente dal cielo. Questo endpoint calcola la Parte della Fortuna, dello Spirito, di Eros e le altre da formule sul Ascendente e due pianeti, gestendo l'inversione per nascita diurna e notturna che la pratica reale delle Parti richiede.
POST /v1/midpoint-trees
Midpoint Trees API
La Cosmobiologia legge una carta attraverso i midpoint: il grado esattamente a metà tra due pianeti, e qualsiasi terzo pianeta che ci atterra sopra. Questo endpoint calcola la struttura dei midpoint di una carta, assembla l'albero dei midpoint per ogni pianeta e segnala le simmetrie che la tradizione del 90° dial tratta come i punti più attivi della carta.
POST /v1/parallel-aspects
API Aspetti di Declinazione
La maggior parte del lavoro sugli aspetti avviene lungo l'eclittica in longitudine, ma due corpi possono anche relazionarsi per declinazione - la loro distanza nord o sud dell'equatore celeste. Questo endpoint lavora in quella seconda dimensione, trovando paralleli e contraparalleli, gli analoghi declinazionali della congiunzione e dell'opposizione, e notando quando un corpo esce dai limiti.
POST /v1/vedic/dashas/vimshottari/maha
API Vimshottari Mahadasha
Vimshottari è il ciclo di 120 anni dei periodi planetari che fonda il timing vedico. Questo endpoint legge la posizione sidereale della Luna alla nascita, individua il nakshatra che occupa e da quel punto srotola la catena ordinata delle Mahadasha - i principali periodi di vita, ciascuno governato da uno dei nove graha - con le esatte date calendaristiche che li delimitano.
POST /v1/vedic-divisional
API Grafici Divisionali
I grafici Varga sono le lenti d'ingrandimento della Jyotish: ognuno suddivide ogni segno in un armonico scelto e ri-mappa i pianeti su una griglia più fine che parla di un dominio della vita. Questo endpoint prende un momento di nascita e una divisione richiesta - D1 fino a D60 - e restituisce dove cada pianeta cade in quel varga.
POST /v1/vedic/varshaphal
Carta annuale Tajika (Varshaphal)
La carta vedica per un anno di vita, calcolata nel momento in cui il Sole sidereale ritorna alla sua longitudine natale. Restituisce l'entrata dell'anno al secondo, la carta annuale, il muntha con la sua casa e il suo signore, la forza quintuplice per tutti e sette i graha, i cinque candidati da cui viene scelto il signore dell'anno, e il signore dell'anno stesso secondo entrambe le letture supportate dalle fonti.
POST /v1/vedic/shadbala/full
Shadbala API
Shadbala - letteralmente 'forza sei volte' - è il modo classico per quantificare quanto un pianeta può effettivamente mantenere le sue promesse in un oroscopo. Questo endpoint calcola la forza totale di ogni graha come somma delle sue sei componenti balas, restituendo un punteggio per pianeta in rupas così puoi classificare i pianeti in base a quanto sono posizionati per agire.
POST /v1/numerology/pythagorean/life-path
API di Numerologia
Questo endpoint calcola il numero del Percorso di Vita Pitagorico – la singola cifra che condensa una data di nascita nella sua firma numerologica di base. È un calcolo all'interno di una suite più ampia che copre quattro sistemi e circa dieci calcoli ciascuno, e funziona come pura aritmetica senza ephemeris né astrologia.
POST /v1/tarot/rider-waite/draw/three-card
API Tarocchi
Questo endpoint esegue un tiraggio riproducibile con seed dal mazzo di 78 carte Rider-Waite-Smith per il tiraggio di tre carte. Restituisce i metadati del tiraggio, il seed intero che ha governato il mescolamento e le carte estratte con le loro posizioni, orientamenti e significati - in modo che qualsiasi lettura possa essere riprodotta esattamente passando nuovamente il seed.
POST /v1/bazi/chart
API BaZi (Quattro Pilastri)
Un momento di nascita in tutto l'apparato classico: quattro pilastri, gli steli che ogni ramo ospita, na yin, le dodici fasi della vita, l'equilibrio degli elementi su tutti gli otto caratteri, un giudizio di forza del framework nominato, le stelle simboliche e le interazioni tra ramo e stelo. Una chiamata, JSON in uscita, 21 lingue.
POST /v1/human-design
API di Design Umano
Questo endpoint calcola il bodygraph di Design Umano da un singolo evento di nascita. Combina il grafico della Personalità natale con il grafico del Design - preso circa 88° di arco solare prima della nascita, circa tre mesi prima - e deriva gli elementi meccanici del bodygraph: Tipo, Strategia, Autorità, Profilo, Centri, Canali, Porte e la Croce Incarnazionale.
POST /v1/horoscope/daily
API Oroscopo AI
Questo endpoint genera un oroscopo giornaliero scritto per un segno zodiacale in una data specificata chiamando il nostro gateway LLM. Restituisce il testo dell'oroscopo, una dichiarazione di non responsabilità, il modello che lo ha generato e la lingua dell'output. A differenza degli endpoint di calcolo, fornisce una guida generata anziché un risultato deterministico.
POST /v1/chinese/zodiac/compatibility
API di compatibilità dello zodiaco cinese
Due date di nascita in entrata, una corrispondenza valutata in uscita, basata sulla geometria dei dodici rami anziché su una tabella di opinioni. L'animale dell'anno viene determinato al preciso momento Li Chun, quindi una nascita a febbraio corrisponde all'animale a cui effettivamente appartiene.
POST /v1/chinese/feng-shui/flying-star
API del feng shui delle stelle volanti (Xuan Kong)
Una direzione di fronte e un periodo di costruzione producono la completa carta delle stelle volanti a nove palazzi: la stella del periodo, la stella della montagna e la stella di fronte in ciascuno dei nove settori, con l'elemento, la natura e il significato di ognuna.
POST /v1/chinese/tong-shu/select
API di selezione data Tong Shu
Scansiona una finestra di giorni e ricevi solo quelli che l'almanac approva per un'impresa specifica, con il motivo per cui ogni sopravvissuto è stato mantenuto e un conteggio di cosa è stato scartato e perché.
POST /v1/chinese/true-solar-time
API tempo solare vero
L'orologio sul muro e il sole sul luogo di nascita sono due orari diversi, e in un fuso orario ampio si discostano di ore. Questo endpoint restituisce il secondo, scomposto in modo da poter vedere da dove provenga ogni minuto.
POST /v1/ziwei/chart
Zi Wei Dou Shu (Stella Viola) API
Una data di nascita, un'ora e un sesso producono l'intero grafico: dodici palazzi con i loro tronchi, tutte le quattordici stelle principali, le ausiliarie, trentuno stelle minori, i dodici stadi della vita, i limiti decennali e le quattro trasformazioni segnate sulle stelle che le portano.