Synastrie API
Vergelijk twee geboortehoroscopen in één aanroep en krijg het kruis-aspectenraster dat elke compatibiliteitsfunctie aandrijft - wie aspecteert wie, onder welke hoek, met welke orb, in welke richting. Twee horoscopes in, de relatie tussen ze uit.
Synastrie API
Het synastrie-eindpunt berekent beide geboortehoroscopes onafhankelijk, legt ze vervolgens over elkaar om inter-horoscope-aspecten te vinden: elke hoekrelatie waarbij een planeet in horoscoop A een planeet in horoscoop B binnen de orb ontmoet. Elk kruis-aspect wordt geretourneerd met beide lichamen benoemd, het aspecttype (conjunctie, sextiel, vierkant, driehoek, oppositie en de kleine hoeken), de exacte orb, en de richting van contact zodat je weet wiens Venus wiens Mars trineert. De volledige planetensets voor beide onderwerpen komen terug, zodat je een bi-wiel kunt renderen of een compatibiliteitscore kunt voeden zonder een tweede heen-en-weerreis.
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
Dit is het kern-eindpunt voor dating- en matchmaking-apps, relatie-rapportproducten, en elke functie die het antwoord geeft op "hoe verhouden deze twee mensen zich tot elkaar?". Koppel het aan onze compatibiliteitsscore-hulp om de ruwe kruis-aspecten om te zetten in één percentage, of geef het raster door aan een LLM voor een geschreven relatieanalyse. Omdat beide horoscopes volledig worden geretourneerd, vervangt één synastrie-aanroep drie (twee geboortehoroscopes plus de overlay) - bereken het een keer en cache het resultaat met sleutels gebaseerd op de twee geboortemomenten. De methode volgt Robert Hand en Stephen Arroyo; de composite- en Davison-middentechnieken hebben hun eigen eindpunten wanneer je één samengevoegde horoscoop nodig hebt in plaats van een overlay.
Notes
Kruis-aspecten gebruiken hetzelfde orb-beleid als het natale aspectraster. Beide onderwerpen accepteren de volledige /v1/chart parameter set, inclusief per-onderwerp huizensysteem en tijdszone-offset. Synastrie is een Tier 3-eindpunt (twee horoscopes + een overlay-scan); cache agressief omdat het resultaat volledig deterministisch is voor een bepaald paar geboortemomenten.
Try the Synastrie API
Grab a key and make your first call in under a minute.