Skip to content

Synastry & Composite Charts

Compare two natal charts for relationship analysis.

Synastry

Calculate aspects between two charts:

bash
curl -X POST "https://api.astroapi.cloud/api/calc/synastry" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "chart1": {
      "datetime": "1990-06-15T14:30:00",
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "chart2": {
      "datetime": "1988-03-22T09:15:00",
      "latitude": 48.8566,
      "longitude": 2.3522,
      "timezone": "Europe/Paris"
    }
  }'

Response

json
{
  "data": {
    "type": "synastry",
    "attributes": {
      "aspects": [
        {
          "planet1": "sun",
          "chart1": true,
          "planet2": "moon",
          "chart2": true,
          "aspect": "trine",
          "orb": 2.3
        }
      ],
      "houseOverlays": {
        "chart1InChart2": {
          "sun": 7,
          "moon": 4
        },
        "chart2InChart1": {
          "sun": 10,
          "moon": 1
        }
      }
    }
  }
}

Composite Charts

Generate a composite (midpoint) chart:

bash
curl -X POST "https://api.astroapi.cloud/api/calc/composite" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "chart1": {
      "datetime": "1990-06-15T14:30:00",
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "chart2": {
      "datetime": "1988-03-22T09:15:00",
      "latitude": 48.8566,
      "longitude": 2.3522,
      "timezone": "Europe/Paris"
    },
    "compositeLocation": {
      "latitude": 50.1234,
      "longitude": 1.5678
    }
  }'

Davison Chart

Calculate a Davison relationship chart (time-space midpoint):

bash
curl -X POST "https://api.astroapi.cloud/api/calc/davison" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "chart1": { ... },
    "chart2": { ... }
  }'

Aspect Scoring

Get a compatibility score based on synastry aspects:

bash
curl -X POST "https://api.astroapi.cloud/api/calc/synastry/score" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "chart1": { ... },
    "chart2": { ... },
    "weights": {
      "sun": 10,
      "moon": 10,
      "venus": 8,
      "mars": 7
    }
  }'

AstroAPI Documentation