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 생성)
일일 운세
AI가 생성하는 일일 운세 조회
POST
/
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가 생성하는 일일 운세를 조회합니다.
요청
string
required
생년월일 (YYYY-MM-DD 형식)
string
태어난 시간 (HH:mm 형식, 선택사항)
string
default:"male"
성별 (
male 또는 female)string
default:"haiku"
AI 모델 선택 (
haiku, sonnet, gpt4o, gemini)string
운세 조회 날짜 (기본값: 오늘)
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"]
}
}
}
위젯 매핑
| 응답 필드 | 위젯 |
|---|---|
character | AICharacterCard |
investmentTendency | StatsCards |
todayFortune.actionItems | ActionItems |
investmentFortune | InvestmentAdvice |
whyExplanation | InvestmentAdvice (하단) |
부분 조회
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"
}'
⌘I