chinese

BaZi Compatibility (八字合婚)

Assess the compatibility between two BaZi charts using Six Harmonies (六合), Three Harmonies (三合), Six Clashes (六冲), Six Harms (六害), and Day Master element interactions.

Returns a 0–100 composite score, an assessment label (excellent / good / moderate / challenging), and a list of specific factors found.

Note: The 0–100 scoring is an Open Ephemeris algorithmic interpretation. BaZi compatibility analysis is nuanced and multi-layered; this endpoint provides a structured starting point.

Metering: 3 units per call.

post/chinese/bazi/compatibility

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/chinese/bazi/compatibility
  • Auth: one of:
    • HTTP bearer
    • API key in header X-OpenEphemeris-API-Key
    • API key in header X-API-Key
    • API key in header X-Service-Key

Request body

Example request

{
  "chart_a": {
    "day": 15,
    "hour": 8,
    "latitude": 31.2304,
    "longitude": 121.4737,
    "minute": 30,
    "month": 1,
    "timezone": {
      "iana_name": "America/New_York"
    },
    "year": 1990
  },
  "chart_b": {
    "day": 15,
    "hour": 8,
    "latitude": 31.2304,
    "longitude": 121.4737,
    "minute": 30,
    "month": 1,
    "timezone": {
      "iana_name": "America/New_York"
    },
    "year": 1990
  }
}

Response

Compatibility score, assessment, and contributing factors.

assessment'excellent' | 'good' | 'moderate' | 'challenging' required
scoreinteger required
successboolean
summary_notestring required

Changes

No recorded changes to this operation across all 1 revision of this API.