Synastry API
Bandingkan dua birth chart dalam satu panggilan dan dapatkan grid cross-aspect yang menggerakkan setiap fitur kompatibilitas – siapa yang mengaspek siapa, dengan sudut berapa, dengan orb berapa, dalam arah apa. Dua chart masuk, hubungan di antara mereka keluar.
Synastry API
Endpoint synastry menghitung kedua natal chart secara terpisah, lalu menumpuknya untuk menemukan inter-chart aspects: setiap hubungan sudut di mana planet di chart A bertemu planet di chart B dalam orb. Setiap cross-aspect dikembalikan dengan nama kedua benda, tipe aspek (conjunction, sextile, square, trine, opposition dan sudut minor), orb yang tepat, dan arah kontak sehingga kamu tahu Venus siapa yang trining Mars siapa. Set lengkap planet untuk kedua subjek juga dikembalikan, jadi kamu bisa menampilkan bi-wheel atau memberi ke compatibility scorer tanpa panggilan tambahan.
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
Ini adalah backbone endpoint untuk aplikasi dating dan matchmaking, produk laporan hubungan, dan fitur apa pun yang menjawab "bagaimana dua orang ini berhubungan?". Padukan dengan compatibility-scoring helper kami untuk mengubah cross-aspect mentah menjadi persentase tunggal, atau kirim grid ke LLM untuk bacaan hubungan tertulis. Karena kedua chart dikembalikan lengkap, satu synastry call menggantikan tiga (dua natal chart plus overlay) – hitung sekali dan cache hasilnya dengan kunci dua momen kelahiran. Metode mengikuti Robert Hand dan Stephen Arroyo; teknik composite dan Davison midpoint ada di endpoint masing-masing bila kamu butuh satu chart gabungan alih-alih overlay.
Notes
Cross-aspect menggunakan kebijakan orb yang sama seperti natal aspect grid. Kedua subjek menerima set parameter /v1/chart lengkap, termasuk sistem rumah per-subjek dan offset zona waktu. Synastry adalah Tier 3 endpoint (dua chart + overlay scan); cache secara agresif karena hasilnya sepenuhnya deterministik untuk pasangan momen kelahiran tertentu.
Try the Synastry API
Grab a key and make your first call in under a minute.