> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sajuapi.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 궁합 계산

> 두 사주 간의 궁합 분석

두 사람의 사주를 비교하여 궁합을 분석합니다. 일간 관계, 오행 조화, 강점/약점, 투자 파트너십 조언을 제공합니다.

## 요청

<ParamField body="person1" type="object" required>
  첫 번째 사람의 생년월일시 정보

  <Expandable title="person1 속성">
    <ParamField body="birth_date" type="string" required>
      생년월일 (YYYY-MM-DD 형식)
    </ParamField>

    <ParamField body="birth_time" type="string">
      태어난 시간 (HH:MM 형식, 00:00-23:59)
    </ParamField>

    <ParamField body="gender" type="string" default="male">
      성별 (`male` 또는 `female`)
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="person2" type="object" required>
  두 번째 사람의 생년월일시 정보

  <Expandable title="person2 속성">
    <ParamField body="birth_date" type="string" required>
      생년월일 (YYYY-MM-DD 형식)
    </ParamField>

    <ParamField body="birth_time" type="string">
      태어난 시간 (HH:MM 형식, 00:00-23:59)
    </ParamField>

    <ParamField body="gender" type="string" default="male">
      성별 (`male` 또는 `female`)
    </ParamField>
  </Expandable>
</ParamField>

## 응답

```json theme={null}
{
  "success": true,
  "data": {
    "overall_score": 78,
    "day_master_compatibility": {
      "person1": {
        "stem": "丙",
        "name": "병화",
        "element": "fire",
        "element_kr": "화"
      },
      "person2": {
        "stem": "庚",
        "name": "경금",
        "element": "metal",
        "element_kr": "금"
      },
      "relation": {
        "type": "controls",
        "description": "화가 금을 극하여 주도권 다툼이 있을 수 있습니다.",
        "score": 65
      }
    },
    "element_harmony": {
      "score": 72,
      "complementary_elements": ["목", "수"],
      "conflicting_elements": []
    },
    "strengths": [
      "서로의 관점을 존중하면 좋은 결과를 얻을 수 있어요",
      "목, 수 기운이 서로를 보완해요",
      "추진력과 판단력이 시너지를 낼 수 있어요"
    ],
    "challenges": [
      "주도권 다툼이 생길 수 있어서 역할 분담이 중요해요",
      "성급한 결정과 감정적 판단에 함께 주의하세요"
    ],
    "investment_compatibility": {
      "score": 80,
      "advice": "공동 투자 시 역할 분담이 중요해요. 화 기운의 추진력과 금 기운의 판단력을 활용하세요.",
      "role_person1": "기회 포착과 진입 타이밍",
      "role_person2": "손절과 리스크 관리"
    }
  },
  "meta": {
    "requestId": "req_xyz789",
    "durationMs": 512,
    "cached": false
  }
}
```

### 응답 필드 설명

| 필드                         | 설명                     |
| -------------------------- | ---------------------- |
| `overall_score`            | 종합 궁합 점수 (0-100)       |
| `day_master_compatibility` | 일간 궁합 분석 - 두 사람의 일간 관계 |
| `element_harmony`          | 오행 조화 점수 및 보완/충돌 요소    |
| `strengths`                | 관계의 강점들                |
| `challenges`               | 주의할 점들                 |
| `investment_compatibility` | 투자 파트너십 점수와 역할 분담 조언   |

### 일간 관계 유형 (`relation.type`)

| 유형              | 설명                      |
| --------------- | ----------------------- |
| `same`          | 같은 오행 - 서로 깊이 이해        |
| `generates`     | 상생 (생해주는 관계) - 성장 도움    |
| `generated_by`  | 상생 (생 받는 관계) - 지원받음     |
| `controls`      | 상극 (극하는 관계) - 주도권 갈등 가능 |
| `controlled_by` | 상극 (극 받는 관계) - 제약 가능    |

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.sajuapi.dev/v1/calculations/compatibility \
    -H "X-API-Key: your-api-key" \
    -H "Content-Type: application/json" \
    -d '{
      "person1": {
        "birth_date": "1994-12-30",
        "birth_time": "17:01",
        "gender": "male"
      },
      "person2": {
        "birth_date": "1996-05-15",
        "birth_time": "09:30",
        "gender": "female"
      }
    }'
  ```
</RequestExample>