Synastry API
Compare deux cartes de naissance en un appel et récupère la grille des aspects croisés qui alimente chaque fonctionnalité de compatibilité – qui aspecte qui, sous quel angle, avec quel orbe, dans quelle direction. Deux cartes en entrée, la relation entre elles en sortie.
Synastry API
L'endpoint synastry calcule les deux cartes natales séparément, puis les superpose pour trouver les aspects inter-chartes : chaque relation angulaire où une planète du graphique A rencontre une planète du graphique B dans l’orbe. Chaque aspect croisé est renvoyé avec les deux corps nommés, le type d’aspect (conjonction, sextile, carré, trigone, opposition et les angles mineurs), l’orbe exact, et la direction du contact pour que tu saches quel Vénus trigone quel Mars. L’ensemble complet des planètes pour les deux sujets est également retourné, afin que tu puisses afficher une bi-roue ou alimenter un scoreur de compatibilité sans un second aller-retour.
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
C’est l’endpoint principal pour les applis de rencontres et de matchmaking, les produits de rapports relationnels, et toute fonctionnalité qui répond à « comment ces deux personnes se rapportent-elles ? ». Associe-le à notre helper de scoring de compatibilité pour transformer les aspects croisés bruts en un pourcentage unique, ou envoie la grille à un LLM pour obtenir une lecture écrite de la relation. Parce que les deux cartes sont retournées en entier, un appel synastry remplace trois (deux cartes natales + la superposition) – calcule-le une fois et mets le résultat en cache avec les deux moments de naissance comme clé. La méthode suit Robert Hand et Stephen Arroyo ; les techniques composite et Davison midpoint sont disponibles sur leurs propres endpoints quand tu as besoin d’une carte fusionnée unique au lieu d’une superposition.
Lance une synastrie entre deux personnes dans un navigateur →
Notes
Les aspects croisés utilisent la même politique d’orbe que la grille d’aspects natale. Les deux sujets acceptent le jeu complet de paramètres /v1/chart, y compris le système de maisons et le décalage horaire par sujet. Synastry est un endpoint Tier 3 (deux cartes + une superposition) ; mets en cache agressivement car le résultat est totalement déterministe pour une paire donnée de moments de naissance.
Try the Synastry API
Grab a key and make your first call in under a minute.