사주 API › 운 흐름 API

운 흐름 API

한 사람의 생년월일시를 보내면 대운·세운·월운이 원국 위에 얹히는 흐름을 계산해, 그래프를 그릴 숫자와 운·원국 사이의 관계 목록을 JSON으로 돌려줘요. 상품 이름은 「운 흐름」이고, 한 번에 한 사람이며 LLM은 쓰지 않아요.

시작 가이드 플레이그라운드 요금표

돌려주는 것

누적선 — 대운은 원국 + 대운, 세운은 원국 + 그해 대운 + 세운 값을 ±100으로 자른 선 (line)
글자별 몫 — 운 글자 하나의 몫을 지원·통제·지장간·뿌리로 나눈 값 (share)
5신 이름 — 그 글자 오행의 용신·희신·기신·구신·한신 이름, 점수가 아니라 이름이에요 (shinRole)
형충회합 — 운 글자와 원국 글자의 관계 목록과 규칙 ID, 점수에는 넣지 않아요 (relations·triples)
합 풀림 — 대운·세운 글자가 건드린 원국 합과 새로 맺은 합, 화면 문구를 만들 코드 (hapPulim)
궁합 겹쳐 보기 입력 — 여러 사람을 겹쳐 볼 때 쓰는 용신 오행·겉 글자 오행 개수 (compatInputs)

세로축 값 읽는 법

세로축 값은 「운 글자를 얹은 일간 쪽 점수」예요. 원국 강약 총점에 운 글자마다 원국과 같은 글자당 점수표(지원·통제·지장간·뿌리)로 매긴 몫을 더하고 ±100으로 자른 값이고, 운세의 좋고 나쁨을 재지 않아요. 신강·중화·신약 이름은 원국 것 그대로예요. 월운은 누적선 없이 그 달 운 몫(delta)만 줘요.

범위와 월운

range로 세운 범위(양력 연도, 최대 101년)를 정해요. 출생연도부터 출생연도+100까지 한 번 받아 두고 화면에서 잘라 쓰는 방식을 권해요. monthsOfYear는 월운 12칸을 계산할 사주 연도(그해 입춘부터 다음 해 입춘 전까지)예요. 생략하면 지금(한국 시각)이 속한 사주 연도이고, null이면 월운 층이 없어요.

출생 시각·성별·출생지

birthTime이 없으면 시주 미상으로 여섯 글자 기준으로 계산하고 hourKnown: false를 붙여요. gender가 없으면 대운 층이 없어요. 출생지(birthLatitude·birthLongitude·country)는 만세력 API와 같은 필드이고 같은 방식으로 진태양시 보정을 해요. 만세력에 보낸 위치를 운 흐름에도 그대로 보내야 두 결과가 같은 원국을 써요.

요청 예시

{
  "birthDate": "1990-05-15",
  "birthTime": "14:30",
  "calendar": "solar",
  "gender": "male",
  "timezone": "Asia/Seoul",
  "range": { "fromYear": 1990, "toYear": 2090 },
  "monthsOfYear": 2026
}

인증은 X-Partner-Api-Key 헤더, 기본 주소는 https://api.hrum.ai/api/v1/partners/v1예요. Python·JavaScript 예제와 에러 처리는 시작 가이드에 있어요.

응답 예시 (발췌)

{
  "success": true,
  "data": {
    "engineVersion": "saju-flow-6",
    "kbVersion": "2026.10.11-7",
    "hourKnown": true,
    "natalAmbiguous": null,
    "natal": {
      "score": -37, "result": "중화", "level": "약약",
      "breakdown": { "season": -30, "support": 36, "control": -28, "hidden": -5, "root": 5 },
      "primaryYongshin": "토",
      "shin": { "yongshin": "토", "huishin": "화", "gishin": "목", "gushin": "수", "hanshin": "금" },
      "ruleIds": ["R-SAJU-STR-001", "R-SAJU-STR-018", "R-SAJU-STR-019", "R-SAJU-YONG-170"]
    },
    "daeun": [
      { "startYear": 1997, "endYear": 2006, "startAge": 7,
        "chars": [
          { "pos": "stem", "char": "임", "hanja": "壬", "ohaeng": "수", "sipsin": "식신", "shinRole": "gushin",
            "share": { "support": 0, "control": -8, "hidden": 0, "root": 0, "total": -8 } },
          { "pos": "branch", "char": "오", "hanja": "午", "ohaeng": "화", "sipsin": "정관", "shinRole": "huishin",
            "share": { "support": 0, "control": -10, "hidden": -5, "root": 0, "total": -15 } }
        ],
        "delta": -23, "line": { "value": -60, "clamped": false },
        …

응답 예시의 앞부분(원국과 첫 대운)이에요. 세운·월운·합 풀림까지 담긴 응답과 필드 설명은 레퍼런스에 있어요.

가격

운 흐름은 호출 1회에 ₩50(부가세 별도 · 부가세 포함 ₩55)이에요. 범위·월운을 늘려도 같은 1회 가격이에요. 선불 크레딧에서 성공한 호출만 차감하고, 4xx·5xx 오류 응답은 차감하지 않아요.

전체 요금표

전체 레퍼런스

파라미터 전체 표, 응답 필드 설명, 에러 코드는 레퍼런스에 있어요: 운 흐름 API 레퍼런스. 다른 사주 상품은 사주 API 전체 보기에서 볼 수 있어요.

문의: contact@float.do · 운영: 플로트 주식회사