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

# 주간 운세

> 5일간의 운세 요약 및 최적/비추천 날짜

5일간의 운세를 요약하고, 최적의 날과 피해야 할 날을 알려줍니다.

## 요청

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

<ParamField body="startDate" type="string">
  주간 시작일 (기본값: 오늘)
</ParamField>

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

## 응답

```json theme={null}
{
  "success": true,
  "data": {
    "weekSummary": "이번 주는 화(火) 기운이 강해서 공격적으로 가도 되는 주간이에요.",
    "bestDay": {
      "date": "2026-01-23",
      "dayOfWeek": "목",
      "reason": "목요일에 금 기운이 들어와서 손절 타이밍 잡기 좋아요"
    },
    "worstDay": {
      "date": "2026-01-21",
      "dayOfWeek": "화",
      "reason": "화요일은 충동 매수 위험이 높아요"
    },
    "weeklyAction": "이번 주는 분할 매수 전략이 유리해요. 한 번에 들어가지 마세요.",
    "days": [
      { "date": "2026-01-20", "dayOfWeek": "월", "score": 72, "emoji": "😐", "shortTip": "관망" },
      { "date": "2026-01-21", "dayOfWeek": "화", "score": 58, "emoji": "😰", "shortTip": "자제" },
      { "date": "2026-01-22", "dayOfWeek": "수", "score": 81, "emoji": "😊", "shortTip": "적극" },
      { "date": "2026-01-23", "dayOfWeek": "목", "score": 88, "emoji": "🔥", "shortTip": "공격" },
      { "date": "2026-01-24", "dayOfWeek": "금", "score": 75, "emoji": "👍", "shortTip": "유지" }
    ]
  },
  "generatedAt": "2026-01-20T10:00:00.000Z"
}
```

## 위젯 구현 예시

```tsx theme={null}
function WeeklyCalendar({ days, bestDay, worstDay }) {
  return (
    <div className="weekly-calendar">
      {days.map((day) => (
        <div
          key={day.date}
          className={`day-cell ${day.date === bestDay.date ? 'best' : ''} ${day.date === worstDay.date ? 'worst' : ''}`}
        >
          <span className="day-name">{day.dayOfWeek}</span>
          <span className="day-emoji">{day.emoji}</span>
          <span className="day-score">{day.score}점</span>
          <span className="day-tip">{day.shortTip}</span>
        </div>
      ))}
    </div>
  );
}
```

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.sajuapi.dev/v1/fortunes/weekly \
    -H "X-API-Key: your-api-key" \
    -H "Content-Type: application/json" \
    -d '{
      "birthDate": "1994-12-30",
      "startDate": "2026-01-20"
    }'
  ```
</RequestExample>