Lunar Return API

月のリターンエンドポイントは、提供された出生データから出生時の月の正確な経度を読み取り、次に指定された開始日から前方に検索して、移動中の月が同じ経度に戻る最初の瞬間を見つけます。月が約27.3日で恒星サイクルを完了するため、そのリターンは約月ごとに発生します。エンドポイントは一致した瞬間をユリウス日に解決し、スイス・エフェメリスエンジンから地心の位置と速度を取得し、完全なチャートを作成します - リターン惑星とサイン、ハウス配置、ハウスのキュスプ、そして適用と分離のフラグと正確なオーブを含む完全なアスペクトグリッド。デフォルトではチャートは出生地で作成されますが、異なる場所の緯度と経度を提供してリターンを再配置することもできます。これは角度に敏感なハウスを再形成しながら、同じリターン瞬間を保持します。結果は、その先の月の間の感情的なリズムのテーママップとして読み取られます。

curl -X POST https://api.astroway.info/v1/lunar-return \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "afterDate": "2026-06-15"
}'

{
  "ok": true,
  "data": {
    "input": {},
    "planets": [
      {
        "name": "Moon",
        "longitude": 282.7,
        "sign": "Capricorn",
        "house": 6
      }
    ],
    "houses": {
      "ascendant": 201.5,
      "mc": 110.3,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      "…"
    ]
  }
}

月のリターンは、短サイクルの約月ごとの予測に使用します - 「先の月のテーマ」機能、感情のリズム追跡、または年間の太陽リターンより細かい補完として。太陽リターンが1年全体を枠組みづけるのに対し、月のリターンは次の4週間を枠組み、繰り返しの月次報告や習慣や感情のサイクルに適しています。開始日を、次のリターンを希望するポイントとして渡します - しばしば今日、または前回のリターンの日付 - そしてエンドポイントは次のものに進みます。オプションの場所のオーバーライドにより、その月に実際にいる場所（出生地ではなく）でリターンを作成でき、これは角度に敏感なハウスにとって重要です。連続した呼び出しを連鎖させて、月次チャートのローリングシーケンスを構築します。

エンドポイントは指定された日付以降の次の単一リターンを返しますが、シリーズではありません - シーケンスを構築するには、繰り返し呼び出し、開始日を進めてください。~27.3日の数値は恒星月であり、そのためリターンは暦に対してずれます。場所が提供されていない場合、チャートは出生地で作成されます。オーバーライドは角度とハウスのみを再配置します。熱帯黄道とスイス・エフェメリス全体で使用されます。