トランジットチャート API

transits エンドポイントは、人物のネイタルデータ（出生日、時間、UTC オフセット、緯度、経度、ハウスシステム）と別個の対象時刻を受け取るんだ。その対象日時をユリウス日へ変換し、Swiss Ephemeris エンジンに全トランジット天体の地心経度・緯度・速度を問い合わせ、得た位置をネイタル地点から導かれるハウスに割り当てる。レスポンスには、トランジット惑星とそのサイン・ハウス位置、ネイタルハウスのカスプ、そしてトランジット天体同士で計算されたフルアスペクトグリッドが含まれ、適用中か分離中かのフラグと正確なオーブが付く。さらに、赤緯と至点軸の作業用にパラレルとアンチシア（鏡点）アスペクトも返す。逆行は天体の速度でフラグ付けされるので、リクエスト時点でトランジットが順行、静止、逆行のどれかが分かる。

curl -X POST https://api.astroway.info/v1/transits \
  -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,
  "transitDate": "2026-06-15",
  "transitTime": "12:00:00",
  "transitTzOffset": 3
}'

{
  "ok": true,
  "data": {
    "input": {},
    "julianDay": 2461206.875,
    "planets": [
      {
        "name": "Sun",
        "longitude": 84.29,
        "sign": "Gemini",
        "house": 11
      }
    ],
    "houses": {
      "ascendant": 160.4,
      "mc": 70.1,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      {
        "planet1": "Sun",
        "planet2": "Moon",
        "type": "conjunction",
        "orb": 1.2,
        "applying": true
      }
    ],
    "parallelAspects": [
      "…"
    ],
    "antiscia": [
      "…"
    ]
  }
}

このエンドポイントは、特定の日に誰かのチャート上に広がる全空を取得したいときに使うんだ。例えば、デイリートランジットウィジェットや、天気予報みたいな「今何が上にある？」パネル、あるいは現在の占星術的状況を説明する前に AI エージェントが読む生データとしてね。トランジットチャートをネイタルハウスフレーム上に返すので、トランジットとネイタルの接触リストを絞り込んだものではなく、構造的なスナップショットそのものが欲しいときに最適だ。もし日付範囲にわたるタイミング付きのトランジット-ネイタルヒット（正確な日付、エンゲージ、ステーションポイント）を探したいなら、/transit-calendar エンドポイントを使ってくれ。二つを組み合わせて使うといい：このエンドポイントは瞬間のチャート、カレンダーは将来のイベントリストを提供する。

今日のトランジットを自分のチャートと比較してみて →

スコープは正確に把握してね：このエンドポイントはトランジットチャートをネイタルハウスフレームに載せて返すだけで、事前にフィルタされたトランジット-ネイタルアスペクトリストは返さないんだ。アスペクトグリッドはトランジット天体同士で計算され、トランジットとネイタルポイント間ではない。日付範囲にわたるトランジット-ネイタルのタイミングが必要なら /transit-calendar を使って。ハウスは選んだネイタルシステムに従い、トロピカルゾディアックと Swiss Ephemeris を通して使用する。