出生図 API
1つの出生瞬間を、惑星、ハウスカスプ、アスペクト、角度データを含む完全で構造化された出生図に変換する - 1回のPOSTで。熱帯黄道、13ハウスシステム、Swiss Ephemeris の精度、JSON 出力。
出生図 API
natal-chart エンドポイントは出生日、時刻、UTC オフセットを正確なユリウス日へ変換し、Swiss Ephemeris エンジンに各天体(10 の古典惑星+月のノード、キロン、ブラックムーン・リリス)の地心経度、緯度、速度を問い合わせる。出生緯度・経度から上昇点と天頂を算出し、選択したハウスシステムでハウスを分割、各惑星をサインとハウスに割り当て、適用/分離フラグと正確なオーブで完全なアスペクトグリッドを計算する。逆行は速度でフラグ付けされ、チャートのセクト(昼生まれか夜生まれか)が返されるので、下流の解釈で吉星と凶星を正しく重み付けできる。
POST/v1/chart
curl -X POST https://api.astroway.info/v1/chart \
-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,
"houseSystem": "P"
}' {
"ok": true,
"data": {
"planets": [
{ "name": "Sun", "longitude": 54.23, "sign": "Taurus", "house": 10, "retrograde": false },
{ "name": "Moon", "longitude": 282.7, "sign": "Capricorn", "house": 6 }
],
"houses": { "ascendant": 160.4, "mc": 70.1, "cusps": [160.4, 190.3, ...] },
"aspects": [ { "body1": "Sun", "body2": "Moon", "type": "trine", "orb": 1.2 } ]
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| 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 (e.g. 3 for Kyiv summer time). 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). |
| houseSystem | string | no | One-letter Swiss Ephemeris code - P (Placidus, default), K (Koch), W (whole-sign), R (Regiomontanus), and 10 more. |
When to use it
ホロスコープの構造的骨格が必要なときはこのエンドポイントを使ってね:出生図ウィジェット、出生レポート、太陽・月・上昇点でコンテンツをパーソナライズするオンボーディングフロー、または解釈前に生の配置が必要な AI エージェントなど。シナストリー、トランジット、プログレッション、ほとんどのレポートタイプの前提呼び出しで、チャートを一度計算して JSON をキャッシュし、重いエンドポイントに再計算せずに渡すことができる。レスポンスは純粋なデータ(文章や画像なし)なので、どんなスタックにもすっきり組み込める:自分で描画したり、LLM に渡したり、SVG レンダーエンドポイントに渡したりできる。
Notes
デフォルトは主流の西洋慣習に従う:熱帯黄道、Placidus ハウス、太陽・月・上昇点の「ビッグスリー」。エンジンは Swiss Ephemeris(Astrodienst)で、ブラウザ内計算機と共有されているので、サーバーとクライアントはアーク秒で一致する。Placidus が未定義の極圏上ではハウスは Porphyry にフォールバックする。
Try the 出生図 API
Grab a key and make your first call in under a minute.