ナタルチャート

エンドポイント POST /v1/chart は、ほとんどのリクエストの基盤です。完全な出生図を返します：惑星の位置、ハウスのカスプ、惑星間のアスペクト、チャートのセクト。コスト： 20 クレジット (Tier 2)。

リクエストパラメータ

パラメータ	型	必須	説明
date	string	はい	誕生日 YYYY-MM-DD
time	string	はい	誕生時刻 HH:mm:ss
timezoneOffset	number	はい	UTCからの時間オフセット（例：夏のキエフは 2）
latitude	number	いいえ (0)	緯度（10進度）
longitude	number	いいえ (0)	経度（10進度）
houseSystem	string	いいえ (P)	ハウスシステム：P Placidus、K Koch、W Whole Sign、E Equal その他 こちら
name	string	いいえ	名前（レスポンスで返却）
city	string	いいえ	都市（レスポンスで返却）
zodiacType	string	いいえ	tropical（デフォルト）または sidereal
cosmogram	boolean	いいえ	true — ハウスなし（場所が不明な場合）

リクエスト例

キエフ、1990年7月14日 14:30 の出生図：

cURL

curl -X POST https://api.astroway.info/v1/chart \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "houseSystem": "P"
  }'

Node.js

const res = await fetch('https://api.astroway.info/v1/chart', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
    houseSystem: 'P',
  }),
});
const chart = await res.json();
console.log(chart.planets[0]); // Sun position

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/chart',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
        'houseSystem': 'P',
    },
)
chart = r.json()
print(chart['planets'][0])  # Sun position

PHP

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->post('chart', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'date' => '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset' => 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
        'houseSystem': 'P',
    ],
]);

$chart = json_decode($r->getBody(), true);
print_r($chart['planets'][0]); // Sun position

レスポンス例

{
  "input": {
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "houseSystem": "P"
  },
  "julianDay": 2448087.979166,
  "siderealTime": 8.234,
  "planets": [
    {
      "name": "Sun",
      "longitude": 111.87,
      "latitude": 0.0,
      "speed": 0.955,
      "sign": "cancer",
      "signIndex": 3,
      "house": 10,
      "retrograde": false
    },
    {
      "name": "Moon",
      "longitude": 87.23,
      "latitude": -4.2,
      "speed": 13.3,
      "sign": "gemini",
      "signIndex": 2,
      "house": 8,
      "retrograde": false
    }
  ],
  "houses": {
    "system": "P",
    "cusps": [12.34, 43.21, 72.56, 100.12, 130.45, 162.78, 192.34, 223.21, 252.56, 280.12, 310.45, 342.78],
    "ascendant": 12.34,
    "mc": 280.12
  },
  "aspects": [
    {
      "planet1": "Sun",
      "planet2": "Moon",
      "type": "sextile",
      "orb": 1.36,
      "applying": true
    }
  ],
  "chartSect": "diurnal"
}

ノート

レスポンスは見やすくするために省略されています。完全なレスポンスには、すべての12の惑星（Sun、Moon、Mercury、Venus、Mars、Jupiter、Saturn、Uranus、Neptune、Pluto + North Node、Chiron）、12のハウスカスプ、およびそれらの間のすべてのアスペクトが含まれます。

ハウスシステム

コード	システム	備考
P	Placidus	デフォルト、最も一般的
K	Koch	ドイツで人気
W	Whole Sign	古典的なヘレニズム
E	Equal	ASC からの均等
R	Regiomontanus	ホラリー占星術
C	Campanus	空間システム
T	Topocentric	ポリッチ・ペイジ
B	Alcabitius	中世の伝統

15のシステムの完全なリストは API reference を参照。

コスモグラム（出生地不明）

出生時刻はわかっているが場所が不明な場合は、"cosmogram": true を渡します。ハウスと ASC/MC は計算されず、コストは同じ（20 クレジット）です。

レスポンスヘッダー

X-Credits-Used: 20
X-Credits-Remaining: 4980
X-Credits-Reset: 2026-05-01T00:00:00Z
X-Request-Id: 01HXY2A7ZM...

次へ

• シナストリー — 2つのチャートの相性
• トランジット — トランジットオーバーレイとイベントカレンダー
• Human Design — 完全な HD チャート
• 完全な API reference — すべての 723 エンドポイント