사주 계산, 직접 만들려고 하셨죠?
사주 API를 검색하고 있다면, 아마 이런 상황일 겁니다.
60갑자 계산을 직접 구현하려다 월주 산출에서 막힘 — 절기 기준이라 단순 달력으로 안 됨
야자시(23:30~01:29) 처리, 서머타임 보정(1949~1988), 음양력 변환 등 예외 케이스가 끝없이 발생
십성, 귀인, 신살, 대운 계산까지 구현하려면 명리학 도메인 지식 + 수개월 개발 필요
다 만들어도 계산 정확도 검증이 어려움 — 전문 역학인 피드백 없이는 오류를 잡기 힘듦
운세위키 사주 API는 이 모든 문제를 해결합니다.
전문 역학인이 검증한 알고리즘으로 절기·야자시·서머타임·음양력 변환을 정확히 처리하고, 간지부터 대운·세운·합충관계까지 한 번에 반환합니다.
실제로 이런 데이터가 나옵니다
2000년 1월 1일 10시생, 여성, 양력 기준 — 실제 API 응답 일부
사주 간지 (四柱)
한글 + 한자 + 천간/지지 분리
"ganji": {
"year": { "ganji": "기묘(己卯)", "ganHanja": "己", "jiHanja": "卯" },
"month": { "ganji": "병자(丙子)", "ganHanja": "丙", "jiHanja": "子" },
"day": { "ganji": "무오(戊午)", "ganHanja": "戊", "jiHanja": "午" },
"hour": { "ganji": "정사(丁巳)", "ganHanja": "丁", "jiHanja": "巳" }
}귀인 15종
각 귀인의 위치 + 상세 해석 문장까지 포함
"guiin": {
"cheongwan": [{
"position": "년지", "ji": "묘",
"name": "천관귀인",
"description": "관직과 직장운, 승진과 성공의 귀인..."
}],
"yuha": [{
"position": "시지", "ji": "사",
"name": "유하",
"description": "재물이 흘러들어오는 별, 학문적 성취..."
}],
"hyeoprok": [{ ... }]
// + 천을, 태극, 문곡, 문창, 복성, 천주, 천복,
// 학당, 재고, 천덕, 월덕, 암록, 금여 등
}십성 분석 + 신강신약 점수
8개 위치별 십성 + 5카테고리 분포 + 7단계 레벨 + 100점 점수 + 득력 근거
"sipseong": {
"sipseongs": [
{ "position": "년간", "sipseong": "겁재", "category": "비겁성" },
{ "position": "년지", "sipseong": "정관", "category": "관성" },
{ "position": "월간", "sipseong": "편인", "category": "인성" },
// ... 8개 위치 전부
],
"summary": { "bigyeop": 1, "siksang": 0, "jaeseong": 1, "gwanseong": 1, "inseong": 4 },
"analysis": "인성이 강해 학구적이고 지혜로운 성향입니다..."
},
"sinStrength": {
"strength": "신강", "level": 6, "score": 65,
"deukryeong": false, "deukji": true, "deukse": true,
"supportElements": ["년간: 토 → 비견", "월간: 화 → 인성", ...],
"weakenElements": ["년지: 묘 → 관성", "월지: 자 → 재성"]
}도화살 · 12신살 · 낙정관살
도화살은 유형별(자수·묘목·오화·유금) 해석까지 분리
"dohwa": [{
"position": "년지", "type": "묘목도화",
"meaning": "어려서부터 성숙한 감성을 가집니다..."
}],
"sibisinsals": [{
"name": "장성살", "position": "년지",
"description": "성공살 — 끝까지 포기하지 않고..."
}, {
"name": "역마살", "position": "시지",
"description": "변화와 적응의 살 — 뱀 역마..."
}]대운 10개 + 세운
각 대운마다 십성 해석, 원국과의 합충형파해원진, 12운성 해석 포함
"daeun": {
"daeun_start_age": 2,
"current_daeun": { "age_start": 22, "age_end": 31, "ganji": "기묘" },
"all_daeun": [
{
"sequence": 1, "age_start": 2, "ganji": "정축",
"sipseong": { "gan": "정인", "interpretation": "학업 성취, 조력자의 도움..." },
"hapChungRelations": [
{ "type": "육합", "source": "축", "target": "자", "meaning": "감정적 친밀감..." },
{ "type": "삼합", "source": "축", "target": "사", "meaning": "금국 생성..." }
],
"twelveFortune": { "fortune": "양", "keyword": "온유와 상속", "level": 7 }
},
// ... 총 10개 대운
]
},
"seun": {
"currentSeun": {
"year": 2026, "ganji": "병오",
"hapChungRelations": [ ... ],
"twelveFortune": { "fortune": "제왕", "level": 12 }
}
}연동 코드
REST API이므로 어떤 언어든 HTTP 요청만 보내면 됩니다. API 키 발급 시 엔드포인트를 안내드립니다.
JavaScript
const res = await fetch('{ENDPOINT}', {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'x-api-key': 'YOUR_KEY' },
body: JSON.stringify({
birthYear: "1995", birthMonth: "8", birthDay: "15",
birthHour: "14", birthMinute: "30",
calendarType: "양력", gender: "male"
})
});
const saju = await res.json();
// saju.ganji, saju.sipseong, saju.daeun, saju.guiin ...Python
import requests
res = requests.post('{ENDPOINT}', headers={
'Content-Type': 'application/json',
'x-api-key': 'YOUR_KEY'
}, json={
'birthYear': '1995', 'birthMonth': '8', 'birthDay': '15',
'birthHour': '14', 'birthMinute': '30',
'calendarType': '양력', 'gender': 'male'
})
saju = res.json()다른 사주 API와 뭐가 다른가요?
| 항목 | 일반 사주 API | 운세위키 API |
|---|---|---|
| 간지 | 한글만 | 한글 + 한자 |
| 귀인 | 2~3종 | 15종 + 해석 |
| 신살 | 기본만 | 도화살(유형별) + 12신살 + 낙정관살 |
| 십성 | 이름만 | 8위치 + 카테고리 + 분포 + 분석 문장 |
| 신강신약 | 없거나 신강/신약만 | 7단계 + 100점 점수 + 근거 |
| 대운 | 간지만 | 10개 × (십성 + 합충관계 + 12운성) |
| 야자시 · 서머타임 | 미지원 | 자동 보정 |
| 만세력 | 별도 없음 | 만세력 API 동시 제공 |
자주 묻는 질문
Q. 음력 생년월일도 되나요?
네. calendarType: "음력"으로 보내면 음력→양력 자동 변환 후 계산합니다.
Q. 어떤 언어로든 연동 가능한가요?
REST API(POST + JSON)이므로 JavaScript, Python, Java, Go, PHP, Ruby, Swift, Kotlin 등 어떤 언어든 가능합니다.
Q. GPT랑 같이 쓸 수 있나요?
가장 추천하는 방법입니다. 사주 API로 정확한 원천 데이터를 받고, 이를 GPT 프롬프트에 넣으면 전문가 수준의 해석이 가능합니다. 데이터 정확도는 알고리즘이, 풍부한 해석은 AI가 담당하는 구조입니다.