> ## 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.

# 캐릭터 조회

> 사주 기반 투자 캐릭터 정보 조회

사주를 기반으로 한 투자 캐릭터 정보를 조회합니다. 사주가 변하지 않으므로 30일간 캐시됩니다.

## 요청

<ParamField query="birthDate" type="string" required>
  생년월일 (YYYY-MM-DD)
</ParamField>

<ParamField query="birthTime" type="string">
  태어난 시간 (HH:mm)
</ParamField>

<ParamField query="model" type="string" default="haiku">
  AI 모델 선택
</ParamField>

## 응답

```json theme={null}
{
  "success": true,
  "data": {
    "character": {
      "title": "물을 머금은 병화 태양",
      "dayMaster": "병화",
      "dayMasterHanja": "丙",
      "element": "火",
      "emoji": "☀️",
      "identity": "당신은 태양형이지만, 물이 받쳐주는 구조라 무작정 돌진하는 타입은 아닙니다.",
      "investmentIdentity": "혼자 빛나기보다, 시스템·조직 안에서 힘이 커지는 투자자입니다.",
      "elementBalance": {
        "wood": 2,
        "fire": 3,
        "earth": 1,
        "metal": 1,
        "water": 2
      }
    }
  },
  "meta": {
    "cached": true,
    "cacheTTL": "30d"
  }
}
```

## 위젯: AICharacterCard

```tsx theme={null}
function AICharacterCard({ character }) {
  return (
    <div className="character-card">
      <span className="character-emoji">{character.emoji}</span>
      <h2 className="character-title">{character.title}</h2>
      <p className="character-identity">{character.identity}</p>
      <p className="character-investment">{character.investmentIdentity}</p>
    </div>
  );
}
```

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.sajuapi.dev/v1/fortunes/character?birthDate=1994-12-30&birthTime=17:01" \
    -H "X-API-Key: your-api-key"
  ```
</RequestExample>