Natalchart

Der Endpunkt POST /v1/chart ist die Grundlage für die meisten Abfragen. Er liefert eine vollständige Geburtskarte: Positionen der Planeten, Hausknoten, Aspekte zwischen den Planeten, Sektoren der Karte. Kosten: 20 Credits (Tier 2).

Abfrageparameter

Parameter	Typ	Pflichtfeld	Beschreibung
date	string	Ja	Geburtsdatum YYYY-MM-DD
time	string	Ja	Geburtszeit HH:mm:ss
timezoneOffset	number	Ja	UTC-Verschiebung 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)	Haussystem: 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)

Beispielabfrage

Geburtskarte für Kiew, 14. Juli 1990, 14:30 Uhr:

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]); // Sonnenposition

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])  # Sonnenposition

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]); // Sonnenposition

Beispielantwort

{
  "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"
}

Hinweis

Die Antwort wurde zur besseren Übersichtlichkeit gekürzt. Die vollständige Antwort enthält alle 12 Planeten (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto + North Node, Chiron), 12 Hausknoten und alle Aspekte zwischen ihnen.

Haussysteme

Code	System	Hinweis
P	Placidus	Standard, am weitesten verbreitet
K	Koch	In Deutschland beliebt
W	Whole Sign	Klassische hellenistische Astrologie
E	Equal	Gleichmäßige Häuser ab ASC
R	Regiomontanus	Horarabfrage-Astrologie
C	Campanus	Räumliches System
T	Topocentric	Polich-Page
B	Alcabitius	Mittelalterliche Tradition

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

Kosmogramm (ohne Geburtsort)

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

Antwort-Header

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

Weiterführende Themen

• Synastrie – Kompatibilität zweier Karten
• Transite – Transit-Overlay und Ereigniskalender
• Human Design – Vollständige HD-Karte
• Vollständige API-Referenz – alle 723 Endpunkte