Geboortehoroscoop

Het eindpunt POST /v1/chart is de basis voor de meeste verzoeken. Geeft een volledige geboortekaart terug: posities van planeten, huizenhoeken, aspecten tussen planeten, sectie van de kaart. Kosten: 20 credits (Tier 2).

Verzoekparameters

Parameter	Type	Verplicht	Beschrijving
date	string	Ja	Geboortedatum YYYY-MM-DD
time	string	Ja	Geboortetijd HH:mm:ss
timezoneOffset	number	Ja	UTC-verschuiving in uren (bijv. 2 voor Kiev in de zomer)
latitude	number	Nee (0)	Breedtegraad in decimale graden
longitude	number	Nee (0)	Lengtegraad in decimale graden
houseSystem	string	Nee (P)	Huizensysteem: P Placidus, K Koch, W Whole Sign, E Equal en andere
name	string	Nee	Naam (wordt in het antwoord teruggegeven)
city	string	Nee	Stad (wordt in het antwoord teruggegeven)
zodiacType	string	Nee	tropical (standaard) of sidereal
cosmogram	boolean	Nee	true — zonder huizen (als de locatie onbekend is)

Voorbeeldverzoek

Geboortekaart voor Kiev, 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 chart = await res.json();
console.log(chart.planets[0]); // Zonpositie

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

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

Voorbeeldantwoord

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

Opmerking

Het antwoord is ingekort voor de duidelijkheid. Het volledige antwoord bevat alle 12 planeten (Zon, Maan, Mercurius, Venus, Mars, Jupiter, Saturnus, Uranus, Neptunus, Pluto + Noordknoop, Chiron), 12 huizenhoeken en alle aspecten daartussen.

Huizensystemen

Code	Systeem	Opmerking
P	Placidus	Standaard, meest populair
K	Koch	Populair in Duitsland
W	Whole Sign	Klassiek hellenistisch
E	Equal	Gelijke huizen vanaf ASC
R	Regiomontanus	Horaire astrologie
C	Campanus	Ruimtelijk systeem
T	Topocentric	Polich-Page
B	Alcabitius	Middeleeuwse traditie

De volledige lijst met 15 systemen vind je in de API reference.

Cosmogram (zonder geboorteplaats)

Als de geboortetijd bekend is maar de locatie niet, geef dan "cosmogram": true mee. Huizen en ASC/MC worden niet berekend, de kosten blijven hetzelfde (20).

Antwoordheaders

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

Verder

• Synastrie — compatibiliteit tussen twee kaarten
• Transits — overlay van transits en gebeurteniskalender
• Human Design — volledige HD-kaart
• Volledige API reference — alle 723 endpoints