API 문서

신살

귀인 21종, 살 17종, 12신살 — 기둥별 상세 + 해석

{
  "angels": [
    { "name": "천을귀인", "pillars": ["시지"], "description": "...", "modernMeaning": "..." },
    { "name": "월덕귀인", "pillars": ["월간", "일간"], ... }
  ],
  "devils": [
    { "name": "양인살", "pillars": ["일지"], "description": "..." }
  ],
  "twelve": [
    { "name": "화개", "pillars": ["년지"], "description": "..." }
  ],
  "byPillar": {
    "year": { "twelve": "화개", "angels": [...], "devils": [...] },
    ...
  }
}

합형충파해

원국(허자 미적용) + 허자 포함 이중 분석. 삼합/반합 자동 분류

{
  "original": {
    "hap": [
      { "name": "오미합", "subType": "육합", "positions": ["년지", "일지"], "chars": ["미", "오"] },
      { "name": "인오 반합", "subType": "생지반합", "positions": ["월지", "일지"], "chars": ["인", "오"] }
    ],
    "hyeong": [], "chung": [], "pa": [], "hae": []
  },
  "withGhost": {
    "hap": [
      { "name": "오미합", "subType": "육합", ... },
      { "name": "인오술 화국", "subType": "삼합", "positions": ["월지", "일지", "허자(술)"], ... }
    ],
    "hyeong": [{ "name": "술미형", "subType": "삼형", "positions": ["년지", "허자(술)"], ... }],
    ...
  }
}

허자 분석

삼합공협·도충 허자의 출투, 진허/가허, 순수성, 강도

{
  "maxLevel": 2,
  "nodes": [
    { "id": "L1_0_7", "level": 1, "isGhost": false, "char": "미", "element": "토" },
    { "id": "L2_triad_10", "level": 2, "isGhost": true, "char": "술", "element": "토" }
  ],
  "effectiveness": [{
    "ghostChar": "술", "ghostElement": "토",
    "originName": "삼합공협", "sourceChars": ["인", "오"],
    "hasTransparence": false, "isGenuine": true, "isPure": true,
    "strength": 70,
    "hiddenStems": [{ "stem": "무", "element": "토", "role": "본기" }, ...]
  }]
}

격국 분석

정격 8격 + 외격(종격) + 건록/양인격, 신강/신약 점수

{
  "name": "편인격",
  "category": "regular",
  "transparency": { "stem": null, "position": null, "sipsin": "편인" },
  "strength": { "level": "신강", "score": 77, "deukryeong": true, "deukji": true, "deukse": false },
  "reasoning": "월지(인) 지장간 미투출, 본기(갑) 기준 → 편인격"
}

용신 분석

억부용신 + 조후용신(궁통보감) + 5신(용희기구한) 파생

{
  "yongsin": { "oheng": "earth", "ko": "토" },
  "huisin": { "oheng": "fire", "ko": "화" },
  "gisin": { "oheng": "wood", "ko": "목" },
  "gusin": { "oheng": "water", "ko": "수" },
  "hansin": { "oheng": "metal", "ko": "금" },
  "eokbu": { "oheng": "earth", "ko": "토", "method": "설기" },
  "johu": { "oheng": "wood", "ko": "목" },
  "method": "eokbu",
  "reasoning": "신강(77점) → 일간(화)이 생하는 토(식상)으로 설기..."
}

월운

현재/전후 월운 + 십성 관계 + 해석

세운

과거/현재/미래 년운 + 합형충파해 관계 + 12운성

원국 상호작용

4기둥 간 합형충파해 + 인접/격각 구분

종합 사주 평가

스코어카드·성격·인생흐름·년운·용신가이드 — 전체 모듈 교차 종합

{
  "scorecard": {
    "elementBalance": { "score": 33, "grade": "C" },
    "harmony": { "score": 50, "grade": "B" },
    "conflict": { "score": 100, "grade": "S" },
    "spiritRatio": { "score": 73, "grade": "A" },
    "currentEnergy": { "score": 100, "grade": "S" }
  },
  "personality": {
    "keywords": ["독립적", "추진력", "편인격"],
    "strengths": [{ "trait": "강한 자기 주도력", "basis": "신강" }],
    "cautions": [{ "trait": "고집이 대인관계 마찰 유발", "basis": "신강 과다" }]
  },
  "lifePhase": {
    "current": { "period": "신유", "age": 41, "theme": "사", "summary": "정재 — 사색과 지혜" },
    "peak": { "period": "무오", "age": 71, "theme": "제왕" },
    "lowest": { "period": "계해", "age": 21, "theme": "절" }
  },
  "yearForecast": {
    "year": 2026, "energyLevel": 12, "energyName": "제왕",
    "yongsinAlignment": "medium",
    "headline": "2026년(병오) — 최고 에너지 구간",
    "advice": "희신의 보조가 있는 안정적인 해"
  },
  "yongsinGuide": {
    "yongsin": { "oheng": "토", "usage": "부동산, 중재, 신뢰 구축" },
    "huisin": { "oheng": "화", "usage": "자기표현, 리더십" },
    "gisin": { "oheng": "목", "caution": "학업/사색 과몰입 주의" },
    "gusin": { "oheng": "수", "caution": "음주, 우울 주의" }
  }
}