수파사주 API MYEONGRI ENGINE

엔드포인트

연간 운세 유료

그 해 1년의 흐름은?

POST https://api.supasaju.com/v2/saju/yearly

무엇을 담나

한 해를 통째로 봅니다. 세운이 축이고 월운 12개가 그 해 안의 굴곡을, 대운이 그 해가 놓인 10년을 보여 줍니다. 격국·용신으로 골격을, evaluation 으로 성향과 주의점을 더해 신년 운세 한 편이 그대로 나옵니다. 가장 모듈이 많은 토픽 중 하나입니다.

포함 모듈fourPillars · seun · weolun · decadeFortune · gyeokguk · yongsin · sinsal · evaluation
핵심 모듈seun — 이것이 빠지면 이 토픽은 성립하지 않습니다
기준 시점year(정수)로 기준 해를 옮길 수 있습니다. 생략하면 올해입니다.
세운기본 3개년(기준 연도 ±1) — 이 토픽의 지침이 여러 해를 전제로 쓰였기 때문입니다. seunWindow 로 바꿀 수 있습니다
상대상대를 받지 않습니다.
최소 플랜유료 — Free 키는 샘플 프로필 입력일 때만 이 구성으로 응답합니다
응답 무게78KB · 대략 36,253토큰 — 통째로 LLM 에 넣기 전에 줄이는 법을 보십시오

요청

curl -X POST https://api.supasaju.com/v2/saju/yearly \
  -H "x-api-key: $SAJU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "birthYear": 1988,
  "birthMonth": 3,
  "birthDay": 14,
  "birthHour": 9,
  "birthMinute": 20,
  "isFemale": false,
  "isLunar": false,
  "birthCity": "서울",
  "year": 2026
}'

공통 요청 필드는 문서 홈에 정리되어 있습니다. 위 예시의 생년월일은 샘플 프로필이라 Free 키로 그대로 재현됩니다.

응답

아래는 위 요청의 실제 응답입니다. 봉투를 먼저 보이고, 핵심 모듈 seun 을 펼쳐 실었습니다. 나머지 모듈은 접어 두었습니다 — 전체 형태는 스키마 파일OpenAPI에 있습니다.

봉투

{
  "topic": "yearly",
  "guide": {
    "purpose": "그 해 1년의 흐름은? — 연간 운세 토픽의 계산 결과입니다.",
    "howToUse": [
      "… 6줄"
    ]
  },
  "glossary": {
    "진태양시": {
      "definition": "출생지의 경도와 균시차까지 반영한 실제 태양 기준 시각.",
      "en": "True Solar Time"
    },
    "태극귀인": {
      "definition": "일간을 기준으로 잡는 길신. 시작과 마무리가 이어지는 자리로 본다.",
      "en": "Taiji Nobleman"
    },
    "…": "외 89종"
  },
  "reference": {
    "date": "2026-09-17",
    "month": "2026-09",
    "year": 2026
  },
  "input": {
    "solar": {
      "year": 1988,
      "month": 3,
      "day": 14,
      "hour": 9,
      "minute": 20
    },
    "lunar": {
      "year": 1988,
      "month": 1,
      "day": 26,
      "isLeapMonth": false
    },
    "isFemale": false,
    "correctedHour": 8,
    "correctedMinute": 38
  },
  "timezone": {
    "cityId": "seoul",
    "cityResolved": true,
    "locationSource": "city",
    "tzId": "Asia/Seoul",
    "utcOffsetMinutes": 540,
    "longitude": 126.978,
    "mode": "trueSolar",
    "longitudeCorrectionMinutes": -32.1,
    "equationOfTimeMinutes": -9.3,
    "totalCorrectionMinutes": -41.4,
    "dstApplied": false
  },
  "modules": {
    "fourPillars": "…",
    "seun": "…",
    "weolun": "…",
    "decadeFortune": "…",
    "gyeokguk": "…",
    "yongsin": "…",
    "sinsal": "…",
    "evaluation": "…"
  },
  "diagnostics": [],
  "ruleset": {
    "version": "0.2.2",
    "profile": "ko-standard",
    "data": {
      "tzdata": "2026c",
      "tzdataBuild": "backzone",
      "tzZones": 418,
      "ephemeris": "DE440s",
      "lunarVerifiedThrough": 2050,
      "solarTermsVerifiedRange": "2000-2028"
    }
  }
}

핵심 모듈 — seun

{
  "referenceYear": 2026,
  "window": 0,
  "entries": [
    {
      "calendarYear": 2026,
      "ganji": "병오",
      "ganjiHan": "丙午",
      "ganjiIndex": 42,
      "stem": {
        "index": 2,
        "han": "丙",
        "ko": "병",
        "element": "fire",
        "elementKo": "화",
        "elementHan": "火",
        "polarity": "yang",
        "polarityKo": "양",
        "sipseong": {
          "id": "pyeonin",
          "ko": "편인",
          "han": "偏印",
          "group": "inseong",
          "groupKo": "인성",
          "meaning": "편인은 일간을 낳는 기운 중 음양이 같은 것으로, 비주류의 배움과 깊은 탐구, 식신을 누르는 작용으로 읽는다."
        }
      },
      "branch": {
        "index": 6,
        "han": "午",
        "ko": "오",
        "element": "fire",
        "elementKo": "화",
        "elementHan": "火",
        "polarity": "yang",
        "polarityKo": "양",
        "animalKo": "말",
        "sipseong": {
          "id": "jeongin",
          "ko": "정인",
          "han": "正印",
          "group": "inseong",
          "groupKo": "인성",
          "meaning": "정인은 일간을 낳는 기운 중 음양이 다른 것으로, 어머니 같은 보호와 정통의 배움, 문서와 자격으로 읽는다."
        },
        "hiddenStems": [
          {
            "stem": "…",
            "role": "yeogi",
            "roleKo": "여기",
            "roleHan": "餘氣",
            "days": 10
          },
          {
            "stem": "…",
            "role": "junggi",
            "roleKo": "중기",
            "roleHan": "中氣",
            "days": 9
          },
          "… 외 1건"
        ]
      },
      "twelveStage": {
        "id": "jewang",
        "ko": "제왕",
        "han": "帝旺",
        "order": 5,
        "keyword": "절정",
        "phase": "정점",
        "meaning": "제왕은 기운이 가장 왕성한 단계로, 힘이 넘치되 넘친 만큼 조절이 필요한 흐름으로 본다."
      },
      "relations": [
        {
          "kind": "destruction",
          "kindKo": "파",
          "withPosition": "month",
          "withPositionKo": "월주",
          "withPositions": [
            "month"
          ],
          "glyphs": "묘오",
          "glyphsHan": "卯午",
          "meaning": "파는 두 지지가 서로 흠집을 내는 약한 작용으로, 해당 자리의 결속이 느슨해지는 신호로 읽는다.",
          "reasoning": "2026년 세운 지지 오(午, 정인)가 월지 묘(卯, 정관)와 파를 이루어 정관 자리의 결속이 느슨해지는 신호로 읽는다."
        }
      ],
      "twelveSinsal": {
        "byYear": {
          "id": "jaesal",
          "ko": "재살",
          "han": "災煞"
        },
        "byDay": {
          "id": "jaesal",
          "ko": "재살",
          "han": "災煞"
        }
      },
      "fortuneSinsal": [
        {
          "id": "sangmun",
          "ko": "상문",
          "han": "喪門"
        }
      ],
      "sinsalOnFortune": [
        {
          "id": "yangin",
          "ko": "양인",
          "han": "羊刃",
          "basis": [
            "일간 戊 록(巳) 앞 午"
          ]
        }
      ],
      "isGongmang": false,
      "meaning": "운의 천간에 편인이 오면 배움과 탐구가 깊어지되 활동이 안으로 향하는 때로 읽는다. 운의 지지가 일간에게 제왕이면 힘이 정점에 이르러 조절이 함께 필요한 때로 읽는다.",
      "startsAt": "2026-02-04 05:02",
      "endsAt": "2027-02-04 10:45",
      "isReference": true,
      "isCurrent": true,
      "age": {
        "international": 38,
        "korean": 39
      }
    }
  ],
  "current": {
    "calendarYear": 2026,
    "ganji": "병오",
    "ganjiHan": "丙午",
    "ganjiIndex": 42,
    "stem": {
      "index": 2,
      "han": "丙",
      "ko": "병",
      "element": "fire",
      "elementKo": "화",
      "elementHan": "火",
      "polarity": "yang",
      "polarityKo": "양",
      "sipseong": {
        "id": "pyeonin",
        "ko": "편인",
        "han": "偏印",
        "group": "inseong",
        "groupKo": "인성",
        "meaning": "편인은 일간을 낳는 기운 중 음양이 같은 것으로, 비주류의 배움과 깊은 탐구, 식신을 누르는 작용으로 읽는다."
      }
    },
    "branch": {
      "index": 6,
      "han": "午",
      "ko": "오",
      "element": "fire",
      "elementKo": "화",
      "elementHan": "火",
      "polarity": "yang",
      "polarityKo": "양",
      "animalKo": "말",
      "sipseong": {
        "id": "jeongin",
        "ko": "정인",
        "han": "正印",
        "group": "inseong",
        "groupKo": "인성",
        "meaning": "정인은 일간을 낳는 기운 중 음양이 다른 것으로, 어머니 같은 보호와 정통의 배움, 문서와 자격으로 읽는다."
      },
      "hiddenStems": [
        {
          "stem": {
            "index": 2,
            "han": "丙",
            "ko": "병",
            "element": "fire",
            "elementKo": "화",
            "elementHan": "火",
            "polarity": "yang",
            "polarityKo": "양",
            "sipseong": "…"
          },
          "role": "yeogi",
          "roleKo": "여기",
          "roleHan": "餘氣",
          "days": 10
        },
        {
          "stem": {
            "index": 5,
            "han": "己",
            "ko": "기",
            "element": "earth",
            "elementKo": "토",
            "elementHan": "土",
            "polarity": "yin",
            "polarityKo": "음",
            "sipseong": "…"
          },
          "role": "junggi",
          "roleKo": "중기",
          "roleHan": "中氣",
          "days": 9
        },
        "… 외 1건"
      ]
    },
    "twelveStage": {
      "id": "jewang",
      "ko": "제왕",
      "han": "帝旺",
      "order": 5,
      "keyword": "절정",
      "phase": "정점",
      "meaning": "제왕은 기운이 가장 왕성한 단계로, 힘이 넘치되 넘친 만큼 조절이 필요한 흐름으로 본다."
    },
    "relations": [
      {
        "kind": "destruction",
        "kindKo": "파",
        "withPosition": "month",
        "withPositionKo": "월주",
        "withPositions": [
          "month"
        ],
        "glyphs": "묘오",
        "glyphsHan": "卯午",
        "meaning": "파는 두 지지가 서로 흠집을 내는 약한 작용으로, 해당 자리의 결속이 느슨해지는 신호로 읽는다.",
        "reasoning": "2026년 세운 지지 오(午, 정인)가 월지 묘(卯, 정관)와 파를 이루어 정관 자리의 결속이 느슨해지는 신호로 읽는다."
      }
    ],
    "twelveSinsal": {
      "byYear": {
        "id": "jaesal",
        "ko": "재살",
        "han": "災煞"
      },
      "byDay": {
        "id": "jaesal",
        "ko": "재살",
        "han": "災煞"
      }
    },
    "fortuneSinsal": [
      {
        "id": "sangmun",
        "ko": "상문",
        "han": "喪門"
      }
    ],
    "sinsalOnFortune": [
      {
        "id": "yangin",
        "ko": "양인",
        "han": "羊刃",
        "basis": [
          "일간 戊 록(巳) 앞 午"
        ]
      }
    ],
    "isGongmang": false,
    "meaning": "운의 천간에 편인이 오면 배움과 탐구가 깊어지되 활동이 안으로 향하는 때로 읽는다. 운의 지지가 일간에게 제왕이면 힘이 정점에 이르러 조절이 함께 필요한 때로 읽는다.",
    "startsAt": "2026-02-04 05:02",
    "endsAt": "2027-02-04 10:45",
    "isReference": true,
    "isCurrent": true,
    "age": {
      "international": 38,
      "korean": 39
    }
  },
  "basis": [
    "기준 연도 2026년 세운 병오(丙午)는 입춘 절입(2026-02-04 05:02 KST)부터 다음 입춘 전까지로 본다.",
    "세운 간지를 원국 네 기둥과 대조해 십성·12운성·합충형파해·12신살·공망을 냈다."
  ]
}
나머지 모듈 7종 펼치기
{
  "fourPillars": {
    "pillars": {
      "year": {
        "position": "year",
        "positionKo": "연주",
        "ganji": "무진",
        "ganjiHan": "戊辰",
        "ganjiIndex": 4,
        "stem": {
          "index": 4,
          "han": "戊",
          "ko": "무",
          "element": "earth",
          "elementKo": "토",
          "elementHan": "土",
          "polarity": "yang",
          "polarityKo": "양",
          "sipseong": "…"
        },
        "branch": {
          "index": 4,
          "han": "辰",
          "ko": "진",
          "element": "earth",
          "elementKo": "토",
          "elementHan": "土",
          "polarity": "yang",
          "polarityKo": "양",
          "animalKo": "용",
          "sipseong": "…",
          "hiddenStems": [
            "…",
            "…",
            "… 외 1건"
          ]
        },
        "twelveStage": {
          "id": "gwandae",
          "ko": "관대",
          "han": "冠帶",
          "order": 3,
          "keyword": "성장",
          "phase": "상승",
          "meaning": "관대는 기운이 형태를 갖추고 옷을 입듯 사회적 모습을 갖추는 단계로, 의욕과 자기 표현이 커지는 흐름으로 본다.",
          "positionMeaning": "연주의 관대는 초년의 바탕에서 일간이 일찍 모양을 갖추고 나서려는 자리로 읽는다."
        },
        "selfStage": {
          "id": "gwandae",
          "ko": "관대",
          "han": "冠帶",
          "order": 3
        },
        "naeum": {
          "ko": "대림목",
          "han": "大林木",
          "element": "wood",
          "elementKo": "목"
        }
      },
      "month": {
        "position": "month",
        "positionKo": "월주",
        "ganji": "을묘",
        "ganjiHan": "乙卯",
        "ganjiIndex": 51,
        "stem": {
          "index": 1,
          "han": "乙",
          "ko": "을",
          "element": "wood",
          "elementKo": "목",
          "elementHan": "木",
          "polarity": "yin",
          "polarityKo": "음",
          "sipseong": "…"
        },
        "branch": {
          "index": 3,
          "han": "卯",
          "ko": "묘",
          "element": "wood",
          "elementKo": "목",
          "elementHan": "木",
          "polarity": "yin",
          "polarityKo": "음",
          "animalKo": "토끼",
          "sipseong": "…",
          "hiddenStems": [
            "…",
            "…"
          ]
        },
        "twelveStage": {
          "id": "mogyok",
          "ko": "목욕",
          "han": "沐浴",
          "order": 2,
          "keyword": "정화",
          "phase": "상승",
          "meaning": "목욕은 갓 태어난 기운이 씻기고 다듬어지는 단계로, 불안정하지만 변화가 빠르고 감각이 예민한 흐름으로 본다.",
          "positionMeaning": "월주의 목욕은 사회에 나서는 시기에 시행착오와 변화가 잦은 자리로 읽는다."
        },
        "selfStage": {
          "id": "geonrok",
          "ko": "건록",
          "han": "建祿",
          "order": 4
        },
        "naeum": {
          "ko": "대계수",
          "han": "大溪水",
          "element": "water",
          "elementKo": "수"
        }
      },
      "day": {
        "position": "day",
        "positionKo": "일주",
        "ganji": "무진",
        "ganjiHan": "戊辰",
        "ganjiIndex": 4,
        "stem": {
          "index": 4,
          "han": "戊",
          "ko": "무",
          "element": "earth",
          "elementKo": "토",
          "elementHan": "土",
          "polarity": "yang",
          "polarityKo": "양",
          "sipseong": null
        },
        "branch": {
          "index": 4,
          "han": "辰",
          "ko": "진",
          "element": "earth",
          "elementKo": "토",
          "elementHan": "土",
          "polarity": "yang",
          "polarityKo": "양",
          "animalKo": "용",
          "sipseong": "…",
          "hiddenStems": [
            "…",
            "…",
            "… 외 1건"
          ]
        },
        "twelveStage": {
          "id": "gwandae",
          "ko": "관대",
          "han": "冠帶",
          "order": 3,
          "keyword": "성장",
          "phase": "상승",
          "meaning": "관대는 기운이 형태를 갖추고 옷을 입듯 사회적 모습을 갖추는 단계로, 의욕과 자기 표현이 커지는 흐름으로 본다.",
          "positionMeaning": "일주의 관대는 일간이 자기 자리에서 뜻을 세우고 드러내려는 구조로 본다."
        },
        "selfStage": {
          "id": "gwandae",
          "ko": "관대",
          "han": "冠帶",
          "order": 3
        },
        "naeum": {
          "ko": "대림목",
          "han": "大林木",
          "element": "wood",
          "elementKo": "목"
        }
      },
      "hour": {
        "position": "hour",
        "positionKo": "시주",
        "ganji": "병진",
        "ganjiHan": "丙辰",
        "ganjiIndex": 52,
        "stem": {
          "index": 2,
          "han": "丙",
          "ko": "병",
          "element": "fire",
          "elementKo": "화",
          "elementHan": "火",
          "polarity": "yang",
          "polarityKo": "양",
          "sipseong": "…"
        },
        "branch": {
          "index": 4,
          "han": "辰",
          "ko": "진",
          "element": "earth",
          "elementKo": "토",
          "elementHan": "土",
          "polarity": "yang",
          "polarityKo": "양",
          "animalKo": "용",
          "sipseong": "…",
          "hiddenStems": [
            "…",
            "…",
            "… 외 1건"
          ]
        },
        "twelveStage": {
          "id": "gwandae",
          "ko": "관대",
          "han": "冠帶",
          "order": 3,
          "keyword": "성장",
          "phase": "상승",
          "meaning": "관대는 기운이 형태를 갖추고 옷을 입듯 사회적 모습을 갖추는 단계로, 의욕과 자기 표현이 커지는 흐름으로 본다.",
          "positionMeaning": "시주의 관대는 후반에 새 목표를 세우고 모양을 갖추려는 자리로 읽는다."
        },
        "selfStage": {
          "id": "gwandae",
          "ko": "관대",
          "han": "冠帶",
          "order": 3
        },
        "naeum": {
          "ko": "사중토",
          "han": "沙中土",
          "element": "earth",
          "elementKo": "토"
        }
      }
    },
    "hourKnown": true,
    "dayMaster": {
      "stem": {
        "index": 4,
        "han": "戊",
        "ko": "무",
        "element": "earth",
        "elementKo": "토",
        "elementHan": "土",
        "polarity": "yang",
        "polarityKo": "양",
        "sipseong": null
      },
      "label": "양토 무(戊) 일간",
      "meaning": "무 일간은 넓고 두터운 산과 들의 기운으로, 묵직하게 품고 중심을 지키려는 성향을 바탕으로 읽는다."
    },
    "monthTerm": {
      "nameKo": "경칩",
      "nameHan": "驚蟄",
      "atKst": "1988-03-05 17:47",
      "elapsedDays": 8.6,
      "minutesFromJeol": 12453,
      "nextNameKo": "청명",
      "nextAtKst": "1988-04-04 22:39",
      "minutesToNextJeol": 31039
    },
    "saryeong": {
      "stem": {
        "index": 0,
        "han": "甲",
        "ko": "갑",
        "element": "wood",
        "elementKo": "목",
        "elementHan": "木",
        "polarity": "yang",
        "polarityKo": "양",
        "sipseong": {
          "id": "pyeongwan",
          "ko": "편관",
          "han": "偏官",
          "group": "gwanseong",
          "groupKo": "관성"
        }
      },
      "role": "yeogi",
      "roleKo": "여기",
      "elapsedDays": 8.6,
      "firstHalf": true,
      "basis": [
        "경칩 절입 후 8.6일 경과라 월지 묘의 여기 갑(甲)이 사령한다(통용 배분표 0~10일 구간)."
      ]
    },
    "yearBoundary": {
      "ipchunAtKst": "1988-02-04 23:43",
      "beforeIpchun": false,
      "minutesFromIpchun": 55297
    },
    "hourBoundary": {
      "minutesFromStart": 98.6,
      "minutesToNext": 21.4
    },
    "basis": [
      "연주는 입춘 절입 순간(1988-02-04 23:43 KST)을 기준으로 정했다.",
      "월주는 12절 기준으로 경칩(1988-03-05 17:47 KST) 이후 청명 전이라 묘(卯)월이며, 월간은 연간에서 오호둔으로 정했다.",
      "… 외 2건"
    ]
  },
  "weolun": {
    "natalSaryeong": {
      "stem": {
        "index": 0,
        "han": "甲",
        "ko": "갑",
        "element": "wood",
        "elementKo": "목",
        "elementHan": "木",
        "polarity": "yang",
        "polarityKo": "양",
        "sipseong": {
          "id": "pyeongwan",
          "ko": "편관",
          "han": "偏官",
          "group": "gwanseong",
          "groupKo": "관성",
          "meaning": "편관은 일간을 다스리는 기운 중 음양이 같은 것으로, 강한 압력과 권위, 그것을 견디며 얻는 결단력으로 읽는다."
        }
      },
      "role": "yeogi",
      "roleKo": "여기",
      "roleHan": "餘氣",
      "elapsedDays": 8.6,
      "firstHalf": true,
      "schedule": [
        {
          "stem": "…",
          "role": "yeogi",
          "roleKo": "여기",
          "roleHan": "餘氣",
          "fromDay": 0,
          "toDay": 10
        },
        {
          "stem": "…",
          "role": "jeonggi",
          "roleKo": "정기",
          "roleHan": "正氣",
          "fromDay": 10,
          "toDay": null
        }
      ],
      "basis": [
        "출생 월지 묘(卯)의 지장간 배분(통용표)에서 경칩 절입 후 8.6일 경과 시점의 사령을 갑(甲, 여기)으로 정했다."
      ]
    },
    "referenceMonth": "2026-09",
    "terms": [
      {
        "ganji": "병신",
        "ganjiHan": "丙申",
        "ganjiIndex": 32,
        "stem": {
          "index": 2,
          "han": "丙",
          "ko": "병",
          "element": "fire",
          "elementKo": "화",
          "elementHan": "火",
          "polarity": "yang",
          "polarityKo": "양",
          "sipseong": "…"
        },
        "branch": {
          "index": 8,
          "han": "申",
          "ko": "신",
          "element": "metal",
          "elementKo": "금",
          "elementHan": "金",
          "polarity": "yang",
          "polarityKo": "양",
          "animalKo": "원숭이",
          "sipseong": "…",
          "hiddenStems": [
            "…",
            "…",
            "… 외 1건"
          ]
        },
        "twelveStage": {
          "id": "byeong",
          "ko": "병",
          "han": "病",
          "order": 7,
          "keyword": "소진",
          "phase": "하강",
          "meaning": "병은 기운이 눈에 띄게 줄어드는 단계로, 외부 기댐과 회복이 필요한 흐름으로 본다."
        },
        "relations": [],
        "twelveSinsal": {
          "byYear": "…",
          "byDay": "…"
        },
        "fortuneSinsal": [],
        "sinsalOnFortune": [
          "…",
          "…",
          "… 외 5건"
        ],
        "isGongmang": false,
        "meaning": "운의 천간에 편인이 오면 배움과 탐구가 깊어지되 활동이 안으로 향하는 때로 읽는다. 운의 지지가 일간에게 병이면 기운이 줄어 기댈 곳과 회복을 살피는 때로 읽는다.",
        "startsAt": "2026-08-07 20:43",
        "endsAt": "2026-09-07 23:40",
        "jeolKo": "입추",
        "isCurrent": false
      },
      {
        "ganji": "정유",
        "ganjiHan": "丁酉",
        "ganjiIndex": 33,
        "stem": {
          "index": 3,
          "han": "丁",
          "ko": "정",
          "element": "fire",
          "elementKo": "화",
          "elementHan": "火",
          "polarity": "yin",
          "polarityKo": "음",
          "sipseong": "…"
        },
        "branch": {
          "index": 9,
          "han": "酉",
          "ko": "유",
          "element": "metal",
          "elementKo": "금",
          "elementHan": "金",
          "polarity": "yin",
          "polarityKo": "음",
          "animalKo": "닭",
          "sipseong": "…",
          "hiddenStems": [
            "…",
            "…"
          ]
        },
        "twelveStage": {
          "id": "sa",
          "ko": "사",
          "han": "死",
          "order": 8,
          "keyword": "정지",
          "phase": "하강",
          "meaning": "사는 기운의 활동이 멈추는 단계로, 움직임보다 내면과 정리로 향하는 흐름으로 본다."
        },
        "relations": [
          "…",
          "…",
          "… 외 2건"
        ],
        "twelveSinsal": {
          "byYear": "…",
          "byDay": "…"
        },
        "fortuneSinsal": [],
        "sinsalOnFortune": [],
        "isGongmang": false,
        "meaning": "운의 천간에 정인이 오면 보호와 학습, 문서·자격의 기운이 보태지는 때로 읽는다. 운의 지지가 일간에게 사면 활동보다 정리와 내면으로 향하는 때로 읽는다.",
        "startsAt": "2026-09-07 23:41",
        "endsAt": "2026-10-08 15:28",
        "jeolKo": "백로",
        "isCurrent": true
      }
    ],
    "basis": [
      "2026-09 의 월운은 그 달 1일 0시(KST)가 속한 절월부터, 달 안에서 절입이 지나면 다음 절월까지 함께 낸다.",
      "월운 간지의 월간은 해당 절월이 속한 연간(입춘 기준)에서 오호둔으로 정했다."
    ]
  },
  "decadeFortune": {
    "direction": "forward",
    "directionKo": "순행",
    "startAge": 7,
    "startAgeExact": 7.18,
    "firstStartsOn": "1995-05-21",
    "countedTo": {
      "nameKo": "청명",
      "atKst": "1988-04-04 22:39",
      "days": 21.55
    },
    "entries": [
      {
        "order": 1,
        "ganji": "병진",
        "ganjiHan": "丙辰",
        "ganjiIndex": 52,
        "stem": {
          "index": 2,
          "han": "丙",
          "ko": "병",
          "element": "fire",
          "elementKo": "화",
          "elementHan": "火",
          "polarity": "yang",
          "polarityKo": "양",
          "sipseong": "…"
        },
        "branch": {
          "index": 4,
          "han": "辰",
          "ko": "진",
          "element": "earth",
          "elementKo": "토",
          "elementHan": "土",
          "polarity": "yang",
          "polarityKo": "양",
          "animalKo": "용",
          "sipseong": "…",
          "hiddenStems": [
            "…",
            "…",
            "… 외 1건"
          ]
        },
        "twelveStage": {
          "id": "gwandae",
          "ko": "관대",
          "han": "冠帶",
          "order": 3
        },
        "startAge": 7,
        "endAge": 16,
        "ageAtStart": {
          "international": 7,
          "korean": 8
        },
        "startsOn": "1995-05-21",
        "endsOn": "2005-05-21",
        "isCurrent": false,
        "meaning": "대운 천간에 편인이 오는 시기는 배움과 탐구가 깊어지되 활동이 안으로 향하는 흐름으로 읽는다. 대운 지지가 일간에게 관대인 시기는 모양을 갖추고 뜻을 세워 나서는 흐름으로 읽는다."
      },
      {
        "order": 2,
        "ganji": "정사",
        "ganjiHan": "丁巳",
        "ganjiIndex": 53,
        "stem": {
          "index": 3,
          "han": "丁",
          "ko": "정",
          "element": "fire",
          "elementKo": "화",
          "elementHan": "火",
          "polarity": "yin",
          "polarityKo": "음",
          "sipseong": "…"
        },
        "branch": {
          "index": 5,
          "han": "巳",
          "ko": "사",
          "element": "fire",
          "elementKo": "화",
          "elementHan": "火",
          "polarity": "yin",
          "polarityKo": "음",
          "animalKo": "뱀",
          "sipseong": "…",
          "hiddenStems": [
            "…",
            "…",
            "… 외 1건"
          ]
        },
        "twelveStage": {
          "id": "geonrok",
          "ko": "건록",
          "han": "建祿",
          "order": 4
        },
        "startAge": 17,
        "endAge": 26,
        "ageAtStart": {
          "international": 17,
          "korean": 18
        },
        "startsOn": "2005-05-21",
        "endsOn": "2015-05-21",
        "isCurrent": false,
        "meaning": "대운 천간에 정인이 오는 시기는 보호와 학습, 문서·자격의 기운이 보태지는 흐름으로 읽는다. 대운 지지가 일간에게 건록인 시기는 제 힘으로 서는 안정된 흐름으로 읽는다."
      },
      "… 외 11건"
    ],
    "selection": {
      "mode": "count",
      "value": 13,
      "firstOrder": 1,
      "lastOrder": 13
    },
    "current": {
      "order": 4,
      "phase": "within",
      "reasoning": "현재 대운은 4번째 기미(己未) 37~46세 구간으로, 천간 겁재·지지 겁재·12운성 쇠로 본다."
    },
    "basis": [
      "연간 양간 · 남성이라 순행(양남음녀)한다 (三命通會 論大運).",
      "출생 이후 다음 절인 청명(1988-04-04 22:39 KST)까지 21.55일을 3일=1년으로 환산해 대운수 7.18년(반올림 7)을 얻었다.",
      "… 외 1건"
    ]
  },
  "gyeokguk": {
    "id": "jeonggwan",
    "ko": "정관격",
    "han": "正官格",
    "kind": "regular",
    "basedOn": {
      "stem": {
        "index": 1,
        "han": "乙",
        "ko": "을",
        "element": "wood",
        "elementKo": "목",
        "elementHan": "木",
        "polarity": "yin",
        "polarityKo": "음",
        "sipseong": {
          "id": "jeonggwan",
          "ko": "정관",
          "han": "正官",
          "group": "gwanseong",
          "groupKo": "관성"
        }
      },
      "role": "jeonggi",
      "roleKo": "정기",
      "roleHan": "正氣",
      "transparent": true,
      "transparentAt": "month"
    },
    "formation": {
      "status": "seong",
      "statusKo": "성격",
      "reasons": [
        {
          "kind": "success",
          "kindKo": "성",
          "kindHan": "成",
          "text": "재성 또는 인성이 정관을 돕는다"
        }
      ],
      "reasoning": "성(成) 사유 1건(재성 또는 인성이 정관을 돕는다)이 있고 패 사유가 없어 성격으로 본다."
    },
    "extreme": {
      "candidate": null,
      "established": false,
      "pseudo": false,
      "type": null,
      "dominantGroup": null,
      "reasons": []
    },
    "sangsin": {
      "group": "inseong",
      "groupKo": "인성",
      "present": true,
      "reasoning": "정관은 재로 생하고 인으로 보호한다(순용)",
      "meaning": "용신이 인성이면 일간을 낳고 보호할 기운이 필요한 원국으로, 배움과 보호가 힘이 되는 방향으로 읽는다."
    },
    "meaning": "정관격은 월령의 기운이 규범과 명예로 드러나는 구조로, 재로 생하고 인으로 지키는 짜임이 갖춰졌는지를 본다.",
    "basis": [
      "월지 정기 을(乙)이 월간에 투출해 정관격으로 잡았다.",
      "격의 성패는 자평진전 論用神成敗救應의 규칙(순용 격은 생·호, 역용 격은 제복)으로 판정했고, 성중유패·패중유성은 mixed 로 표기했다."
    ]
  },
  "yongsin": {
    "primary": {
      "method": "eokbu",
      "methodKo": "억부",
      "group": "gwanseong",
      "groupKo": "관성",
      "element": "wood",
      "elementKo": "목",
      "elementHan": "木",
      "reasoning": "신강(60점, 비겁이 많아 강함)이라 관성→식상→재성 순으로 보아 원국에 있는 관성(목)을 억부용신으로 잡았다."
    },
    "secondary": {
      "method": "johu",
      "methodKo": "조후",
      "group": null,
      "element": "fire",
      "elementKo": "화",
      "elementHan": "火",
      "reasoning": "조후용신 병(丙)·갑(甲)·계(癸)(궁통보감)는 보조로 참고한다."
    },
    "eokbu": {
      "group": "gwanseong",
      "element": "wood",
      "elementKo": "목",
      "elementHan": "木",
      "cause": "비겁이 많아 강함",
      "candidates": [
        "gwanseong",
        "siksang",
        "… 외 1건"
      ],
      "presentInChart": true,
      "reasoning": "신강(60점, 비겁이 많아 강함)이라 관성→식상→재성 순으로 보아 원국에 있는 관성(목)을 억부용신으로 잡았다."
    },
    "johu": {
      "stems": [
        {
          "stem": "…"
        },
        {
          "stem": "…"
        },
        "… 외 1건"
      ],
      "urgent": false,
      "season": "봄",
      "reasoning": "봄생으로 한난이 극단이 아니라 조후는 보조로 본다.",
      "sourceQuote": "三春戊土,无丙照暖,戊土不生,无甲疏噼,戊土不灵,无癸滋润,万物不长。正二月先丙后甲,癸又次之",
      "verifiedInText": true
    },
    "gyeokgukYongsin": {
      "group": "inseong",
      "groupKo": "인성",
      "element": "fire",
      "elementKo": "화",
      "elementHan": "火",
      "present": true,
      "reasoning": "정관은 재로 생하고 인으로 보호한다(순용)"
    },
    "fiveGods": {
      "yongsin": {
        "element": "wood",
        "elementKo": "목",
        "elementHan": "木"
      },
      "huisin": {
        "element": "water",
        "elementKo": "수",
        "elementHan": "水"
      },
      "gisin": {
        "element": "metal",
        "elementKo": "금",
        "elementHan": "金"
      },
      "gusin": {
        "element": "earth",
        "elementKo": "토",
        "elementHan": "土"
      },
      "hansin": {
        "element": "fire",
        "elementKo": "화",
        "elementHan": "火"
      }
    },
    "agreement": false,
    "meaning": "억부용신은 강한 일간은 누르고 약한 일간은 돕는 오행을 고르는 방법으로, 원국의 힘의 균형을 맞추는 기준으로 읽는다. 용신이 관성이면 일간의 힘을 다스릴 규범이 필요한 원국으로, 책임과 질서가 균형을 잡는 방향으로 읽는다.",
    "basis": [
      "용신은 억부를 기본으로 하되 한난이 극단인 사주는 조후를, 종격은 지배 세력을 우선한다(D-06-1).",
      "희신은 용신을 생하는 오행(수), 기신은 용신을 극하는 오행(금), 구신은 기신을 생하는 오행(토), 한신은 나머지(화)다.",
      "… 외 2건"
    ]
  },
  "sinsal": {
    "auspicious": [
      {
        "id": "taegeuk",
        "ko": "태극귀인",
        "han": "太極貴人",
        "category": "auspicious",
        "positions": [
          "year",
          "day",
          "… 외 1건"
        ],
        "positionsKo": [
          "연주",
          "일주",
          "… 외 1건"
        ],
        "basis": [
          "일간 무(戊) → 지지 辰·戌·丑·未 (三命通會 論太極貴 甲乙子午·丙丁卯酉·戊己辰戌丑未·庚辛寅亥·壬癸申巳)"
        ],
        "source": "classic",
        "sourceKo": "원전(삼명통회)",
        "meaning": "태극귀인은 시작과 끝을 함께 보는 안목을 뜻하는 신살로, 깊이 있는 관심과 원리 탐구의 기운으로 읽는다."
      }
    ],
    "inauspicious": [
      {
        "id": "baekho",
        "ko": "백호",
        "han": "白虎",
        "category": "inauspicious",
        "positions": [
          "year",
          "day"
        ],
        "positionsKo": [
          "연주",
          "일주"
        ],
        "basis": [
          "기둥 간지가 甲辰·乙未·丙戌·丁丑·戊辰·壬戌·癸丑 중 하나"
        ],
        "source": "common",
        "sourceKo": "통용(현대 만세력)",
        "meaning": "백호는 강한 충격의 기운을 상징하는 간지로, 해당 기둥의 일에 급격한 변화가 있을 수 있는 신호로 읽는다."
      },
      {
        "id": "hongyeom",
        "ko": "홍염",
        "han": "紅艶",
        "category": "inauspicious",
        "positions": [
          "year",
          "day",
          "… 외 1건"
        ],
        "positionsKo": [
          "연주",
          "일주",
          "… 외 1건"
        ],
        "basis": [
          "일간 무(戊) → 지지 辰"
        ],
        "source": "common",
        "sourceKo": "통용(현대 만세력)",
        "meaning": "홍염은 붉은 빛으로 끄는 힘의 비유로, 매력과 정감이 두드러지는 기운으로 읽는다."
      }
    ],
    "twelveSinsal": {
      "byYear": {
        "year": {
          "id": "hwagae",
          "ko": "화개",
          "han": "華蓋",
          "meaning": "화개는 화려한 덮개라는 비유의 자리로, 예술·종교·학문처럼 혼자 깊어지는 기운으로 읽는다."
        },
        "month": {
          "id": "yukhae",
          "ko": "육해",
          "han": "六害",
          "meaning": "육해는 여섯 해로움이라는 이름의 자리로, 잔잔한 마찰과 방해가 놓일 수 있는 신호로 읽는다."
        },
        "day": {
          "id": "hwagae",
          "ko": "화개",
          "han": "華蓋",
          "meaning": "화개는 화려한 덮개라는 비유의 자리로, 예술·종교·학문처럼 혼자 깊어지는 기운으로 읽는다."
        },
        "hour": {
          "id": "hwagae",
          "ko": "화개",
          "han": "華蓋",
          "meaning": "화개는 화려한 덮개라는 비유의 자리로, 예술·종교·학문처럼 혼자 깊어지는 기운으로 읽는다."
        }
      },
      "byDay": {
        "year": {
          "id": "hwagae",
          "ko": "화개",
          "han": "華蓋",
          "meaning": "화개는 화려한 덮개라는 비유의 자리로, 예술·종교·학문처럼 혼자 깊어지는 기운으로 읽는다."
        },
        "month": {
          "id": "yukhae",
          "ko": "육해",
          "han": "六害",
          "meaning": "육해는 여섯 해로움이라는 이름의 자리로, 잔잔한 마찰과 방해가 놓일 수 있는 신호로 읽는다."
        },
        "day": {
          "id": "hwagae",
          "ko": "화개",
          "han": "華蓋",
          "meaning": "화개는 화려한 덮개라는 비유의 자리로, 예술·종교·학문처럼 혼자 깊어지는 기운으로 읽는다."
        },
        "hour": {
          "id": "hwagae",
          "ko": "화개",
          "han": "華蓋",
          "meaning": "화개는 화려한 덮개라는 비유의 자리로, 예술·종교·학문처럼 혼자 깊어지는 기운으로 읽는다."
        }
      }
    },
    "gongmang": {
      "xun": "갑자순",
      "xunHan": "甲子旬",
      "empties": [
        "술",
        "해"
      ],
      "emptiesHan": [
        "戌",
        "亥"
      ],
      "positions": [],
      "positionsKo": [],
      "meaning": "공망 지지 술·해가 원국 네 기둥에 없어 공망으로 비는 자리가 없는 구조로 본다."
    },
    "summary": {
      "auspiciousCount": 1,
      "inauspiciousCount": 2
    },
    "basis": [
      "신살은 길신 15종·흉/중립 17종의 규칙표(일간·년지·월지·일주·글자 기준)로 판정했고, 각 항목에 근거가 원전(삼명통회 권3)인지 현대 통용 규칙인지를 표시했다.",
      "12신살은 년지 기준을 기본으로 하고 일지 기준을 병기했으며, 공망은 일주가 속한 순(旬)의 빈 지지 두 개로 정했다.",
      "… 외 1건"
    ]
  },
  "evaluation": {
    "indicators": [
      {
        "id": "balance",
        "ko": "균형",
        "score": 42,
        "label": "보통",
        "basis": [
          "오행 분포 목2 화1 토5 금0 수0 의 표준편차 1.9(최대 3.2) 을 100점 척도로 뒤집었다."
        ],
        "meaning": "오행이 대체로 퍼져 있되 한두 기운이 도드라진 원국은 그 기운이 삶의 색깔을 정하는 구조로 본다."
      },
      {
        "id": "harmony",
        "ko": "중화",
        "score": 80,
        "label": "보통",
        "basis": [
          "신강약 60점(신강)이 중화(50)에서 얼마나 가까운지로 계산했다(높음은 81 이상 = 중화 구간)."
        ],
        "meaning": "일간의 힘이 강한 쪽으로 기운 원국은 그 방향을 보완하는 오행이 올 때 흐름이 살아나는 구조로 본다."
      },
      "… 외 3건"
    ],
    "keywords": [
      "자립",
      "규범",
      "… 외 1건"
    ],
    "strengths": [],
    "cautions": [
      {
        "id": "stability",
        "ko": "관계 안정",
        "score": 0,
        "label": "낮음",
        "meaning": "충·형이 합보다 많은 원국은 자리마다 움직임이 잦아 변화를 다루는 힘이 과제가 되는 구조로 본다.",
        "basis": [
          "관계 안정 0점은 낮음 구간(34점 미만)이라 주의점으로 뽑았다.",
          "합 0건 대 충·형(1)·파·해(0.5) 4.5건의 비율."
        ]
      }
    ],
    "lifeFlow": [
      {
        "order": 1,
        "ganji": "병진",
        "ganjiHan": "丙辰",
        "startAge": 7,
        "support": "부담",
        "reasoning": "1번째 대운 병진(丙辰)은 천간 화(한신)·지지 토(구신)라 부담으로 본다."
      },
      {
        "order": 2,
        "ganji": "정사",
        "ganjiHan": "丁巳",
        "startAge": 17,
        "support": "중립",
        "reasoning": "2번째 대운 정사(丁巳)는 천간 화(한신)·지지 화(한신)라 중립으로 본다."
      },
      "… 외 11건"
    ],
    "yearOutlook": {
      "calendarYear": 2026,
      "ganji": "병오",
      "ganjiHan": "丙午",
      "support": "중립",
      "reasoning": "2026년 세운 병오(丙午)는 천간 화(한신)·지지 화(한신)라 중립으로 본다."
    },
    "yongsinGuide": {
      "yongsin": {
        "element": "wood",
        "elementKo": "목",
        "elementHan": "木"
      },
      "huisin": {
        "element": "water",
        "elementKo": "수",
        "elementHan": "水"
      },
      "gisin": {
        "element": "metal",
        "elementKo": "금",
        "elementHan": "金"
      },
      "meaning": "용신이 관성이면 일간의 힘을 다스릴 규범이 필요한 원국으로, 책임과 질서가 균형을 잡는 방향으로 읽는다."
    },
    "basis": [
      "다섯 지표는 각각 0~100 이며 총점이나 등급은 내지 않는다(사주를 줄 세우지 않기 위함). 라벨은 67 이상 높음, 34 이상 보통, 그 미만 낮음이되, 중화(50 근접도)만 81 이상을 높음으로 둔다(신강약 중화 구간과 일치). 강점은 높음 지표, 주의점은 낮음 지표만 싣는다.",
      "인생 흐름과 연간 전망은 대운·세운의 천간·지지 오행이 용신·희신이면 지원, 기신·구신이면 부담, 그 밖은 중립으로 표시했다.",
      "… 외 1건"
    ]
  }
}

반환 형식

모듈마다 최상위 필드입니다. 스키마는 실제 응답에서 생성되므로 손으로 쓴 설명과 달리 어긋날 수 없습니다.

fourPillars

담기는 토픽: 만세력 · 오늘의 운세 · 일일 운세 · 월 운세 · 연간 운세 · 대운 10년 · 평생 흐름 · 고민 상담 · 관계 궁합 · 연애 운 · 금전운 · 건강운 · 전체 스키마

필드타입
pillarsobject객체 · 하위 4개
hourKnownboolean
dayMasterobject객체 · 하위 3개
monthTermobject객체 · 하위 8개
saryeongobject객체 · 하위 6개
yearBoundaryobject객체 · 하위 3개
hourBoundarynull|object
basisarray배열

seun

담기는 토픽: 오늘의 운세 · 일일 운세 · 월 운세 · 연간 운세 · 대운 10년 · 고민 상담 · 연애 운 · 금전운 · 건강운 · 전체 스키마

필드타입
referenceYearinteger
windowinteger
entriesarray배열
currentobject객체 · 하위 18개
basisarray배열

weolun

담기는 토픽: 오늘의 운세 · 일일 운세 · 월 운세 · 연간 운세 · 연애 운 · 전체 스키마

필드타입
natalSaryeongobject객체 · 하위 8개
referenceMonthstring
termsarray배열
basisarray배열

decadeFortune

담기는 토픽: 만세력 · 일일 운세 · 연간 운세 · 대운 10년 · 평생 흐름 · 고민 상담 · 관계 궁합 · 연애 운 · 금전운 · 전체 스키마

필드타입
directionstring
directionKostring
startAgeinteger
startAgeExactnumber
firstStartsOnstring
countedToobject객체 · 하위 3개
entriesarray배열
selectionobject객체 · 하위 4개
currentobject객체 · 하위 3개
basisarray배열

gyeokguk

담기는 토픽: 연간 운세 · 평생 흐름 · 고민 상담 · 관계 궁합 · 연애 운 · 전체 스키마

필드타입
idstring
kostring
hanstring
kindstring
basedOnnull|object
formationobject객체 · 하위 4개
extremeobject객체 · 하위 6개
sangsinnull|object
meaningstring
basisarray배열

yongsin

담기는 토픽: 월 운세 · 연간 운세 · 대운 10년 · 평생 흐름 · 고민 상담 · 관계 궁합 · 연애 운 · 금전운 · 건강운 · 전체 스키마

필드타입
primaryobject객체 · 하위 8개
secondaryobject객체 · 하위 7개
eokbuobject객체 · 하위 8개
johuobject객체 · 하위 6개
gyeokgukYongsinnull|object
fiveGodsobject객체 · 하위 5개
agreementboolean
meaningstring
basisarray배열

sinsal

담기는 토픽: 만세력 · 오늘의 운세 · 일일 운세 · 월 운세 · 연간 운세 · 대운 10년 · 평생 흐름 · 고민 상담 · 관계 궁합 · 연애 운 · 금전운 · 건강운 · 전체 스키마

필드타입
auspiciousarray배열
inauspiciousarray배열
twelveSinsalobject객체 · 하위 2개
gongmangobject객체 · 하위 7개
summaryobject객체 · 하위 2개
basisarray배열

evaluation

담기는 토픽: 연간 운세 · 평생 흐름 · 고민 상담 · 관계 궁합 · 연애 운 · 전체 스키마

필드타입
indicatorsarray배열
keywordsarray배열
strengthsarray배열
cautionsarray배열
lifeFlowarray배열
yearOutlookobject객체 · 하위 5개
yongsinGuideobject객체 · 하위 4개
basisarray배열

해설 문장

이 응답에는 해설 문장 113개와 용어 91종이 실립니다. 문장은 종류마다 하는 일이 다릅니다.

필드문장하는 일
meaning72판정을 사람 말로 옮긴 것 — 요약·톤 변환의 재료
reasoning28어떤 규칙을 밟아 그렇게 정했는지
positionMeaning11그 자리에 놓였을 때의 뜻
text1
cause1

reasoning 예시

meaning 예시

활용 지침 — data.guide

응답에 이 지침이 함께 실립니다. 고객이 별도 시스템 프롬프트를 쓰지 않아도 활용법이 같이 전달됩니다.

목적: 그 해 1년의 흐름은? — 연간 운세 토픽의 계산 결과입니다.

1. data.modules 는 계산된 사실 근거입니다 — 여기에 없는 사실을 지어내지 마세요.
2. data.modules 의 키 순서가 해석 순서입니다 — 원국(fourPillars)부터 그 순서대로 읽으세요.
3. meaning·basis·reasoning·positionMeaning 필드가 판정 결론이 담긴 문장 재료입니다 — 요약과 톤 변환만으로 풀이를 만들 수 있습니다.
4. data.glossary 는 이 응답에 나온 명리 용어의 뜻입니다 — 이 뜻을 기준으로 삼고 다르게 정의하지 마세요.
5. 숫자는 분기·정렬에만 쓰고, 문장에는 함께 담긴 말(label·phase·season)을 쓰세요.
6. 세운이 축입니다 — 전년·당해·다음해 3개년의 흐름으로 구성하세요. data.modules.seun.entries 에 세 해가 모두 있습니다.

LLM 연동

판정을 LLM 에게 다시 시키지 마십시오. 응답의 문장을 요약하고 톤만 바꾸게 하십시오. 사주 판정을 LLM 이 하면 그럴듯한 오답이 나오고, 문장이 매끄러워서 틀린 줄을 모릅니다.

[시스템]
data.modules 는 계산된 사실 근거입니다 — 여기에 없는 사실을 지어내지 마세요.
아래 '계산된 사실' 밖의 내용을 말하지 마세요.

[사용자]
{"guide":"…","glossary":"…","modules":"…"}

존댓말로 6문장. 첫 문장은 결론, 마지막 문장은 주의점.

← 월 운세 · 대운 10년 →