엔드포인트
오늘의 운세 유료
오늘 하루, 이 사주에 무엇이 작용하나?
POST https://api.supasaju.com/v2/saju/today
무엇을 담나
오늘 하루에 무엇이 작용하는지만 봅니다. 그날의 일진과 일간의 관계가 축이고, 월운·세운이 그 하루가 놓인 큰 흐름을 받쳐 줍니다. 매일 갱신되는 짧은 카드에 맞는 구성입니다. 기준일은 요청의 date 로 옮길 수 있습니다.
| 포함 모듈 | fourPillars · dailyInteraction · sinsal · weolun · seun |
| 핵심 모듈 | dailyInteraction — 이것이 빠지면 이 토픽은 성립하지 않습니다 |
| 기준 시점 | date(YYYY-MM-DD)로 기준일을 옮길 수 있습니다. 생략하면 오늘입니다. |
| 상대 | 상대를 받지 않습니다. |
| 최소 플랜 | 유료 — Free 키는 샘플 프로필 입력일 때만 이 구성으로 응답합니다 |
| 응답 무게 | 약 45KB · 대략 20,719토큰 — 통째로 LLM 에 넣기 전에 줄이는 법을 보십시오 |
요청
curl -X POST https://api.supasaju.com/v2/saju/today \
-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": "서울",
"date": "2026-09-17"
}'const res = await fetch('https://api.supasaju.com/v2/saju/today', {
method: 'POST',
headers: {
'x-api-key': process.env.SAJU_API_KEY!,
'content-type': 'application/json',
},
body: JSON.stringify({
"birthYear": 1988,
"birthMonth": 3,
"birthDay": 14,
"birthHour": 9,
"birthMinute": 20,
"isFemale": false,
"isLunar": false,
"birthCity": "서울",
"date": "2026-09-17"
}),
})
const { data } = await res.json()
// 판정 근거 문장만 모읍니다 — 이게 풀이의 재료입니다.
const facts: string[] = []
const walk = (v: unknown, path = ''): void => {
if (Array.isArray(v)) return v.forEach((x, i) => walk(x, `${path}[${i}]`))
if (v === null || typeof v !== 'object') return
for (const [k, x] of Object.entries(v)) {
if (typeof x === 'string' && ['reasoning', 'basis', 'meaning'].includes(k)) facts.push(x)
else walk(x, path ? `${path}.${k}` : k)
}
}
walk(data.modules)
// guide 와 glossary 를 함께 실어 넘깁니다.
const prompt = [
data.guide.purpose,
...data.guide.howToUse,
'',
'용어의 뜻:',
...Object.entries(data.glossary).map(([t, d]) => `- ${t}: ${d}`),
'',
'계산된 사실:',
...facts.map((f) => `- ${f}`),
'',
'위 사실만으로 존댓말 6문장으로 풀어 주세요.',
].join('\n')import os, json, requests
res = requests.post(
"https://api.supasaju.com/v2/saju/today",
headers={"x-api-key": os.environ["SAJU_API_KEY"]},
json={
"birthYear": 1988,
"birthMonth": 3,
"birthDay": 14,
"birthHour": 9,
"birthMinute": 20,
"isFemale": False,
"isLunar": False,
"birthCity": "서울",
"date": "2026-09-17"
},
)
data = res.json()["data"]
# 판정 근거 문장만 모읍니다 — 이게 풀이의 재료입니다.
FACT_KEYS = {"reasoning", "basis", "meaning"}
facts = []
def walk(v):
if isinstance(v, list):
for x in v:
walk(x)
elif isinstance(v, dict):
for k, x in v.items():
if isinstance(x, str) and k in FACT_KEYS:
facts.append(x)
else:
walk(x)
walk(data["modules"])
# guide 와 glossary 를 함께 실어 넘깁니다.
prompt = "\n".join([
data["guide"]["purpose"],
*data["guide"]["howToUse"],
"",
"용어의 뜻:",
*[f"- {t}: {d}" for t, d in data["glossary"].items()],
"",
"계산된 사실:",
*[f"- {f}" for f in facts],
"",
"위 사실만으로 존댓말 6문장으로 풀어 주세요.",
])공통 요청 필드는 문서 홈에 정리되어 있습니다. 위 예시의 생년월일은 샘플 프로필이라 Free 키로 그대로 재현됩니다.
응답
아래는 위 요청의 실제 응답입니다. 봉투를 먼저 보이고, 핵심 모듈
dailyInteraction 을 펼쳐 실었습니다. 나머지 모듈은 접어 두었습니다 —
전체 형태는 스키마 파일과 OpenAPI에 있습니다.
봉투
{
"topic": "today",
"guide": {
"purpose": "오늘 하루, 이 사주에 무엇이 작용하나? — 오늘의 운세 토픽의 계산 결과입니다.",
"howToUse": [
"… 6줄"
]
},
"glossary": {
"진태양시": {
"definition": "출생지의 경도와 균시차까지 반영한 실제 태양 기준 시각.",
"en": "True Solar Time"
},
"태극귀인": {
"definition": "일간을 기준으로 잡는 길신. 시작과 마무리가 이어지는 자리로 본다.",
"en": "Taiji Nobleman"
},
"…": "외 72종"
},
"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": "…",
"dailyInteraction": "…",
"sinsal": "…",
"weolun": "…",
"seun": "…"
},
"diagnostics": [],
"ruleset": {
"version": "0.2.2",
"profile": "ko-standard",
"data": {
"tzdata": "2026c",
"tzdataBuild": "backzone",
"tzZones": 418,
"ephemeris": "DE440s",
"lunarVerifiedThrough": 2050,
"solarTermsVerifiedRange": "2000-2028"
}
}
}
핵심 모듈 — dailyInteraction
{
"date": "2026-09-17",
"weekday": 4,
"weekdayKo": "목요일",
"ganji": "갑오",
"ganjiHan": "甲午",
"ganjiIndex": 30,
"stem": {
"index": 0,
"han": "甲",
"ko": "갑",
"element": "wood",
"elementKo": "목",
"elementHan": "木",
"polarity": "yang",
"polarityKo": "양",
"sipseong": {
"id": "pyeongwan",
"ko": "편관",
"han": "偏官",
"group": "gwanseong",
"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": {
"id": "pyeonin",
"ko": "편인",
"han": "偏印",
"group": "inseong",
"groupKo": "인성"
}
},
"role": "yeogi",
"roleKo": "여기",
"roleHan": "餘氣",
"days": 10
},
{
"stem": {
"index": 5,
"han": "己",
"ko": "기",
"element": "earth",
"elementKo": "토",
"elementHan": "土",
"polarity": "yin",
"polarityKo": "음",
"sipseong": {
"id": "geopjae",
"ko": "겁재",
"han": "劫財",
"group": "bigeop",
"groupKo": "비겁"
}
},
"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": "일진 지지 오(午, 정인)가 월지 묘(卯, 정관)와 파를 이루어 정관 자리의 결속이 느슨해지는 신호로 읽는다."
}
],
"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": "운의 천간에 편관이 오면 책임과 압력이 커지며 감당하는 힘이 시험되는 때로 읽는다. 운의 지지가 일간에게 제왕이면 힘이 정점에 이르러 조절이 함께 필요한 때로 읽는다.",
"basis": [
"2026-09-17 의 일진 갑오(甲午)는 60갑자 순환(1900-01-01 甲戌 기준)으로 정했고, 하루의 경계는 달력 날짜 그대로 둔다.",
"일진 간지를 원국 네 기둥과 대조해 십성·12운성·합충형파해·12신살·공망을 냈다."
]
}
나머지 모듈 4종 펼치기
{
"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건"
]
},
"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건"
]
},
"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)가 속한 절월부터, 달 안에서 절입이 지나면 다음 절월까지 함께 낸다.",
"월운 간지의 월간은 해당 절월이 속한 연간(입춘 기준)에서 오호둔으로 정했다."
]
},
"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": "…"
},
"branch": {
"index": 6,
"han": "午",
"ko": "오",
"element": "fire",
"elementKo": "화",
"elementHan": "火",
"polarity": "yang",
"polarityKo": "양",
"animalKo": "말",
"sipseong": "…",
"hiddenStems": [
"…",
"…",
"… 외 1건"
]
},
"twelveStage": {
"id": "jewang",
"ko": "제왕",
"han": "帝旺",
"order": 5,
"keyword": "절정",
"phase": "정점",
"meaning": "제왕은 기운이 가장 왕성한 단계로, 힘이 넘치되 넘친 만큼 조절이 필요한 흐름으로 본다."
},
"relations": [
"…"
],
"twelveSinsal": {
"byYear": "…",
"byDay": "…"
},
"fortuneSinsal": [
"…"
],
"sinsalOnFortune": [
"…"
],
"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": [
"…",
"…",
"… 외 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신살·공망을 냈다."
]
}
}
반환 형식
모듈마다 최상위 필드입니다. 스키마는 실제 응답에서 생성되므로 손으로 쓴 설명과 달리 어긋날 수 없습니다.
fourPillars
담기는 토픽: 만세력 · 오늘의 운세 · 일일 운세 · 월 운세 · 연간 운세 · 대운 10년 · 평생 흐름 · 고민 상담 · 관계 궁합 · 연애 운 · 금전운 · 건강운 · 전체 스키마
| 필드 | 타입 | |
|---|---|---|
pillars | object | 객체 · 하위 4개 |
hourKnown | boolean | |
dayMaster | object | 객체 · 하위 3개 |
monthTerm | object | 객체 · 하위 8개 |
saryeong | object | 객체 · 하위 6개 |
yearBoundary | object | 객체 · 하위 3개 |
hourBoundary | null|object | |
basis | array | 배열 |
dailyInteraction
담기는 토픽: 오늘의 운세 · 일일 운세 · 전체 스키마
| 필드 | 타입 | |
|---|---|---|
date | string | |
weekday | integer | |
weekdayKo | string | |
ganji | string | |
ganjiHan | string | |
ganjiIndex | integer | |
stem | object | 객체 · 하위 9개 |
branch | object | 객체 · 하위 11개 |
twelveStage | object | 객체 · 하위 7개 |
relations | array | 배열 |
twelveSinsal | object | 객체 · 하위 2개 |
fortuneSinsal | array | 배열 |
sinsalOnFortune | array | 배열 |
isGongmang | boolean | |
meaning | string | |
basis | array | 배열 |
sinsal
담기는 토픽: 만세력 · 오늘의 운세 · 일일 운세 · 월 운세 · 연간 운세 · 대운 10년 · 평생 흐름 · 고민 상담 · 관계 궁합 · 연애 운 · 금전운 · 건강운 · 전체 스키마
| 필드 | 타입 | |
|---|---|---|
auspicious | array | 배열 |
inauspicious | array | 배열 |
twelveSinsal | object | 객체 · 하위 2개 |
gongmang | object | 객체 · 하위 7개 |
summary | object | 객체 · 하위 2개 |
basis | array | 배열 |
weolun
담기는 토픽: 오늘의 운세 · 일일 운세 · 월 운세 · 연간 운세 · 연애 운 · 전체 스키마
| 필드 | 타입 | |
|---|---|---|
natalSaryeong | object | 객체 · 하위 8개 |
referenceMonth | string | |
terms | array | 배열 |
basis | array | 배열 |
seun
담기는 토픽: 오늘의 운세 · 일일 운세 · 월 운세 · 연간 운세 · 대운 10년 · 고민 상담 · 연애 운 · 금전운 · 건강운 · 전체 스키마
| 필드 | 타입 | |
|---|---|---|
referenceYear | integer | |
window | integer | |
entries | array | 배열 |
current | object | 객체 · 하위 18개 |
basis | array | 배열 |
해설 문장
이 응답에는 해설 문장 72개와 용어 74종이 실립니다. 문장은 종류마다 하는 일이 다릅니다.
| 필드 | 문장 | 하는 일 |
|---|---|---|
meaning | 54 | 판정을 사람 말로 옮긴 것 — 요약·톤 변환의 재료 |
positionMeaning | 11 | 그 자리에 놓였을 때의 뜻 |
reasoning | 7 | 어떤 규칙을 밟아 그렇게 정했는지 |
reasoning 예시
- dailyInteraction.relations[0].reasoning일진 지지 오(午, 정인)가 월지 묘(卯, 정관)와 파를 이루어 정관 자리의 결속이 느슨해지는 신호로 읽는다.
- weolun.terms[1].relations[0].reasoning월운 지지 유(酉, 상관)가 연지 진(辰, 비견)과 육합을 이루어 비견 자리가 묶여 움직임이 둔해지는 신호로 읽는다.
- weolun.terms[1].relations[1].reasoning월운 지지 유(酉, 상관)가 월지 묘(卯, 정관)와 충을 이루어 정관 자리가 흔들리며 변화가 일어나는 신호로 읽는다.
meaning 예시
- fourPillars.pillars.year.stem.sipseong.meaning비견은 일간과 같은 오행·같은 음양의 기운으로, 나와 어깨를 나란히 하는 동료·형제와 자기 주장의 힘으로 읽는다.
- fourPillars.pillars.year.branch.sipseong.meaning비견은 일간과 같은 오행·같은 음양의 기운으로, 나와 어깨를 나란히 하는 동료·형제와 자기 주장의 힘으로 읽는다.
- fourPillars.pillars.year.twelveStage.meaning관대는 기운이 형태를 갖추고 옷을 입듯 사회적 모습을 갖추는 단계로, 의욕과 자기 표현이 커지는 흐름으로 본다.
활용 지침 — data.guide
응답에 이 지침이 함께 실립니다. 고객이 별도 시스템 프롬프트를 쓰지 않아도 활용법이 같이 전달됩니다.
목적: 오늘 하루, 이 사주에 무엇이 작용하나? — 오늘의 운세 토픽의 계산 결과입니다.
1. data.modules 는 계산된 사실 근거입니다 — 여기에 없는 사실을 지어내지 마세요.
2. data.modules 의 키 순서가 해석 순서입니다 — 원국(fourPillars)부터 그 순서대로 읽으세요.
3. meaning·basis·reasoning·positionMeaning 필드가 판정 결론이 담긴 문장 재료입니다 — 요약과 톤 변환만으로 풀이를 만들 수 있습니다.
4. data.glossary 는 이 응답에 나온 명리 용어의 뜻입니다 — 이 뜻을 기준으로 삼고 다르게 정의하지 마세요.
5. 숫자는 분기·정렬에만 쓰고, 문장에는 함께 담긴 말(label·phase·season)을 쓰세요.
6. data.reference.date 가 기준일입니다 — 풀이에 그 날짜를 명시하세요.
LLM 연동
판정을 LLM 에게 다시 시키지 마십시오. 응답의 문장을 요약하고 톤만 바꾸게 하십시오. 사주 판정을 LLM 이 하면 그럴듯한 오답이 나오고, 문장이 매끄러워서 틀린 줄을 모릅니다.
[시스템]
data.modules 는 계산된 사실 근거입니다 — 여기에 없는 사실을 지어내지 마세요.
아래 '계산된 사실' 밖의 내용을 말하지 마세요.
[사용자]
{"guide":"…","glossary":"…","modules":"…"}
존댓말로 6문장. 첫 문장은 결론, 마지막 문장은 주의점.