四柱推命API › 今日の運勢API

今日の運勢API

日付と生年月日時を送ると、その日の日柱と日干の関係、良い時間帯と避けたい時間帯、ラッキーカラー・食べ物・キーワードをJSONで返します。四柱推命（サジュ）では、毎日にそれぞれ天干と地支からなる日柱があり、日干は生まれた日の天干、つまり自分を表す文字です。商品名は「今日の運勢」で、INTAアプリのホーム画面にある「今日」カードと同じ計算を使います。同じ出生データと同じ日付なら、いつも同じ結果になります。

はじめにガイドプレイグラウンド料金

返すもの

その日の要約 — その日付の日柱、今日の通変星（その日が自分に対して担う役割）、今年の流れの点数、働いている神殺（象徴的な星）、三災（3年続く凶運の周期）にあたるかどうか (summary)
今日の運勢 — 日柱と日干の関係、ラッキーカラー・食べ物・キーワード、良い時間帯と避けたい時間帯、おすすめの行動、ひとことメッセージ (omen)
活動の相性 — 7種類の活動がその日にどれだけ合うか (taskAffinity)
服装とMBTIの行動パターン — 気温か mbtiBehavior: true を送った場合のみ (fashion·mbtiBehavior)

日付と天気のオプション

date を省略すると、韓国時間の今日になります。 temperatureC を送ると服装の提案が加わり、さらに weather と humidity を加えると時間帯ごとのひとこと天気コメントも加わります。出生時刻がわからない場合は正午で計算し、 birthHour を付けます。

リクエスト例

{
  "year": 1990, "month": 5, "day": 15, "hour": 12, "minute": 0,
  "timezone": "Asia/Seoul", "gender": "male",
  "date": "2026-10-10",
  "temperatureC": 16, "weather": "cloudy", "humidity": 60,
  "mbtiBehavior": true
}

認証は X-Partner-Api-Key ヘッダーで行い、ベースURLは https://api.hrum.ai/api/v1/partners/v1です。Python と JavaScript の例、エラー処理ははじめにガイドにあります。

レスポンス例（抜粋）

{
  "success": true,
  "data": {
    …
    "omen": {
      "relation": { "type": "GEUK", "label": "조율의 날" },
      "color": { "name": "주황", "hex": "#FFA45B", "ohaeng": "화" },
      "food": "고추장비빔밥",
      "keyword": "공개",
      "message": "표현하고 싶은 마음과 주변 반응이 엇갈릴 수 있는 날이에요. 즉흥적인 말보다 한 박자 늦춘 표현이 좋아요.",
      "luckyHour": "오전 11시 ~ 오후 1시",
      "avoidHour": "밤 11시 이후",
      "activity": "칭찬 먼저 하기"
      …

上のリクエスト（2026-10-10）に対するレスポンスのうち、今日の運勢の部分だけです。レスポンス全体とフィールドの説明はリファレンスにあります。

料金

今日の運勢は1回 ₩10 です（VAT別、VAT込み ₩11）。成功した呼び出しだけがプリペイドのクレジットから差し引かれ、4xx・5xx のエラーレスポンスは課金されません。

一度受け取った結果は保存して再利用してください。 同じリクエストをもう一度送ると、また課金されます。同じ生年月日時と同じオプションならいつも同じ結果なので、最初のレスポンスをデータベースに保存し（例：リクエストボディのハッシュをキーに）、以降は保存した値を無料で使ってください。今日の運勢のように日付で変わる結果は、日付をキーに含め、その日のあいだだけ再利用してください。

料金一覧

リファレンス全体

パラメータ表の全体、レスポンスフィールドの説明、エラーコードはリファレンスにあります: 今日の運勢API リファレンス。ほかの四柱推命商品は四柱推命APIすべてにあります。

お問い合わせ: contact@float.do · 運営: FLOAT Co., Ltd.