Back to Docs

BaZi Compatibility (Synastry)

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://api.freeastroapi.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

Field
person_a
Type
object
Required
Yes
Description
Full BaziRequest object for Person A
Field
person_b
Type
object
Required
Yes
Description
Full BaziRequest object for Person B
Note: The person_a and person_b objects accept standard Bazi Request fields including calendar (gregorian or julian), time_standard, and tz_str. Each person's calendar and time settings are applied independently.

Sample Code

curl -X POST "https://api.freeastroapi.com/api/v1/chinese/bazi/synastry" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
    "person_a": {
        "year": 1990, "month": 5, "day": 15, "hour": 10, "minute": 30,
        "lat": 28.6139, "lng": 77.2090, "sex": "M",
        "calendar": "gregorian", "time_standard": "civil", "tz_str": "Asia/Kolkata"
    },
    "person_b": {
        "year": 1992, "month": 8, "day": 20, "hour": 14, "minute": 15,
        "lat": 40.7128, "lng": -74.0060, "sex": "F",
        "calendar": "gregorian", "time_standard": "civil", "tz_str": "America/New_York"
    }
}'

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
  }
}