四柱推命API › 西洋占星術API

西洋占星術API

生年月日・出生時刻・座標を送ると、太陽から冥王星までの10天体、月のノード、4つのアングル、ハウス、アスペクト、品位を、HRUMがあらかじめ書いた解釈の段落とともに1つのJSONレスポンスで受け取れます。商品名は「西洋占星術トータル」で、LLMは使いません。

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

返すもの

自分で選ぶ値

ハウスシステムのデフォルトはプラシーダスで、 houseSystems で変更できます。トランジットとプログレッションのオーブ（timing.orbDegrees）は古典の文献で見解が分かれるためデフォルトがなく、 timing を送るときは必須です。空のままだと400を返します。

含まれないもの

マイナー・ディグニティとレセプション、プログレスのアングル（プログレスのASC・MC）、シナストリーのハウス・オーバーレイは返しません。一覧は リファレンスにあります。

/natal-chart をお使いの場合

ネイタルチャート商品（/natal-chart）は提供を終了しました。新しく連携する場合は、同じ出生情報を受け取る /astrology を使ってください。

リクエスト例

{
  "birthDate": "1990-05-15",
  "birthTime": "14:30",
  "birthTimePrecision": "exact",
  "birthLatitude": 37.5665,
  "birthLongitude": 126.978,
  "houseSystems": ["placidus", "whole_sign"]
}

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

レスポンス例（抜粋）

{
  "success": true,
  "data": {
    "natal": {
      "utc": "1990-05-15T05:30:00.000Z",
      "timePrecision": "exact",
      "timeKnown": true,
      "zodiac": "tropical",
      "lang": "ko",
      "bodies": [
        { "id": "Sun", "longitude": 54.1347, "sign": "Taurus", "signKey": "tau", "signName": "황소자리", "degreeInSign": 24.1347, "speed": 0.9643, "retrograde": false, "dignities": [], "house": { "placidus": 9, "whole_sign": 9 } },
        { "id": "Moon", "longitude": 293.8244, "sign": "Capricorn", "signKey": "cap", "signName": "염소자리", "degreeInSign": 23.8244, "speed": 12.2943, "retrograde": false, "dignities": ["det"], "house": { "placidus": 4, "whole_sign": 5 } },
        …

上のリクエストに対するレスポンスの冒頭です。ノード・アングル・ハウス・アスペクトを含むレスポンスとフィールドの説明は リファレンスにあります。

料金

西洋占星術トータルは1回 ₩50 です（VAT別、VAT込み ₩55）。 timing や partner を加えても、ハウスシステムやマイナー・アスペクトにかかわらず、1回分の料金のままです。成功した呼び出しだけがプリペイドのクレジットから差し引かれ、4xx・5xx のエラーレスポンスは課金されません。

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

料金一覧

リファレンス全体

パラメータ表の全体、レスポンスフィールドの説明、エラーコードはリファレンスにあります: 西洋占星術トータルAPI リファレンス。ほかの四柱推命（サジュ）商品は 四柱推命APIすべてにあります。

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