Synastry API

synastry endpoint는 두 natal chart를 독립적으로 계산하고, 그 뒤에 겹쳐서 inter-chart aspects를 찾아. 차트 A의 planet이 차트 B의 planet과 orb 안에서 만나는 모든 각 관계야. 각 cross-aspect는 두 천체 이름, aspect type (conjunction, sextile, square, trine, opposition and the minor angles), 정확한 orb, 그리고 direction of contact을 함께 반환해, 그래서 어느 Venus가 어느 Mars와 trine하는지 알 수 있어. 두 대상의 전체 planet 세트도 함께 반환되니, bi-wheel을 그리거나 compatibility scorer에 바로 넣을 수 있어, 두 번째 라운드 트립 없이.

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": [ ... ] }
  }
}

이건 데이팅·매칭 앱, 관계 보고서 제품, 그리고 "두 사람이 어떻게 연결돼?" 같은 기능을 위한 핵심 endpoint야. 우리 compatibility-scoring helper와 같이 쓰면 raw cross-aspects를 하나의 퍼센트로 바꿀 수 있고, grid를 LLM에 넘겨서 글로 된 관계 해석을 받을 수도 있어. 두 차트가 전체로 반환되니, 한 번의 synastry call이 세 번(두 natal chart와 overlay) 대신이야 - 한 번 계산하고 두 출생 순간을 키로 결과를 캐시해. 방법은 Robert Hand와 Stephen Arroyo를 따르고; composite와 Davian midpoint 기술은 별도 endpoint에 있어, overlay 대신 하나의 합쳐진 차트가 필요할 때 쓰면 돼.

브라우저에서 두 사람의 synastry를 실행해 →

Cross-aspects는 natal aspect grid와 같은 orb 정책을 사용해. 두 피험자는 전체 /v1/chart 파라미터 세트를 받아, 각 피험자별 house system과 timezone offset을 포함해. Synastry는 Tier 3 endpoint(두 차트 + overlay scan)야; 결과가 주어진 출생 순간 쌍에 대해 완전히 결정적이니 캐시를 적극적으로 해.