Back to Docs

BaZi Compatibility (Synastry)

POST/api/v1/chinese/bazi/synastry

A professional-grade Synastry engine that goes beyond simple Zodiac matching. It analyzes Day Master dynamics (reciprocity), Spouse Palace wiring (punishments/harms), elemental resource supply (needs vs drains), and hidden karmic connections.

Full URL

https://astro-api-1qnc.onrender.com/api/v1/chinese/bazi/synastry

Engine Capabilities

Day Master Reciprocity

Analyzes 'Giver vs Receiver' dynamics beyond simple matches

Spouse Palace Deep Dive

Checks for Harm, Punishment, and shared resonance

Evaluative Element Supply

Checks if partners trigger 'Draining' or 'Supportive' flows

Conflict Synthesis

Narrative summary of destructive patterns (e.g. 'Internalized Tension')

Hidden Interaction Scan

Detects karmic links hidden inside branches

Request Parameters

ParameterTypeRequiredDescription
person_aobjectYesFull BaziRequest object for Person A
person_bobjectYesFull BaziRequest object for Person B
Note: The person_a and person_b objects accept standard Bazi Request fields (year, month, day, hour, lat/lng, sex, etc.).

Sample Code

import requests
import json

url = "https://astro-api-1qnc.onrender.com/api/v1/chinese/bazi/synastry"

# Two full profiles required
payload = {
    "person_a": {
        "year": 1990,
        "month": 5,
        "day": 15,
        "hour": 10,
        "minute": 30,
        "lat": 28.6139,
        "lng": 77.2090,
        "city": "Person A",
        "sex": "M"
    },
    "person_b": {
        "year": 1992,
        "month": 8,
        "day": 20,
        "hour": 14,
        "minute": 15,
        "lat": 40.7128,
        "lng": -74.0060,
        "city": "Person B",
        "sex": "F"
    }
}

headers = {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

Response Data

{
  "score": 78,
  "overall_compatibility": "Highly Compatible",
  "score_breakdown": {
    "day_master": 23.8,
    "spouse_palace": 15,
    "pillars": 22.5,
    "elements": 12,
    "hidden_bonus": 4.5
  },
  
  "day_master_analysis": {
    "dm_a": "甲",
    "dm_b": "己",
    "relation": "Combination (Attraction)",
    "score": 95,
    "description": "Strong magnetic attraction. 甲-己 combine to form Earth.",
    "dynamic": "Destined"
  },
  
  "spouse_palace_analysis": {
    "branch_a": "子",
    "branch_b": "丑",
    "interaction": "Six-Harmony",
    "score": 65,
    "description": "Day Branches 子 and 丑: Six-Harmony.",
    "type": "Harmony"
  },
  
  "element_analysis": {
    "score": 80,
    "details": [
      "Person B has strong Water (60%) to support Person A.",
      "Person A provides moderate Wood support to Person B."
    ],
    "a_needs": "Water",
    "b_needs": "Wood"
  },
  
  "conflict_scan": {
    "clashes": 0,
    "harms": 0,
    "punishments": 0,
    "destructions": 0
  },
  
  "conflict_summary": "No major destructive interactions detected. Structurally stable.",
  
  "hidden_interactions": {
    "connections": [
      "Hidden Stem 己 (Person B) combines with Person A's Day Master 甲 (Attraction)."
    ],
    "count": 1
  }
}