# Chinese Zodiac Compatibility (生肖配对)

> Lists the traditional earthly-branch relations between two Chinese zodiac animals: 六合 (liùhé, six harmonies / secret friends), 三合 (sānhé, trines), 六冲 (liùchōng, clashes), 六害 (liùhài, harms), 相刑 (xiāngxíng, punishments), 相破 (xiāngpò, breaks) and 比和 (same sign), with each animal's trine group, fixed element and polarity.

- Calculator id: `zodiac-compatibility` · Category: Chinese Calendar (`lunar`) · Tool name: `check_chinese_zodiac_compatibility`
- Canonical page: https://tttkmbb.com/lunar/zodiac-compatibility · This document: https://tttkmbb.com/lunar/zodiac-compatibility.md · JSON definition: https://tttkmbb.com/lunar/zodiac-compatibility.json

## Purpose

Lists the traditional earthly-branch relations between two Chinese zodiac animals: 六合 (liùhé, six harmonies / secret friends), 三合 (sānhé, trines), 六冲 (liùchōng, clashes), 六害 (liùhài, harms), 相刑 (xiāngxíng, punishments), 相破 (xiāngpò, breaks) and 比和 (same sign), with each animal's trine group, fixed element and polarity.

**Use when:** You need the classical relation between two zodiac signs (e.g. Rat and Ox are 六合, Rat and Horse are 六冲) or the trine group and fixed element of a sign.

**Do not use when:** You need someone's zodiac sign from a birth date (use chinese-zodiac first) or a full birth-chart comparison (use bazi-four-pillars); the relations are traditional attributions, not relationship advice.

## Input

| Parameter | Type | Unit | Required | Description |
| --- | --- | --- | --- | --- |
| `zodiac_a` | enum: rat \| ox \| tiger \| rabbit \| dragon \| snake \| horse \| goat \| monkey \| rooster \| dog \| pig |  | required | Chinese zodiac animal (English name, Chinese character, or earthly branch such as 子/zi). |
| `zodiac_b` | enum: rat \| ox \| tiger \| rabbit \| dragon \| snake \| horse \| goat \| monkey \| rooster \| dog \| pig |  | required | Chinese zodiac animal (English name, Chinese character, or earthly branch such as 子/zi). |

## Output

| Field | Type | Unit | Description |
| --- | --- | --- | --- |
| `animal_a` | string |  | First animal with its Chinese character and branch. |
| `animal_b` | string |  | Second animal with its Chinese character and branch. |
| `relations` | string_list |  | All classical branch relations that apply to the pair (a pair can have several, e.g. 寅亥 is both 六合 and 相破). |
| `summary_level` | string |  | harmonious (六合/三合), conflicting (六冲), challenging (六害/相刑/相破), same sign (比和) or neutral. |
| `trine_group_a` | string |  | Three-harmony group and its element for the first animal. |
| `trine_group_b` | string |  | Three-harmony group and its element for the second animal. |
| `fixed_element_a` | string |  | Element of the first animal's branch. |
| `fixed_element_b` | string |  | Element of the second animal's branch. |
| `yin_yang_a` | string |  | Yin or Yang of the first branch. |
| `yin_yang_b` | string |  | Yin or Yang of the second branch. |
| `element_relation` | string |  | Generating, controlling or same relation between the two fixed elements. |
| `explanation` | string |  | Two sentences describing what the tradition assigns to this pairing. |
| `disclaimer` | string |  | Cultural reference note. |

## Formula

`六合: (a + b) mod 12 = 1; 三合: a ≡ b (mod 4), a ≠ b; 六冲: |a − b| = 6; 六害: (a + b) mod 12 = 7; 相破: 子酉 丑辰 寅亥 卯午 巳申 未戌; 相刑: 子卯, 寅巳 巳申 寅申, 丑戌 戌未 丑未, self-punishment 辰 午 酉 亥; 比和: a = b (branch indices 子 = 0 … 亥 = 11)`

Relations are the standard earthly-branch (地支) relations of the Chinese calendar tradition; fixed elements follow the branch elements (子 Water, 丑 Earth, 寅卯 Wood, 辰 Earth, 巳午 Fire, 未 Earth, 申酉 Metal, 戌 Earth, 亥 Water). Traditional reference calculation of the Chinese calendar tradition; not a prediction and not medical, legal or financial advice.

## Data Sources

- Chinese zodiac – compatibility, trines and fixed elements (Wikipedia) — https://en.wikipedia.org/wiki/Chinese_zodiac (reference, retrieved 2026-09-24)
- Earthly Branches (Wikipedia) — https://en.wikipedia.org/wiki/Earthly_Branches (reference, retrieved 2026-09-24)
- Wuxing – five phases and their generating/overcoming cycles (Wikipedia) — https://en.wikipedia.org/wiki/Wuxing_(Chinese_philosophy) (reference, retrieved 2026-09-24)

Data freshness: `static`. Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output.

## API

- `GET https://tttkmbb.com/api/v1/calculate/zodiac-compatibility?zodiac_a=…&zodiac_b=…`
- `POST https://tttkmbb.com/api/v1/calculate/zodiac-compatibility` with JSON body `{"inputs": {…}}`
- Response: unified envelope (`success`, `request`, `result.values`, `result.units`, `sources`, `freshness`, `timestamp`, `next_actions`, `links`); see https://tttkmbb.com/docs/response-format.md
- Schema: https://tttkmbb.com/api/v1/calculators/zodiac-compatibility · OpenAPI operationId `check_chinese_zodiac_compatibility` in https://tttkmbb.com/openapi.json
- Authentication: none. Rate limit: fair use, see https://tttkmbb.com/docs/rate-limits.md.

## MCP

- Server: `https://tttkmbb.com/mcp` (Streamable HTTP, JSON-RPC 2.0, no auth)
- Tool:  `run_calculator` with `{"calculator_id": "zodiac-compatibility", "inputs": {…}}`

## Example

- Rat and Ox (六合): inputs `{"zodiac_a":"rat","zodiac_b":"ox"}` → `{"relations":["六合 (Liuhe, six harmonies / secret friend)"],"summary_level":"harmonious","trine_group_a":"申子辰 Monkey–Rat–Dragon (Water trine)","trine_group_b":"巳酉丑 Snake–Rooster–Ox (Metal trine)","fixed_element_a":"Water (水)","fixed_element_b":"Earth (土)","yin_yang_a":"Yang","yin_yang_b":"Yin","element_relation":"Earth (土) controls Water (水) — 相克: B's element controls A's"}`
- Tiger and Horse (三合 Fire trine): inputs `{"zodiac_a":"tiger","zodiac_b":"horse"}` → `{"relations":["三合 (Sanhe, three harmonies / trine)"],"summary_level":"harmonious","trine_group_a":"寅午戌 Tiger–Horse–Dog (Fire trine)","fixed_element_a":"Wood (木)","fixed_element_b":"Fire (火)","element_relation":"Wood (木) generates Fire (火) — 相生: A's element generates B's"}`

```
GET https://tttkmbb.com/api/v1/calculate/zodiac-compatibility?zodiac_a=rat&zodiac_b=ox
```

## Limitations

You need someone's zodiac sign from a birth date (use chinese-zodiac first) or a full birth-chart comparison (use bazi-four-pillars); the relations are traditional attributions, not relationship advice. Relations are the standard earthly-branch (地支) relations of the Chinese calendar tradition; fixed elements follow the branch elements (子 Water, 丑 Earth, 寅卯 Wood, 辰 Earth, 巳午 Fire, 未 Earth, 申酉 Metal, 戌 Earth, 亥 Water). Traditional reference calculation of the Chinese calendar tradition; not a prediction and not medical, legal or financial advice. All values are computed from the formula above; no measurement or live data is involved.

## FAQ

**Can two signs be both compatible and in conflict?**

Yes. Tiger and Pig (寅亥) are 六合 and also 相破; Snake and Monkey (巳申) are 六合, 相刑 and 相破. All applicable relations are listed and the summary follows the 六合/三合 harmony first.

**What is the difference between 六冲 and 六害?**

六冲 pairs opposite branches (six apart, e.g. Rat–Horse) and is the strongest clash; 六害 pairs branches whose 六合 partners clash (e.g. Rat–Goat) and is treated as a milder harm.

**Which animals are self-punishing?**

Dragon, Horse, Rooster and Pig (辰 午 酉 亥) form 自刑 with their own sign; the other same-sign pairs are plain 比和.

## Related

- [Chinese Zodiac Calculator (生肖)](https://tttkmbb.com/lunar/chinese-zodiac.md) — Find each person's animal from the birth date.
- [Zodiac Sign Calculator](https://tttkmbb.com/everyday/zodiac.md) — Western star sign for comparison.
- [Bazi Four Pillars (八字)](https://tttkmbb.com/lunar/bazi-four-pillars.md) — Full stem-branch chart of a birth moment.