Geboortehoroscoop

De POST /v1/chart endpoint is de basis voor de meeste verzoeken. Het retourneert een volledige geboortehoroscoop: posities van planeten, huiskuspiden, aspecten tussen planeten, en kaartsectoren. Kosten: 20 credits (Tier 2).

Requestparameters

Parameter	Type	Verplicht	Omschrijving
date	string	Ja	Geboortedatum YYYY-MM-DD
time	string	Ja	Geboortetijd HH:mm:ss of HH:mm (wordt gelezen als HH:mm:00)
timezoneOffset	number	Ja	UTC-offset 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)	Huissysteem: P Placidus, K Koch, W Whole Sign, E Equal en anderen
name	string	Nee	Naam (wordt geretourneerd in het antwoord)
city	string	Nee	Stad (wordt geretourneerd in het antwoord)
zodiacType	string	Nee	tropical (standaard) of sidereal
cosmogram	boolean	Nee	true - zonder huizen (wanneer de locatie onbekend is)

Voorbeeldverzoek

Geboortehoroscoop 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 { 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

Voorbeeldantwoord

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

Opmerking

Het antwoord is ingekort voor de duidelijkheid. Het volledige antwoord bevat 13 lichamen, 12 huiskuspiden en alle aspecten tussen hen. In het name-veld van elk lichaam staat de naam uit Swiss Ephemeris, niet de astrologische naam: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, true Node (Noordknoop, ware), mean Apogee (Lilith, gemiddelde), Chiron. De Zuidknoop wordt niet als apart lichaam geretourneerd: dit is de true Node plus 180°.

Namen in uw taal

Voeg ?lang= toe om namen van planeten, tekens en aspecten in uw taal te krijgen, naast de onveranderlijke Engelse identificatoren. Elke van de 21 talen is geschikt, bijvoorbeeld Duits:

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

Zonder ?lang= is er geen localized blok in het antwoord.

Huissystemen

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

De volledige lijst met 15 systemen staat in de API reference.

Kosmogram (zonder geboorteplaats)

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

Antwoordheaders

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

Volgende

• Synastrie: compatibiliteit van twee kaarten
• Transits: transit overlay en evenementenkalender
• Human Design: volledige HD-kaart
• Volledige API reference: alle 771 endpoints