AstroWay/api v2.202.3 · fr
tous les systèmes sont opérationnels
// astrology api · POST /v1/synastry

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.

Endpoint
POST /v1/synastry
Cost
50 credits
Latency
~250 ms
Tier
Tier 3
// 01 / What it computes

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.

// 02 / Live request

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 }
  }'
Response (excerpt)
{
  "ok": true,
  "data": {
    "crossAspects": [
      { "planet1": "Venus", "planet2": "Mars", "type": "trine", "orb": 0.8, "direction": "A→B" }
    ],
    "chart1": { "input": { ... }, "planets": [ ... ] },
    "chart2": { "input": { ... }, "planets": [ ... ] }
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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.
// 04 / When to use it

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 →

// 05 / Notes

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.

99,9% SLA · forfaits payants · 30 j statut →