← 점봄만세력 API

만세력 API — 사주 계산 무료 API

생년월일을 주소에 넣으면 사주 여덟 글자를 JSON 으로 돌려줍니다. 가입도 API 키도 필요 없습니다. 진태양시·과거 표준시·서머타임을 모두 보정하고, 무엇을 보정했는지도 함께 알려줍니다.

키 없음가입 없음CORS 허용CC BY 4.0입력값 미저장

지금 바로 눌러보기

브라우저 주소창에 그대로 넣어도 됩니다.

직접 넣어보기

요청

GET https://jeombom.kr/api/manse

이름필수형설명예
year필수정수태어난 해 (1900~2100)1990
month필수정수태어난 달 (1~12)5
day필수정수태어난 날 (1~31)15
hour선택정수태어난 시 (0~23). 빼면 시주를 세우지 않고 여섯 글자로 계산합니다.14
minute선택정수태어난 분 (0~59). 기본 030
calendar선택문자solar(양력, 기본) 또는 lunar(음력)solar
leap선택불리언음력일 때 윤달이면 10
gender선택문자male(기본) 또는 female. 대운 방향에 씁니다male
tst선택불리언시각 보정. 기본 1(켬). 0이면 기록된 시계 시각을 그대로 씁니다1

태어난 시각을 모르시면 hour 를 빼세요. 임의로 자정이나 정오를 넣으면 틀린 시주가 결과에 섞입니다. 빼면 시주 없이 여섯 글자로 계산하고, 응답의 pillars.hour 가 null 로 옵니다.

응답

1958년 6월 1일 00시 30분 예시입니다. 서머타임과 과거 표준시가 동시에 걸리는 날입니다.

{
  "ok": true,
  "input": {
    "year": 1958,
    "month": 6,
    "day": 1,
    "hour": 0,
    "minute": 30,
    "hasTime": true,
    "calendar": "solar",
    "gender": "male",
    "trueSolarTime": true
  },
  "correction": {
    "applied": true,
    "standardMeridian": "동경 127.5도",
    "utcOffset": "UTC+08:30",
    "daylightSaving": true,
    "note": "이 날짜는 과거 표준시 또는 서머타임 구간입니다. 보정하지 않으면 시주가 한 칸 어긋날 수 있습니다.",
    "reference": "https://jeombom.kr/pyojunsi"
  },
  "pillars": {
    "year": [
      "무",
      "술"
    ],
    "month": [
      "정",
      "사"
    ],
    "day": [
      "무",
      "신"
    ],
    "hour": [
      "임",
      "자"
    ]
  },
  "dayMaster": {
    "stem": "무",
    "element": "토",
    "name": "무토(戊土)",
    "image": "넓고 단단한 큰 산"
  },
  "ilju": {
    "name": "무신",
    "url": "https://jeombom.kr/ilju/musin"
  },
  "elements": {
    "목": 1,
    "화": 3,
    "토": 3,
    "금": 2,
    "수": 1
  },
  "strength": "신강",
  "yongsin": "목",
  "voids": [
    "인",
    "묘"
  ],
  "meta": {
    "engine": "점봄 만세력 (한국천문연구원 KASI 절기 데이터 기준)",
    "license": "CC BY 4.0",
    "attribution": "계산: 점봄 만세력 API (https://jeombom.kr)"
  }
}

주요 필드

pillars연·월·일·시주. 각각 [천간, 지지]. 시각을 안 주면 hour 가 null
correction무엇을 보정했는지. 적용된 표준 자오선, UTC 오프셋, 서머타임 여부
dayMaster일간 — 사주에서 나 자신을 뜻하는 글자
ilju일주 이름과 해설 페이지 주소
elements오행 분포 (목·화·토·금·수)
strength신강 / 신약 / 중화
yongsin용신 — 부족해서 채워야 할 오행
voids공망 — 기운이 비어 있는 지지

코드로 부르기

curl

curl "https://jeombom.kr/api/manse?year=1990&month=5&day=15&hour=14&minute=30"

JavaScript

const p = new URLSearchParams({ year: 1990, month: 5, day: 15, hour: 14, minute: 30 });
const r = await fetch(`https://jeombom.kr/api/manse?${p}`);
const saju = await r.json();
console.log(saju.pillars.day);        // ['경', '진']
console.log(saju.correction.utcOffset); // 'UTC+09:00'

Python

import requests

r = requests.get("https://jeombom.kr/api/manse",
                 params={"year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30})
saju = r.json()
print(saju["pillars"]["day"])   # ['경', '진']
print(saju["yongsin"])          # '목'

다른 만세력과 결과가 다를 수 있습니다

같은 생년월일시인데 만세력마다 시주가 다르게 나오는 일이 흔합니다. 이 API 는 아래 세 가지를 모두 반영하고, 무엇을 반영했는지 응답에 적어 보냅니다.

보정크기대상
진태양시약 30분 + 균시차(날짜별 14~44분)전체. 한국 표준시는 동경 135도 기준이지만 한반도 중앙 경도는 약 127.5도
과거 표준시30분1954-03-21 ~ 1961-08-09 (동경 127.5도, UTC+8:30)
서머타임60분1948~1951, 1955~1960, 1987~1988 — 모두 12구간

두 번째와 세 번째가 겹치는 1955~1960년 여름에는 차이가 최대 1시간 30분까지 벌어집니다. 시주는 두 시간 단위라 이 정도면 글자가 확실히 바뀌고, 자정 무렵이면 일주까지 달라집니다.

근거 자료는 한국 표준시 자료에 날짜 단위로 공개해 두었습니다. 기계가 읽는 원본은 /data/korea-standard-time.json 입니다.

이 API 는 점봄 웹서비스와 같은 코드로 계산합니다. 앱에서 본 결과와 API 결과가 어긋나지 않습니다.

쓰는 조건

무료입니다. 상업적 이용도 됩니다. 라이선스는 CC BY 4.0 이고, 조건은 하나 — 출처를 밝혀 주세요.

출처 표기 예
사주 계산: 점봄 만세력 API

인증없음. API 키가 필요 없습니다
CORS모든 출처 허용. 브라우저에서 바로 부르셔도 됩니다
캐시같은 생일은 늘 같은 결과라 CDN 이 대신 답합니다. 응답이 빠릅니다
사용량상식적인 범위에서 자유롭게 쓰세요. 대량으로 쓰실 계획이면 contact@x-on.kr 로 미리 알려 주시면 좋습니다
개인정보입력값을 저장하지 않습니다. 계산하고 바로 버립니다
범위1900~2100년. 절기 데이터가 이 범위에서 검증돼 있습니다

오류를 발견하시거나 필요한 필드가 있으면 contact@x-on.kr 로 알려 주세요. 실제로 고치고 회신드립니다.

오류 응답

실패하면 ok: false 와 함께 이유를 돌려줍니다.

코드뜻
400필수 값이 없거나 범위를 벗어남
405GET 이 아님
422실제로 없는 날짜 (예: 2월 30일)

자주 묻는 질문

API 키가 필요한가요?

필요 없습니다. 가입도 인증도 없이 주소만 호출하시면 됩니다. CORS 도 열려 있어 브라우저에서 바로 부르실 수 있습니다.

상업적으로 써도 되나요?

됩니다. CC BY 4.0 이라 출처만 밝히시면 상업적 이용을 포함해 자유롭게 쓰실 수 있습니다. "사주 계산: 점봄 만세력 API (https://jeombom.kr)" 정도면 충분합니다.

태어난 시각을 모르면 어떻게 하나요?

hour 파라미터를 빼세요. 시주를 세우지 않고 연주·월주·일주 여섯 글자로 계산합니다. 임의로 0시나 12시를 넣으면 틀린 시주가 결과에 섞이므로 권하지 않습니다.

왜 다른 만세력과 결과가 다른가요?

진태양시(약 30분 · 균시차 포함 날짜별 14~44분), 과거 표준시(1954~1961년 UTC+8:30), 서머타임(12구간)을 모두 보정하기 때문입니다. 이 셋 중 하나라도 빠뜨리면 시주가 한 칸 어긋납니다. 응답의 correction 필드에서 무엇이 적용됐는지 확인하실 수 있습니다.

입력한 생년월일이 저장되나요?

저장하지 않습니다. 계산에만 쓰고 바로 버리며 로그도 남기지 않습니다.

사용량 제한이 있나요?

별도 제한을 두지 않았습니다. 같은 생일은 결과가 늘 같아 CDN 이 대신 답하기 때문에 부담이 크지 않습니다. 대량 사용을 계획하신다면 contact@x-on.kr 로 미리 알려 주시면 좋습니다.

함께 보기

점봄은 무엇을 기준으로 사주를 계산하나요?

점봄은 한국천문연구원 절기 데이터로 만세력을 세우고 태어난 시각을 진태양시로 보정해 사주 여덟 글자를 계산하는 한국 명리 서비스입니다.

항목점봄 기준
절기·만세력한국천문연구원(KASI) 절기 데이터
태어난 시각진태양시 보정 — 표준시(동경 135도)와 한반도 중앙(약 127.5도)의 차이 30분에 날짜마다 달라지는 균시차를 더해 뺌
서머타임1948~1951·1955~1960·1987~1988년 12개 구간 반영
옛 표준시1954년 3월 21일~1961년 8월 9일 동경 127.5도 구간 반영
입력양력 생년월일 (음력 생일은 양력으로 바꿔 입력)

진태양시 보정은 왜 하나요?

시계의 시각과 실제 태양의 시각이 30분 안팎 어긋나기 때문입니다. 서머타임이나 옛 표준시 구간에 태어난 분은 보정하지 않으면 시주가 한 칸 어긋날 수 있습니다. 자세한 기록은 한국 표준시 자료와 시주 검증에 있습니다. 무료 사주풀이를 고를 때 무엇을 확인하면 되는지는 무료 사주풀이 고르는 법에 정리했습니다.

점봄 풀이의 근거 자료는 어디서 볼 수 있나요?

운세 결과를 그대로 믿어도 되나요?

점봄의 운세 결과는 재미와 참고를 위한 오락용 콘텐츠입니다. 건강·법률·투자처럼 중요한 결정은 꼭 해당 분야 전문가와 상의해 주세요.