Skip to main content
POST
https://sajuapi.dev
/
v1
/
fortunes
/
daily
curl -X POST https://api.sajuapi.dev/v1/fortunes/daily \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1994-12-30",
    "birthTime": "17:01",
    "gender": "male",
    "model": "haiku"
  }'
사주 정보를 기반으로 AI가 생성하는 일일 운세를 조회합니다.

요청

birthDate
string
required
생년월일 (YYYY-MM-DD 형식)
birthTime
string
태어난 시간 (HH:mm 형식, 선택사항)
gender
string
default:"male"
성별 (male 또는 female)
model
string
default:"haiku"
AI 모델 선택 (haiku, sonnet, gpt4o, gemini)
date
string
운세 조회 날짜 (기본값: 오늘)
type
string
부분 조회 (character, tendency, fortune, radar)

응답

{
  "success": true,
  "data": {
    "character": {
      "title": "물을 머금은 병화 태양",
      "dayMaster": "병화",
      "dayMasterHanja": "丙",
      "emoji": "☀️",
      "identity": "당신은 태양형이지만, 물이 받쳐주는 구조라 무작정 돌진하는 타입은 아닙니다.",
      "investmentIdentity": "혼자 빛나기보다, 시스템·조직 안에서 힘이 커지는 투자자입니다."
    },
    "investmentTendency": {
      "strengths": [
        { "element": "fire", "emoji": "🔥", "trait": "기회 포착, 리더십" },
        { "element": "water", "emoji": "🌊", "trait": "리스크 감지, 타이밍" }
      ],
      "weakness": {
        "element": "metal",
        "emoji": "❌",
        "trait": "손절·규칙 관리 약함"
      },
      "scores": {
        "riskTolerance": 75,
        "longTermAptitude": 85,
        "trendSensitivity": 45
      },
      "summary": "장기 성장주 선호, 변동성에 흔들리지 않는 타입",
      "warning": "단, 손절 타이밍을 놓치기 쉬움"
    },
    "todayFortune": {
      "date": "2026-01-20",
      "formattedDate": "2026년 1월 20일 (월)",
      "deficiency": {
        "element": "금(金)",
        "meaning": "규칙·정리·손절이 약한 구조"
      },
      "compensation": {
        "message": "오늘은 금 기운이 강한 날입니다.",
        "benefit": "결정을 정리하고, 정해둔 기준을 실행하기 좋은 날"
      },
      "actionItems": [
        { "type": "do", "text": "익절 기준을 먼저 정하고 진입" },
        { "type": "do", "text": "분할 진입 → 분할 청산" },
        { "type": "do", "text": "포트폴리오 점검" },
        { "type": "avoid", "text": "충동 매수" },
        { "type": "avoid", "text": "레버리지 거래" },
        { "type": "avoid", "text": "FOMO 매매" }
      ],
      "timing": {
        "best": "14:00-16:00",
        "avoid": "09:00-11:00",
        "reason": "오후에 금 기운이 안정되면서 판단력이 맑아져요"
      }
    },
    "investmentFortune": {
      "shortTerm": {
        "message": "지금처럼 단기 폭등 구간에서는 정면승부보다 2차 눌림에서 들어가는 게 맞는 사주입니다.",
        "warning": "지금 추격매수하면, 사주상 내일 판단이 흔들릴 확률이 높습니다."
      },
      "longTerm": {
        "message": "장기 포지션에서 리더 역할을 할 때 수익률이 누적됩니다.",
        "advice": "단기 변동성에 감정이 흔들리면 손해를 봅니다."
      }
    },
    "whyExplanation": "왜 오늘이 이런 운일까요? 당신의 사주에서 화(火)가 강한 편인데, 오늘의 금(金) 기운이 이를 적절히 제어해줘요."
  },
  "generatedAt": "2026-01-20T10:30:00.000Z",
  "meta": {
    "model": "haiku",
    "requestId": "req_abc123",
    "costPerCall": 0.013,
    "durationMs": 1847,
    "cache": {
      "hits": ["character", "tendency"],
      "misses": ["fortune"]
    }
  }
}

위젯 매핑

응답 필드위젯
characterAICharacterCard
investmentTendencyStatsCards
todayFortune.actionItemsActionItems
investmentFortuneInvestmentAdvice
whyExplanationInvestmentAdvice (하단)

부분 조회

type 파라미터로 특정 섹션만 조회할 수 있습니다:
# 캐릭터만 조회 (캐시 가능)
POST /v1/fortunes/daily?type=character

# 투자 성향만 조회 (캐시 가능)
POST /v1/fortunes/daily?type=tendency

# 오늘 운세만 조회 (매일 갱신)
POST /v1/fortunes/daily?type=fortune
curl -X POST https://api.sajuapi.dev/v1/fortunes/daily \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "1994-12-30",
    "birthTime": "17:01",
    "gender": "male",
    "model": "haiku"
  }'