AstroAPI

Appearance

ネイタルチャート ​

惑星位置、ハウスカスプ、アスペクトを含む完全なネイタルチャートを計算します。

基本的な計算 ​

bash
curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'
javascript
const response = await fetch("https://api.astroapi.cloud/api/calc/natal", {
    method: "POST",
    headers: {
        "X-Api-Key": "your-api-key",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        dateTime: "1990-06-15T14:30",
        location: {
            latitude: 51.5074,
            longitude: -0.1278,
            timezone: "Europe/London"
        }
    })
});

const data = await response.json();
console.log(JSON.stringify(data, null, 2));
python
import requests

response = requests.post(
    "https://api.astroapi.cloud/api/calc/natal",
    headers={
        "X-Api-Key": "your-api-key",
        "Content-Type": "application/json"
    },
    json={
        "dateTime": "1990-06-15T14:30",
        "location": {
            "latitude": 51.5074,
            "longitude": -0.1278,
            "timezone": "Europe/London"
        }
    }
)

print(response.json())

パラメータ ​

パラメータ型必須説明
dateTimestringはいYYYY-MM-DDTHH:mm形式の日時
location.latitudenumberはい緯度（-90〜90）
location.longitudenumberはい経度（-180〜180）
location.timezonestringはいIANAタイムゾーン識別子
houseSystemstringいいえハウスシステム（デフォルト："placidus"）
moonCenterstringいいえ月の基準中心：topocentric（デフォルト、出生地点に対して視差補正済み）または geocentric（地球の中心）。月にのみ影響します。計算精度を参照
pointsarrayいいえ計算する天体ポイント（下記の利用可能なポイントを参照）
orbsobjectいいえアスペクトタイプごとのカスタムオーブ値（例：{ "conjunction": 8, "opposition": 6 }）
languagestringいいえテキストコンテンツの言語コード（デフォルト："en"）
includeTextbooleanいいえ解釈テキストを含める（デフォルト：false）
includeReadableEntitiesbooleanいいえ人間が読めるエンティティタイトルを含める（デフォルト：false）

ハウスシステム ​

  • placidus - プラシダス（デフォルト）
  • koch - コッホ
  • equal - イコールハウス
  • whole - ホールサイン
  • campanus - カンパナス
  • regiomontanus - レジオモンタヌス
  • porphyry - ポルフィリー

レスポンス ​

json
{
  "data": {
    "dateTime": "1990-06-15T12:30:00.000Z",
    "points": {
      "sun": {
        "pointId": "sun",
        "longitude": 84.5,
        "sign": "gemini",
        "signTitle": "Gemini",
        "degreesInSign": 24.5,
        "degreesInSignDms": [24, 30, 0],
        "houseNumber": 10,
        "houseId": "house-10",
        "retrograde": false,
        "pointTitle": "Sun",
        "houseTitle": "10th House"
      },
      "moon": {
        "pointId": "moon",
        "longitude": 245.2,
        "sign": "sagittarius",
        "signTitle": "Sagittarius",
        "degreesInSign": 5.2,
        "degreesInSignDms": [5, 12, 0],
        "houseNumber": 4,
        "houseId": "house-4",
        "retrograde": false,
        "pointTitle": "Moon",
        "houseTitle": "4th House"
      }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": {
        "pointId": "descendant",
        "longitude": 0.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "aries"
      },
      "midheaven": {
        "pointId": "midheaven",
        "longitude": 270.2,
        "degreesInSign": 0.2,
        "degreesInSignDms": [0, 12, 0],
        "sign": "capricorn"
      },
      "imumCoeli": {
        "pointId": "imumCoeli",
        "longitude": 90.2,
        "degreesInSign": 0.2,
        "degreesInSignDms": [0, 12, 0],
        "sign": "cancer"
      }
    },
    "houses": {
      "cusps": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 210.3, "longitudeDms": { "degrees": 210, "minutes": 18, "seconds": 0 }, "sign": "scorpio" }
      ],
      "ascmc": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 270.2, "longitudeDms": { "degrees": 270, "minutes": 12, "seconds": 0 }, "sign": "capricorn" }
      ]
    },
    "aspects": [
      {
        "pointA": "sun",
        "pointB": "moon",
        "aspect": "opposition",
        "angle": 160.7,
        "orb": 0.7,
        "applying": false,
        "pointATitle": "Sun",
        "pointBTitle": "Moon",
        "aspectTitle": "Opposition"
      }
    ],
    "chart": {
      "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..."
    }
  }
}

ハウスカスプ

各カスプオブジェクトには longitude（黄経度数）、longitudeDms（度/分/秒）、sign（黄道十二宮のサインID）が含まれます。最初のカスプ（cusps[0]）はアセンダントです。ascmc 配列にはアセンダント、MC、ARMC、バーテックスが含まれます。

利用可能なポイント ​

points パラメータを使用して、計算する天体ポイントを選択します。省略した場合、デフォルトセットが使用されます。

デフォルトポイント ​

sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, meanNode, trueNode, meanApogee, osculatingApog

すべての利用可能なポイント ​

ポイントID説明
sun太陽
moon月
mercury水星
venus金星
mars火星
jupiter木星
saturn土星
uranus天王星
neptune海王星
pluto冥王星
meanNode平均ノースノード
trueNode真のノースノード
meanApogee平均ブラックムーンリリス
osculatingApog真のブラックムーンリリス
chironカイロン
pholusフォルス
ceresセレス
pallasパラス
junoジュノー
vestaベスタ
interpolatedLunarApogee補間月遠地点（ナチュラルアポジー）
interpolatedLunarPerigee補間月近地点（プリアポス）
earth地球

例：太陽と火星のみを計算 ​

bash
curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "points": ["sun", "mars"]
  }'

レスポンスの points オブジェクトには sun と mars が含まれ、angles オブジェクトには4つのアングルすべてが含まれます：

json
{
  "data": {
    "points": {
      "sun": { "pointId": "sun", "longitude": 84.5, "sign": "gemini", ... },
      "mars": { "pointId": "mars", "longitude": 12.3, "sign": "aries", ... }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries", ... },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn", ... },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer", ... }
    },
    "houses": { ... },
    "aspects": [ ... ]
  }
}

アングル

4つのアングル（ascendant、descendant、midheaven、imumCoeli）は、points パラメータに関係なく、常に angles オブジェクトに含まれます。アングルはエフェメリスではなくハウス計算から導出されるため、よりシンプルな構造です（速度やレトログレードデータなし）。houses レスポンスの ascmc 配列にも常に生のアングル経度が含まれています。

月と太陽 ​

月の満ち欠け、照度、出没時刻、太陽位置データを計算します。

POST /api/calc/moon-sun ​

bash
curl -X POST "https://api.astroapi.cloud/api/calc/moon-sun" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    }
  }'

パラメータ ​

パラメータ型必須説明
dateTimestringはいYYYY-MM-DDTHH:mm形式の日時
location.latitudenumberはい緯度（-90〜90）
location.longitudenumberはい経度（-180〜180）
location.timezonestringはいIANAタイムゾーン識別子

必要なモジュール

このエンドポイントには module:moon モジュールが必要です。

レスポンス ​

json
{
  "data": {
    "moon": {
      "phaseName": "Waxing Gibbous",
      "phase": 0.62,
      "illumination": 0.78,
      "age": 9.2,
      "distance": 384400,
      "diameterDegrees": 0.52,
      "rise": "2024-06-15T14:23:00Z",
      "set": "2024-06-16T02:15:00Z"
    },
    "sun": {
      "rise": "2024-06-15T05:18:00Z",
      "set": "2024-06-15T22:03:00Z",
      "transit": "2024-06-15T13:40:00Z",
      "distance": 151820000,
      "diameterDegrees": 0.524,
      "twilight": {
        "civil": {
          "begin": "2024-06-15T04:38:00Z",
          "end": "2024-06-15T22:43:00Z"
        },
        "nautical": {
          "begin": "2024-06-15T03:32:00Z",
          "end": "2024-06-15T23:49:00Z"
        },
        "astronomical": {
          "begin": null,
          "end": null
        }
      }
    }
  }
}

計算精度 ​

AstroAPIはNASAのJPL DE442エフェメリスを直接読み取り、サブミリ秒角精度の惑星位置を提供します。データソースと補正の詳細については計算精度ページをご覧ください。

AstroAPI Documentation

Copyright © 2026 AstroAPI