Skip to main content
POST
https://sajuapi.dev
/
v1
/
calculations
/
saju
curl -X POST https://api.sajuapi.dev/v1/calculations/saju \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birth_date": "1994-12-30",
    "birth_time": "17:01",
    "gender": "male"
  }'
생년월일시 정보를 받아 사주팔자(四柱八字)를 계산합니다. 사주, 일간 정보, 오행 분포, 성격 요약을 반환합니다.

​
요청

​
birth_date
string
required
생년월일 (YYYY-MM-DD 형식)
​
birth_time
string
태어난 시간 (HH:MM 형식, 00:00-23:59). 생략 시 시주 없이 계산됩니다.
​
gender
string
default:"male"
성별 (male 또는 female)
​
lunar
boolean
default:"false"
음력 여부 (현재 미지원, 추후 지원 예정)

​
응답

{
  "success": true,
  "data": {
    "four_pillars": {
      "year": {
        "stem": { "hangul": "갑", "hanja": "甲" },
        "branch": { "hangul": "술", "hanja": "戌" }
      },
      "month": {
        "stem": { "hangul": "병", "hanja": "丙" },
        "branch": { "hangul": "자", "hanja": "子" }
      },
      "day": {
        "stem": { "hangul": "경", "hanja": "庚" },
        "branch": { "hangul": "인", "hanja": "寅" }
      },
      "hour": {
        "stem": { "hangul": "갑", "hanja": "甲" },
        "branch": { "hangul": "신", "hanja": "申" }
      }
    },
    "day_master": {
      "stem": "庚",
      "name": "경금",
      "element": "metal",
      "element_kr": "금",
      "element_name": "강철",
      "emoji": "⚔️"
    },
    "element_counts": {
      "wood": 3,
      "fire": 1,
      "earth": 1,
      "metal": 2,
      "water": 1
    },
    "personality_summary": {
      "strengths": [
        {
          "element": "wood",
          "element_kr": "목",
          "emoji": "🌳",
          "trait": "추진력과 성장 지향성"
        }
      ],
      "weakness": {
        "element": "fire",
        "element_kr": "화",
        "emoji": "🔥",
        "trait": "성급한 결정"
      },
      "investment_style": "경금(강철) 일주로, 목의 기운이 강해요. 추진력과 성장 지향성이 투자 강점이에요. 다만 화가 약해서 성급한 결정에 주의하세요."
    }
  },
  "meta": {
    "requestId": "req_abc123",
    "durationMs": 245,
    "cached": false,
    "sajuHash": "a1b2c3d4"
  }
}

​
응답 필드 설명

필드설명
four_pillars년주, 월주, 일주, 시주 정보. 시간 미입력 시 hour는 null
day_master일간(日干) 정보 - 사주의 핵심 요소
element_counts오행별 개수 (목, 화, 토, 금, 수)
personality_summary강점, 약점, 투자 스타일 요약
birth_time을 생략하면 시주(時柱) 없이 3주만 계산됩니다. 정확한 분석을 위해 시간 입력을 권장합니다.
curl -X POST https://api.sajuapi.dev/v1/calculations/saju \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birth_date": "1994-12-30",
    "birth_time": "17:01",
    "gender": "male"
  }'