Sinastria

El endpoint POST /v1/synastry compara dos cartas natales: calcula los cross-aspectos entre los planetas de ambas personas y devuelve una puntuación de compatibilidad. Coste: 50 créditos (Tier 3).

Parámetros de la solicitud

Dos objetos anidados chart1 y chart2, cada uno con los mismos parámetros que /v1/chart:

Parámetro	Tipo	Obligatorio	Descripción
chart1	object	Sí	Datos de la primera persona
chart2	object	Sí	Datos de la segunda persona

Cada objeto: date, time, timezoneOffset, latitude, longitude, houseSystem, name, city.

Ejemplo de solicitud

cURL

curl -X POST https://api.astroway.info/v1/synastry \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "chart1": {
      "date": "1990-07-14",
      "time": "14:30:00",
      "timezoneOffset": 3,
      "latitude": 50.4501,
      "longitude": 30.5234,
      "name": "Person A"
    },
    "chart2": {
      "date": "1992-03-22",
      "time": "09:15:00",
      "timezoneOffset": 2,
      "latitude": 48.8566,
      "longitude": 2.3522,
      "name": "Person B"
    }
  }'

Node.js

const body = {
  chart1: { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234, name: 'Person A' },
  chart2: { date: '1992-03-22', time: '09:15:00', timezoneOffset: 2, latitude: 48.8566, longitude: 2.3522, name: 'Person B' },
};
const res = await fetch('https://api.astroway.info/v1/synastry', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
  },
  body: JSON.stringify(body),
});
const { data: result } = await res.json();
console.log(result.compatibility);
console.log(result.crossAspects.length);

Python

import os, requests

body = {
    'chart1': {'date': '1990-07-14', 'time': '14:30:00', 'timezoneOffset': 3, 'latitude': 50.4501, 'longitude': 30.5234, 'name': 'Person A'},
    'chart2': {'date': '1992-03-22', 'time': '09:15:00', 'timezoneOffset': 2, 'latitude': 48.8566, 'longitude': 2.3522, 'name': 'Person B'},
}
r = requests.post(
    'https://api.astroway.info/v1/synastry',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json=body,
)
result = r.json()['data']
print(result['compatibility'])

PHP

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->post('synastry', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'chart1' => [
            'date' => '1990-07-14',
            'time' => '14:30:00',
            'timezoneOffset' => 3,
            'latitude' => 50.4501,
            'longitude' => 30.5234,
            'name' => 'Person A',
        ],
        'chart2' => [
            'date' => '1992-03-22',
            'time' => '09:15:00',
            'timezoneOffset' => 2,
            'latitude' => 48.8566,
            'longitude' => 2.3522,
            'name' => 'Person B',
        ],
    ],
]);

$result = json_decode($r->getBody(), true)['data'];
print_r($result['compatibility']);

Ejemplo de respuesta

{
  "chart1": {
    "input": { "date": "1990-07-14", "name": "Person A" },
    "planets": [ ... ],
    "houses": { ... },
    "aspects": [ ... ]
  },
  "chart2": {
    "input": { "date": "1992-03-22", "name": "Person B" },
    "planets": [ ... ],
    "houses": { ... },
    "aspects": [ ... ]
  },
  "crossAspects": [
    {
      "planet1": "Sun",
      "planet2": "Venus",
      "chart1Planet": "Sun",
      "chart2Planet": "Venus",
      "type": "trine",
      "orb": 2.14,
      "applying": false
    },
    {
      "planet1": "Moon",
      "planet2": "Mars",
      "chart1Planet": "Moon",
      "chart2Planet": "Mars",
      "type": "square",
      "orb": 0.87,
      "applying": true
    }
  ],
  "compatibility": {
    "score": 51,
    "label": "mixed",
    "harmony": 15.8,
    "tension": 16.8,
    "top": [
      { "aspect": { "planet1": "Venus", "planet2": "Moon", "type": { "name": "Square", "angle": 90 } }, "strength": 2.09, "sign": -1 }
    ]
  }
}

Nota

chart1 y chart2 - cartas natales completas (los mismos campos que en /v1/chart). crossAspects - aspectos entre los planetas de ambas cartas. compatibility.score - de 0 a 100.

Campo compatibility

Campo	Tipo	Descripción
score	number	Puntuación total 0–100
label	string	harmonious, balanced, mixed, challenging
harmony	number	Suma ponderada de los aspectos que el modelo consideró armoniosos
tension	number	Suma ponderada de los aspectos que el modelo consideró tensos
top	array	Los cinco aspectos más ponderados por puntuación, cada uno con strength y sign (1 armonía, -1 tensión)

Endpoints relacionados

Endpoint	Créditos	Qué añade
/v1/composite	50	Carta compuesta (puntos medios)
/v1/davison	50	Carta de Davison (fecha media)
/v1/coalescent	50	Carta coalescente
/v1/group-synastry	100	Matriz de compatibilidad de 2–10 personas
/v1/human-design/compatibility	100	Compatibilidad HD

Más

• Carta natal: solicitud básica
• Tránsitos: superposición de tránsitos
• Human Design: carta HD completa
• Referencia API: todos los 771 endpoints