Natalchart

Der Endpoint POST /v1/chart ist die Grundlage der meisten Anfragen. Er liefert das vollständige Geburtshoroskop: Planetenpositionen, Häuserspitzen, Aspekte zwischen den Planeten, Sect des Horoskops. Kosten: 20 Credits (Tier 2).

Anfrageparameter

Parameter	Typ	Pflicht	Beschreibung
date	string	Ja	Geburtsdatum YYYY-MM-DD
time	string	Ja	Geburtszeit HH:mm:ss oder HH:mm (wird als HH:mm:00 gelesen)
timezoneOffset	number	Ja	Verschiebung von UTC in Stunden (z. B. 2 für Kiew im Sommer)
latitude	number	Nein (0)	Breitengrad in Dezimalgrad
longitude	number	Nein (0)	Längengrad in Dezimalgrad
houseSystem	string	Nein (P)	Häusersystem: P Placidus, K Koch, W Whole Sign, E Equal und weitere
name	string	Nein	Name (wird in der Antwort zurückgegeben)
city	string	Nein	Stadt (wird in der Antwort zurückgegeben)
zodiacType	string	Nein	tropical (Standard) oder sidereal
cosmogram	boolean	Nein	true – ohne Häuser (wenn der Ort unbekannt ist)

Anfragebeispiel

Geburtshoroskop für Kiew, 14. Juli 1990, 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 { data: 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()['data']
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)['data'];
print_r($chart['planets'][0]); // Sun position

Antwortbeispiel

{
  "input": {
    "name": "",
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "houseSystem": "P",
    "city": "",
    "cosmogram": false
  },
  "julianDay": 2448086.979167,
  "siderealTime": 6.971672,
  "planets": [
    {
      "id": 0,
      "name": "Sun",
      "longitude": 111.77244,
      "latitude": 0.000162,
      "distance": 1.016462,
      "speedLong": 0.953753,
      "isRetrograde": false,
      "declination": 21.681363
    },
    {
      "id": 1,
      "name": "Moon",
      "longitude": 9.061363,
      "latitude": 4.639701,
      "distance": 0.002511,
      "speedLong": 13.770219,
      "isRetrograde": false,
      "declination": 7.854711
    }
  ],
  "houses": {
    "system": "P",
    "cusps": [
      212.0953,
      239.7536,
      274.2018,
      312.6334,
      346.2069,
      12.1755,
      32.0953,
      59.7536,
      94.2018,
      132.6334,
      166.2069,
      192.1755
    ],
    "ascendant": 212.0953,
    "mc": 132.6334
  },
  "aspects": [
    {
      "planet1": "Sun",
      "planet2": "Jupiter",
      "type": {
        "name": "Conjunction",
        "angle": 0,
        "isMajor": true
      },
      "orb": 0.548,
      "isApplying": true
    }
  ],
  "chartSect": "diurnal"
}

Hinweis

Die Antwort ist zur Übersichtlichkeit gekürzt. Die vollständige Antwort enthält 13 Körper, 12 Häuserspitzen und alle Aspekte zwischen ihnen. Im Feld name jedes Körpers steht die Bezeichnung aus Swiss Ephemeris, nicht die astrologische: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, true Node (Nördlicher Mondknoten, wahr), mean Apogee (Lilith, mittel), Chiron. Der Südliche Mondknoten wird nicht als eigener Körper zurückgegeben: er ist true Node plus 180°.

Namen in deiner Sprache

Füge ?lang= hinzu, um die Namen von Planeten, Zeichen und Aspekten in dieser Sprache neben den unveränderten englischen Bezeichnern zu erhalten. Jede der 21 Sprachen ist möglich, zum Beispiel Deutsch:

curl -X POST "https://api.astroway.info/v1/chart?lang=de" \
  -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" }'

{
  "localized": {
    "planets": { "Sun": "Sonne", "Moon": "Mond", "Mercury": "Merkur" },
    "signs": { "cancer": "Krebs", "leo": "Löwe", "aries": "Widder" },
    "aspects": { "Conjunction": "Konjunktion", "Opposition": "Opposition" }
  }
}

Ohne ?lang= gibt es keinen localized-Block in der Antwort.

Häusersysteme

Code	System	Hinweis
P	Placidus	Standard, am beliebtesten
K	Koch	Beliebt in Deutschland
W	Whole Sign	Klassisch hellenistisch
E	Equal	Gleiche Häuser ab ASC
R	Regiomontanus	Horary-Astrologie
C	Campanus	Räumliches System
T	Topocentric	Polich-Page
B	Alcabitius	Mittelalterliche Tradition

Die vollständige Liste mit 15 Systemen findest du in der API-Referenz.

Kosmogramm (ohne Geburtsort)

Wenn die Geburtszeit bekannt ist, der Ort aber nicht, übergib "cosmogram": true. Häuser und ASC/MC werden nicht berechnet, die Credits bleiben gleich (20).

Antwort-Header

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

Weiter geht’s

• Synastrie: Kompatibilität zweier Horoskope
• Transite: Transit-Overlay und Ereigniskalender
• Human Design: vollständige HD-Karte
• Vollständige API-Referenz: alle 771 Endpoints