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

# 소개

> 암호화폐 투자 인사이트를 위한 AI 기반 사주 운세 API

# 사주 API

사주 API는 전통 한국 사주팔자(四柱八字)를 기반으로 암호화폐 투자 결정을 위한 AI 기반 운세 서비스를 제공합니다.

## 사주란?

사주(四柱)는 사람의 출생 연, 월, 일, 시를 기반으로 하는 전통 한국 운명 분석 방법입니다. 저희 API는 이 전통적인 지혜와 현대 AI를 결합하여 개인 맞춤형 투자 가이드를 제공합니다.

## 주요 기능

<CardGroup cols={2}>
  <Card title="오늘의 운세" icon="sun" href="/api-reference/endpoints/daily-fortune">
    사용자 생년월일 기반 개인화된 일일 투자 운세
  </Card>

  <Card title="성격 분석" icon="user" href="/api-reference/endpoints/daily-fortune#character">
    일간(日干) 오행 기반 투자 성격 이해
  </Card>

  <Card title="투자 성향" icon="chart-line" href="/api-reference/endpoints/daily-fortune#tendency">
    위험 감수성, 장기 투자 적합성, 트렌드 민감도 점수
  </Card>

  <Card title="스트리밍" icon="bolt" href="/api-reference/endpoints/fortune-stream">
    점진적 로딩을 위한 실시간 SSE 스트리밍
  </Card>
</CardGroup>

## 활용 사례

* **트레이딩 앱**: 개인화된 일일 투자 조언 표시
* **포트폴리오 대시보드**: 운세 기반 타이밍 추천 표시
* **암호화폐 거래소**: 일일 운세로 사용자 참여 증대
* **재무 설계**: 장기 투자 스타일 분석

## 빠른 예제

```bash theme={null}
curl -X POST https://api.sajuapi.dev/api/daily-fortune \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "saju": {
      "pillars": {
        "year": { "stem": { "hangul": "갑" }, "branch": { "hangul": "자" } },
        "month": { "stem": { "hangul": "병" }, "branch": { "hangul": "인" } },
        "day": { "stem": { "hangul": "정" }, "branch": { "hangul": "묘" } },
        "hour": { "stem": { "hangul": "무" }, "branch": { "hangul": "진" } }
      }
    },
    "userName": "홍길동",
    "model": "haiku"
  }'
```

## 응답 예시

```json theme={null}
{
  "success": true,
  "data": {
    "character": {
      "dayMaster": "정화",
      "elementName": "촛불",
      "emoji": "🕯️",
      "identity": "당신은 정화(丁火), 촛불의 기운을 가진 사람이에요.",
      "investmentIdentity": "신중하게 분석하고 확신이 들 때 투자하는 스타일이에요."
    },
    "todayFortune": {
      "score": 78,
      "overallAnalysis": "오늘은 안정적인 투자 결정이 가능한 날이에요.",
      "actionItems": [
        { "type": "do", "text": "메이저 코인 분할 매수" },
        { "type": "avoid", "text": "레버리지 거래" }
      ],
      "timing": {
        "best": "14:00-16:00",
        "avoid": "09:00-11:00",
        "reason": "오후에 판단력이 맑아져요."
      }
    }
  },
  "meta": {
    "model": "haiku",
    "cached": false,
    "cost": 0.013
  }
}
```

## 요금제

| 모델     | 요청당 비용  | 속도        | 품질    |
| ------ | ------- | --------- | ----- |
| Haiku  | \$0.013 | 빠름 (\~2초) | 좋음    |
| Sonnet | \$0.031 | 보통 (\~5초) | 우수    |
| GPT-4o | \$0.025 | 보통 (\~4초) | 매우 좋음 |

<Note>
  모든 가격에는 3개의 AI 함수 호출이 포함됩니다: 성격 분석, 투자 성향, 오늘의 운세
</Note>

## 다음 단계

<CardGroup cols={2}>
  <Card title="빠른 시작" icon="rocket" href="/quickstart">
    5분 안에 시작하기
  </Card>

  <Card title="인증" icon="key" href="/authentication">
    API 요청 인증 방법 알아보기
  </Card>
</CardGroup>