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.
API Sinastria
L'endpoint sinastria calcola entrambi i temi natali in modo indipendente, poi li sovrappone per trovare gli aspetti inter-chart: ogni relazione angolare in cui un pianeta nel chart A incontra un pianeta nel chart B entro l'orb. Ogni cross-aspect viene restituito con entrambi i corpi nominati, il tipo di aspetto (conjunction, sextile, square, trine, opposition e gli angoli minori), l'orb esatto e la direzione del contatto così sai a chi appartiene il Venus che trina il Mars dell'altro. I set completi di pianeti per entrambi i soggetti vengono restituiti insieme, così puoi renderizzare un bi-wheel o alimentare un compatibility scorer senza un secondo round-trip.
POST/v1/synastry
curl -X POST https://api.astroway.info/v1/synastry \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"chart1": { "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 },
"chart2": { "date": "1985-11-03", "time": "08:15:00", "timezoneOffset": 2, "latitude": 48.46, "longitude": 35.04 }
}'{
"ok": true,
"data": {
"crossAspects": [
{ "planet1": "Venus", "planet2": "Mars", "type": "trine", "orb": 0.8, "direction": "A→B" }
],
"chart1": { "input": { ... }, "planets": [ ... ] },
"chart2": { "input": { ... }, "planets": [ ... ] }
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| chart1 | object | yes | First subject - same shape as /v1/chart (date, time, timezoneOffset, latitude, longitude). |
| chart2 | object | yes | Second subject - identical shape. |
| chart1.name / chart2.name | string | no | Optional labels echoed back so you can tell the two subjects apart in the response. |
When to use it
Questo è l'endpoint principale per app di dating e matchmaking, prodotti di report relazionali, e qualsiasi funzionalità che risponde a "come si relazionano queste due persone?". Abbinalo al nostro helper di compatibility-scoring per trasformare i raw cross-aspects in una percentuale unica, o passa la griglia a un LLM per una lettura scritta della relazione. Poiché entrambi i chart vengono restituiti completi, una chiamata sinastria sostituisce tre (due natal chart più l'overlay) – calcolala una volta e cachea il risultato indicizzato sui due momenti di nascita. Il metodo segue Robert Hand e Stephen Arroyo; le tecniche composite e Davison midpoint hanno i loro endpoint quando ti serve un chart unico fuso invece di un overlay.
Notes
I cross-aspects usano la stessa politica orb del natal aspect grid. Entrambi i soggetti accettano il set completo di parametri /v1/chart, inclusi il sistema di case per soggetto e il fuso orario. La sinastria è un endpoint Tier 3 (due chart + una scansione overlay); cachea aggressivamente perché il risultato è completamente deterministico per una data coppia di momenti di nascita.
Try the Sinastria API
Grab a key and make your first call in under a minute.