명리 계산 API
사주를 계산해 드립니다.
풀이는 당신의 LLM 이 씁니다.
생년월일을 보내면 원국·대운·격국·용신까지 14개 분석 모듈을 JSON 으로 돌려줍니다. 판정마다 왜 그렇게 봤는지가 문장으로 함께 실리고, 그 응답에 나온 명리 용어의 뜻까지 같이 갑니다. 그대로 프롬프트에 넣으면 풀이가 나옵니다.
카드 없이 시작합니다 · Free 월 300건
왜 계산을 따로 사야 하나요?
LLM 에게 사주를 직접 시키면 그럴듯한 오답이 나옵니다. 절기 경계에서 월주가 바뀌는 것, 자시가 날짜를 넘기는 것, 대운이 성별·음양에 따라 순역이 갈리는 것 — 전부 규칙이지 추론이 아닙니다. 틀려도 문장은 매끄러워서 틀린 줄을 모릅니다. 판정은 저희가 계산하고, LLM 은 그 판정을 사람 말로 옮기는 일만 하는 편이 안전합니다.
응답에 담기는 것
세 겹으로 옵니다
reasoning — 판단의 경로
어떤 규칙을 밟아 그 결론에 왔는지.
- 연지 진(辰, 비견)과 월지 묘(卯, 정관)가 멀리 떨어져 약하게 해를 이루어 비견과 정관 사이에 은근한 마찰이 있는 구조로 본다.
- 연지 진(辰, 비견)과 일지 진(辰, 비견)이 한 칸 건너 자형을 이루어 비견의 기운이 과해져 안에서 마찰이 생기는 구조로 본다.
basis — 원전 근거
그 판정의 출처. 고전 원문까지 답니다.
glossary — 용어의 뜻
응답에 실제로 나온 용어만. 영문 용어명이 함께 가서, 영어로 옮길 때도 말이 흔들리지 않습니다.
- 진태양시 True Solar Time — 출생지의 경도와 균시차까지 반영한 실제 태양 기준 시각.
- 태극귀인 Taiji Nobleman — 일간을 기준으로 잡는 길신. 시작과 마무리가 이어지는 자리로 본다.
- 지장간 Hidden Stems — 지지 속에 감춰진 천간. 겉으로 드러나지 않은 기운을 읽는 자리다.
위는 POST /v2/saju/life 의 실제 응답에서 뽑은 것입니다.
이 한 번의 호출에 해설 문장 94개, 용어 79종이 실립니다.
시작
한 번 부르면 이만큼 옵니다
curl -X POST https://api.supasaju.com/v2/saju/manse \
-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": "서울"
}'{
"topic": "manse",
"guide": {
"purpose": "이 사람의 사주 명식은 어떻게 생겼나? — 만세력 토픽의 계산 결과입니다.",
"howToUse": [
"data.modules 는 계산된 사실 근거입니다 — 여기에 없는 사실을 지어내지 마세요.",
"… 외 5건"
]
},
"glossary": {
"진태양시": {
"definition": "출생지의 경도와 균시차까지 반영한 실제 태양 기준 시각.",
"en": "True Solar Time"
},
"태극귀인": {
"definition": "일간을 기준으로 잡는 길신. 시작과 마무리가 이어지는 자리로 본다.",
"en": "Taiji Nobleman"
},
"지장간": {
"definition": "지지 속에 감춰진 천간. 겉으로 드러나지 않은 기운을 읽는 자리다.",
"en": "Hidden Stems"
},
"원국": {
"definition": "태어날 때 정해진 사주 여덟 글자 자체. 운의 변화와 구분해 부르는 말.",
"en": "Natal Chart"
},
"천간": {
"definition": "갑을병정무기경신임계 열 글자. 간지의 윗글자로 겉으로 드러나는 기운을 나타낸다.",
"en": "Heavenly Stems"
},
"지지": {
"definition": "자축인묘진사오미신유술해 열두 글자. 간지의 아랫글자로 바탕과 자리를 나타낸다.",
"en": "Earthly Branches"
},
"간지": {
"definition": "천간 한 글자와 지지 한 글자를 짝지은 표기. 60가지가 순환한다.",
"en": "Stem-Branch Pair"
},
"일간": {
"definition": "태어난 날의 윗글자. 사주에서 본인을 나타내며 모든 판단의 기준점이 된다.",
"en": "Day Master"
},
"일지": {
"definition": "태어난 날의 아랫글자. 배우자와 가장 가까운 관계의 자리로 본다.",
"en": "Day Branch"
},
"연주": {
"definition": "태어난 해의 간지. 뿌리와 조상, 이른 시기의 자리로 본다.",
"en": "Year Pillar"
},
"월주": {
"definition": "태어난 달의 간지. 절기로 나뉘며 사회적 환경과 성장기의 자리로 본다.",
"en": "Month Pillar"
},
"일주": {
"definition": "태어난 날의 간지. 본인과 배우자 자리를 함께 담는다.",
"en": "Day Pillar"
},
"시주": {
"definition": "태어난 시각의 간지. 말년과 자녀, 결과의 자리로 본다.",
"en": "Hour Pillar"
},
"오행": {
"definition": "목·화·토·금·수 다섯 기운. 서로 낳고(상생) 누르며(상극) 균형을 이룬다.",
"en": "Five Phases",
"enAlias": "Five Elements"
},
"음양": {
"definition": "모든 기운을 나누는 두 성질. 양은 드러나고 뻗는 쪽, 음은 안으로 모으는 쪽이다.",
"en": "Yin and Yang"
},
"비견": {
"definition": "나와 어깨를 나란히 하는 기운. 자립과 경쟁을 함께 뜻한다.",
"en": "Friend"
},
"겁재": {
"definition": "나와 같되 결이 다른 기운. 협력도 다툼도 될 수 있다.",
"en": "Rob Wealth"
},
"식신": {
"definition": "내가 밖으로 내보내는 기운. 표현과 먹고사는 일, 여유를 뜻한다.",
"en": "Eating God"
},
"상관": {
"definition": "내보내는 기운 중 날이 선 쪽. 재능과 반발이 함께 있다.",
"en": "Hurting Officer"
},
"편재": {
"definition": "넓게 흐르는 재물의 기운. 활동 범위와 기회를 뜻한다.",
"en": "Indirect Wealth"
},
"정재": {
"definition": "꾸준히 쌓이는 재물의 기운. 성실함과 관리를 뜻한다.",
"en": "Direct Wealth"
},
"편관": {
"definition": "나를 강하게 누르는 기운. 압박과 돌파를 함께 뜻한다.",
"en": "Seven Killings"
},
"정관": {
"definition": "나를 규율하는 기운. 직위·질서·책임을 뜻한다.",
"en": "Direct Officer"
},
"편인": {
"definition": "치우친 방향으로 나를 돕는 기운. 직관과 비주류 재능을 뜻한다.",
"en": "Indirect Resource"
},
"정인": {
"definition": "바르게 나를 돕는 기운. 배움과 보호를 뜻한다.",
"en": "Direct Resource"
},
"비겁": {
"definition": "비견과 겁재를 묶어 부르는 말. 나와 같은 기운의 무리.",
"en": "Companion Group"
},
"식상": {
"definition": "식신과 상관을 묶어 부르는 말. 내보내는 기운의 무리.",
"en": "Output Group"
},
"재성": {
"definition": "편재와 정재를 묶어 부르는 말. 내가 다루는 대상의 무리.",
"en": "Wealth Group"
},
"관성": {
"definition": "편관과 정관을 묶어 부르는 말. 나를 규율하는 기운의 무리.",
"en": "Officer Group"
},
"인성": {
"definition": "편인과 정인을 묶어 부르는 말. 나를 돕는 기운의 무리.",
"en": "Resource Group"
},
"대운": {
"definition": "10년 단위로 바뀌는 큰 흐름. 절기까지의 거리로 시작 나이가 정해진다.",
"en": "Ten-year cycle",
"enAlias": "Luck Pillar"
},
"순행": {
"definition": "대운이 월주 다음 간지부터 순서대로 나아가는 방향.",
"en": "Forward Sequence"
},
"역행": {
"definition": "대운이 월주 이전 간지로 거슬러 가는 방향.",
"en": "Reverse Sequence"
},
"입춘": {
"definition": "스물넷 절기의 처음. 사주에서 해가 바뀌는 기준점이다.",
"en": "Start of Spring"
},
"장생": {
"definition": "십이운성의 한 단계. 갓 태어나 자라기 시작하는 기세.",
"en": "Growth"
},
"제왕": {
"definition": "십이운성의 한 단계. 기세가 가장 찬 자리.",
"en": "Emperor"
},
"신강": {
"definition": "일간을 돕는 기운이 많아 기세가 강한 상태.",
"en": "Strong Day Master"
},
"득령": {
"definition": "태어난 달의 기운이 일간을 돕는 것.",
"en": "Seasonal Support"
},
"득지": {
"definition": "태어난 날의 아랫글자가 일간을 돕는 것.",
"en": "Day-Branch Support"
},
"득세": {
"definition": "나머지 자리에서 일간을 돕는 기운을 얻은 것.",
"en": "Peer Support"
},
"신살": {
"definition": "특정 글자 조합에 붙는 이름표. 작용의 성격을 가리키며 그 자체로 좋고 나쁨을 뜻하지 않는다.",
"en": "Symbolic Star"
},
"공망": {
"definition": "육십갑자를 열 개씩 묶을 때 짝이 비는 두 지지. 비어 있는 자리로 읽는다.",
"en": "Void"
},
"목욕": {
"definition": "십이운성의 한 단계. 갓 태어나 씻기는 때로, 다듬어지기 전의 기세.",
"en": "Bath"
},
"관대": {
"definition": "십이운성의 한 단계. 옷을 갖춰 입고 나서는 때의 기세.",
"en": "Cap and Gown"
},
"육해": {
"definition": "십이신살의 하나. 흐름이 막히거나 늦춰지는 자리로 읽는다.",
"en": "Six Harms Star"
},
"화개": {
"definition": "십이신살의 하나. 안으로 거두어 갈무리하는 힘. 학문·예술·종교의 자리로도 본다.",
"en": "Canopy Star"
},
"건록": {
"definition": "십이운성의 한 단계이자 일간이 제 힘을 얻는 지지. 제 몫을 스스로 얻는 기세로 본다.",
"en": "Prosperity"
},
"양인": {
"definition": "일간의 기세가 지나치게 센 자리. 힘이 크되 다루기 어렵다는 뜻으로 읽는다.",
"en": "Yang Blade"
},
"백호": {
"definition": "특정 간지에 붙는 이름. 급하게 벌어지는 일과 이어 읽는 전통이 있다.",
"en": "White Tiger"
},
"홍염": {
"definition": "사람을 끌어당기는 힘을 가리키는 이름. 좋고 나쁨을 가리지 않는다.",
"en": "Red Beauty"
},
"여기": {
"definition": "지장간 가운데 앞 절기에서 넘어온 기운.",
"en": "Residual Qi"
},
"중기": {
"definition": "지장간 가운데 사이에 낀 기운.",
"en": "Middle Qi"
},
"정기": {
"definition": "지장간 가운데 그 지지를 대표하는 기운.",
"en": "Main Qi"
},
"뿌리": {
"definition": "천간이 지지 속에서 같은 오행의 힘을 얻은 것. 통근과 같은 말.",
"en": "Root"
},
"균형": {
"definition": "오행이 고르게 퍼져 있는 정도. 우리가 매기는 종합평가 지표의 하나.",
"en": "Balance"
},
"순환": {
"definition": "오행이 서로 낳으며 고리를 이루는 정도. 우리가 매기는 종합평가 지표의 하나.",
"en": "Circulation"
},
"목": {
"definition": "뻗어 나가는 기운. 시작·성장·계획을 상징한다.",
"en": "Wood"
},
"화": {
"definition": "퍼지는 기운. 표현·열정·드러남을 상징한다.",
"en": "Fire"
},
"토": {
"definition": "머무는 기운. 중심·신뢰·매개를 상징한다.",
"en": "Earth"
},
"금": {
"definition": "거두는 기운. 결단·정리·규율을 상징한다.",
"en": "Metal"
},
"수": {
"definition": "흐르는 기운. 사고·유연함·저장을 상징한다.",
"en": "Water"
},
"묘": {
"definition": "십이운성의 한 단계. 갈무리해 안으로 거두는 기세.",
"en": "Tomb"
},
"절": {
"definition": "십이운성의 한 단계. 이어지던 흐름이 끊겨 비는 자리.",
"en": "Extinction"
},
"해": {
"definition": "두 글자가 서로를 거스르는 관계.",
"en": "Harm"
},
"쇠": {
"definition": "십이운성의 한 단계. 정점을 지나 기세가 누그러지는 때.",
"en": "Decline"
},
"병": {
"definition": "십이운성의 한 단계. 힘이 빠져 속도를 늦추는 때.",
"en": "Sickness"
},
"사": {
"definition": "십이운성의 한 단계. 움직임이 멎고 안으로 도는 때.",
"en": "Death"
},
"태": {
"definition": "십이운성의 한 단계. 아직 형태를 갖추기 전 잉태된 기운.",
"en": "Conception"
},
"양": {
"definition": "십이운성의 한 단계. 길러지며 때를 기다리는 기운.",
"en": "Nurture"
}
},
"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": {
"pillars": "…",
"hourKnown": true,
"dayMaster": "…",
"monthTerm": "…",
"saryeong": "…",
"yearBoundary": "…",
"hourBoundary": "…",
"basis": [
"연주는 입춘 절입 순간(1988-02-04 23:43 KST)을 기준으로 정했다.",
"… 외 3건"
]
},
"elements": {
"counts": [
"…",
"… 외 4건"
],
"totalVisible": 8,
"totalWithHidden": 15,
"strongest": [
"earth"
],
"missing": [
"metal",
"… 외 1건"
],
"dayMasterElement": "earth",
"basis": [
"드러난 글자 8개(천간 4·지지 4)의 오행을 세었고, 지지는 정기 오행으로 셌다.",
"… 외 1건"
]
},
"sinStrength": {
"score": 60,
"label": "신강",
"isStrong": true,
"deukryeong": false,
"deukji": true,
"deukjiPartial": false,
"deukse": true,
"deukseCount": 4,
"saryeongHelps": false,
"extremeCandidate": null,
"helpingCount": "…",
"contributions": [
"…",
"… 외 6건"
],
"availableWeight": 100,
"cause": "비겁이 많아 강함",
"meaning": "일간이 강한 원국은 자기 힘으로 서는 바탕이 있으므로, 그 힘을 쓰게 해 주는 관성·식상·재성이 어디에 있는지를 살피는 구조로 본다.",
"reasoning": "신강(60점): 일간 무(戊)를 돕는 글자는 연간 무(戊, 비견) 10점·시간 병(丙, 편인) 10점·연지 진(辰, 정기 무 비견) 8점·일지 진(辰, 정기 무 비견) 20점·시지 진(辰, 정기 무 비견) 12점이다. 월간 을(乙, 정관)·월지 묘(卯, 정관)는 돕지 않는다. 원인은 비겁이 많아 강함이다.",
"basis": [
"일간 무(戊, 토)를 돕는 비겁·인성이 자리별로 얼마나 뿌리를 두는지 세어 60점(신강)으로 판정했다.",
"… 외 2건"
]
},
"sinsal": {
"auspicious": [
"…"
],
"inauspicious": [
"…",
"… 외 1건"
],
"twelveSinsal": "…",
"gongmang": "…",
"summary": "…",
"basis": [
"신살은 길신 15종·흉/중립 17종의 규칙표(일간·년지·월지·일주·글자 기준)로 판정했고, 각 항목에 근거가 원전(삼명통회 권3)인지 현대 통용 규칙인지를 표시했다.",
"… 외 2건"
]
},
"decadeFortune": {
"direction": "forward",
"directionKo": "순행",
"startAge": 7,
"startAgeExact": 7.18,
"firstStartsOn": "1995-05-21",
"countedTo": "…",
"entries": [
"…",
"… 외 12건"
],
"selection": "…",
"current": "…",
"basis": [
"연간 양간 · 남성이라 순행(양남음녀)한다 (三命通會 論大運).",
"… 외 2건"
]
}
},
"diagnostics": [],
"ruleset": {
"version": "0.2.2",
"profile": "ko-standard",
"data": {
"tzdata": "2026c",
"tzdataBuild": "backzone",
"tzZones": 418,
"ephemeris": "DE440s",
"lunarVerifiedThrough": 2050,
"solarTermsVerifiedRange": "2000-2028"
}
}
}예시의 생년월일은 샘플 프로필이라 Free 키로 그대로 재현됩니다. 만세력은 핵심 모듈이 무료 범위라 임의의 생년월일도 계산합니다.
엔드포인트
질문 단위로 부릅니다
모듈을 골라 담는 API 가 아닙니다. “무엇을 묻는가”를 고르면 그 질문에 필요한 모듈 조합을 저희가 압니다.
만세력 Free 가능
이 사람의 사주 명식은 어떻게 생겼나?
POST /v2/saju/manse오늘의 운세 유료
오늘 하루, 이 사주에 무엇이 작용하나?
POST /v2/saju/today일일 운세 유료
그날 일진이 이 사주의 일간에 어떻게 작용하나?
POST /v2/saju/daily월 운세 유료
이번 달(또는 지정한 달)의 흐름은?
POST /v2/saju/monthly연간 운세 유료
그 해 1년의 흐름은?
POST /v2/saju/yearly대운 10년 유료
지금 대운은 어디쯤이고, 다음 10년은?
POST /v2/saju/decade평생 흐름 유료
이 사주의 골격과 평생의 큰 흐름은?
POST /v2/saju/life고민 상담 유료
이 고민, 사주 데이터는 어느 방향을 가리키나?
POST /v2/saju/consult관계 궁합 유료
이 두(세) 사람 사이에 무엇이 걸려 있나?
POST /v2/saju/compatibility연애 운 유료
내 연애, 지금 어느 흐름에 있나? (상대가 있으면 그 관계까지)
POST /v2/saju/love금전운 유료
재물은 언제, 어떤 구조로 들어오나?
POST /v2/saju/money건강운 유료
어느 기운·장부 계통을 유의해서 보나?
POST /v2/saju/health검증
맞는지 어떻게 아나요
사주 네 기둥 — 한국천문연구원 대조
절기 시각은 DE440s 천체력으로 계산하고 KASI 공표값과 대조합니다. 진태양시(경도차 + 균시차)와 정자시 경계를 반영하며, 서머타임 시행 연도(1948~51·1987~88)도 따로 다룹니다.
대운 — 독립 구현과 22,296건 대조
무작위 3,000건과 절입 경계 19,296건을 외부 독립 구현과 맞췄습니다. 순역·간지열 전건 일치, 설명되지 않는 불일치 0. 남은 차이는 두 구현의 절기 시각 차(최대 2.4분) 안입니다.
해석 규칙 — 전부 공개
신강약을 글자마다 몇 점씩 매겼는지, 용신을 어떤 순서로 골랐는지, 격국의 성패(成敗)를 무엇으로 갈랐는지가 응답과 판정 기준에 함께 있습니다. 조후표는 원문 120셀을 대조해 통용표와 달랐던 16셀을 원문 쪽으로 정정하고, 그 사실을 적었습니다.
같은 입력은 같은 출력
엔진은 시계도 네트워크도 보지 않습니다.
규칙 버전을 응답의 ruleset 에 실어, 규칙이 바뀌면 그 사실이 응답에 드러납니다.
200건의 고정 입력을 Node 와 실제 Cloudflare 런타임에서 돌려 해시가 같은지 배포마다 확인합니다.
계산 과정이 응답에 들어 있습니다
결과만 주지 않습니다. 월주를 가른 절입 시각(분 단위)과 그 절기,
월지의 사령과 교체 일정, 진태양시 보정 내역(경도차·균시차·서머타임)이 함께 옵니다.
자시 경계·절입 경계에 가까우면 diagnostics 가 그 사실을 알려 줍니다 —
몇 분 차이로 답이 갈리는 자리를 숨기지 않습니다.
해외 출생도 계산합니다
출생 도시 71곳 중 65곳이 해외입니다 — 도쿄·상하이·싱가포르·런던·뉴욕·시드니·상파울루까지. 진태양시 보정이 경도 기반이라 그 지역의 실제 태양 시각으로 시주를 세우고, 서머타임 시행 여부까지 그 나라 기준으로 봅니다. 교포·유학생·해외 거주자를 상대하는 서비스가 따로 손볼 것이 없습니다.
사주를 줄 세우지 않습니다
총점·등급·궁합 점수를 내지 않습니다. 사람을 점수로 매기는 것은 근거 없이 단정적이기 때문입니다. 대신 사실을 줍니다 — 두 원국 사이의 합충형파해, 오행 상보, 대운마다의 십성과 12운성. 길흉 라벨 없이 작용의 성격만 서술합니다.
요금
쓴 만큼
- 월 300건
- 분당 1회
- 배치 미지원
- 월 1,000건
- 분당 30회
- 배치 최대 50건
- 3·6·12개월 이용권은 월 단가가 내려갑니다
- 월 3,000건
- 분당 60회
- 배치 최대 100건
- 3·6·12개월 이용권은 월 단가가 내려갑니다