AstroWay/api v2.201.6 · ja
すべてのシステムが正常です
// astrology api · POST /v1/symbolic-directions

ソーラーアーク・ディレクション API

Solar arc はチャート全体を 1 つの数だけ前に進めるんだ。これは二次進行で Sun が移動した距離だよ。すべての惑星、ハウスカスプ、そしてアセンダントと MC も同じアークだけシフトするから、出生時のアスペクトが 2 度ずれていたのが約 2 年後に正確になるんだ。この endpoint は方向付けされたチャートとそれを作ったアークを返すよ。

Endpoint
POST /v1/symbolic-directions
Cost
50 credits
Latency
~50 ms
Tier
Tier 3
// 01 / What it computes

ソーラーアーク・ディレクション API

出生データと対象日付を受け取って、endpoint はまずチャートを 1 年につき 1 日進めて、進行した Sun が出生時の位置からどれだけ動いたか測定し、その距離をアークとして取るんだ。その後、そのアークをすべての出生経度に一括で加える。すべての惑星、すべてのハウスカスプ、アセンダントと MC も同様だよ。レスポンスは data.planets と data.houses に方向付けされた位置を、data.arc に度数でアークを、data.key にそれを生成したキーを入れて返す。単一のアークを均一に適用するので、出生チャートの幾何は保たれ、出生度数との関係だけが変わるんだ。これがこの手法がとても読みやすい理由で、1 つの数で特定の年齢のチャート全体の状態が分かるんだ。同じ endpoint で他に 2 つのキーが使える。key を naibod に設定すると年率 59'08.3" の平均太陽速度になるし、省略すると年 1 度のシンプルなものになる。converse を true にすると出生瞬間から逆方向に進めて、アークの符号が反転するんだ。

// 02 / Live request

POST/v1/symbolic-directions

curl -X POST https://api.astroway.info/v1/symbolic-directions \
  -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,
  "targetDate": "2026-05-15",
  "key": "solar_arc"
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "arc": 34.5083,
    "key": "solar_arc",
    "planets": [
      {
        "id": 0,
        "name": "Sun",
        "longitude": 88.8843,
        "isRetrograde": false
      }
    ],
    "houses": {
      "system": "P",
      "ascendant": 204.4763,
      "mc": 111.5826
    }
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Birth date.
time string (HH:MM:SS) yes Local clock time at birth.
timezoneOffset number (hours) yes UTC offset in effect at the birth moment. Decimal allowed for half-hour zones.
latitude number yes Birth-place latitude, decimal degrees (north positive).
longitude number yes Birth-place longitude, decimal degrees (east positive).
targetDate string (YYYY-MM-DD) yes The date the chart is directed to.
key string no Directional key: solar_arc (the arc of the progressed Sun), naibod (59'08.3" per year), or one_degree (the default, 1° per year).
converse boolean no Direct backwards from the birth moment instead of forwards. Reverses the sign of the arc.
// 04 / When to use it

When to use it

シンボリックなタイミングが欲しいとき、天文学的なものよりも、読者が追いやすい形が欲しいときに solar arc を使うんだ。すべてが同じ速度で動くから、方向付けされた接点はウィンドウではなく特定の年に着地する。だからライフタイムライン機能や年齢マイルストーンレポート、あるいは AI のナラティブで「この年は何か」を語るのにぴったりだ。secondary progressions と自然に組み合わせられるのは、アークが同じ進行した Sun から導かれるから。progressions は内部チャートを動かし、solar arc は全体チャートを前へずらすんだ。精度が重要なら 3 つのキーを比較しよう。solar arc は実際の Sun に従うので出生日で少し変わるし、Naibod は平均速度、年 1 度は丸めた慣例だ。5 月中旬生まれの場合、36 年でおおよそ 34.5°, 35.5°, 36.0° になるから、十年単位での合意は得やすく、年ごとの違いもはっきり出せるよ。

// 05 / Notes

Notes

アークは二次進行した Sun が 1 年につき 1 日進んだ距離で、標準的な定義だよ。Naibod キーは Sun の平均日運動、59'08.3"/年 を使う。solar arc では進行したチャートを前方に計算し、移動方向は一度だけ適用するから、converse を指定するとアークが符号反転して返るんだ。位置情報は Swiss Ephemeris エンジンから取得していて、熱帯黄道帯で、出生 endpoint と同じ天体とハウスシステムを使用しているよ。

Try the ソーラーアーク・ディレクション API

Grab a key and make your first call in under a minute.

99.9% SLA · 有料プラン · 30日間 ステータス →