# Chinese Zodiac Compatibility Matcher

> Chinese Zodiac Compatibility Matcher is a paid API for AI agents from api.cn402.com, paid per call via x402, $0.016/call, status unknown (last checked 2026-09-13).

Computes a compatibility score and analysis between two Chinese zodiac animals (e.g., Rat and Dragon)

## Facts

- Endpoint: GET https://api.cn402.com/folk/match-zodiac
- Price: $0.016/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-cn402-com-b186109f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WraYhauffT-Y33LOWmHWv

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-cn402-com-b186109f
```

Example prompt: Can you check the Chinese zodiac compatibility between a Rat and a Horse — I want to know the match score and what it means for a romantic relationship?

## When to prefer this

Use this endpoint when you need Chinese zodiac (生肖) compatibility specifically — i.e., based on the 12 animal cycle (Rat, Ox, Tiger, Rabbit, Dragon, Snake, Horse, Goat, Monkey, Rooster, Dog, Pig) — rather than Western sun-sign astrology or BaZi chart analysis. Best for love, marriage, or relationship compatibility queries rooted in traditional Chinese cultural astrology.

## Known failure modes

- Invalid zodiac animal name provided — endpoint may return error if animal is not one of the 12 recognized Chinese zodiac signs
- Missing one or both animal inputs — returns validation error
- Unrecognized animal variant (e.g., Western zodiac sign instead of Chinese) — may return null or error result
- Network or payment failure (x402 protocol) — returns 402 if payment not processed

## How this service works

Zodiac compatibility, Chinese zodiac matching, 生肖配对, Chinese astrology compatibility, 12 animal signs matching, 属相相配, Chinese horoscope compatibility, zodiac match score, Chinese zodiac love compatibility. Compute compatibility score and analysis between two Chinese zodiac animals (rat/ox/tiger/...).

## Output

Returns a compatibility score and written analysis describing how well the two Chinese zodiac animals (e.g., Rat and Dragon) get along, including relationship insights and any auspicious or inauspicious notes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "z1": {
   "type": "string",
   "description": "Z1 (required)"
  },
  "z2": {
   "type": "string",
   "description": "Z2 (optional)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-cn402-com-b186109f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.cn402.com](https://www.zero.xyz/host/api.cn402.com/llms.txt)