astroAPI — GET /v1/houses

GET /v1/houses API-Key noetig Berechnung

Hausspitzen und Achsen (AC, MC, ARMC, Vertex, ...) fuer einen Moment und Ort.

Beschreibung

Berechnet die 12 Hausspitzen sowie acht Achsen-Werte nach dem gewaehlten Haeusersystem (Default: Koch). Alle Werte in Dezimalgrad, Bereich 0..360.

Parameter

Name	In	Typ	Pflicht	Beschreibung
`datetime`	query	string	ja	ISO 8601. Entweder mit UTC-Offset ("...+02:00") oder ohne — dann ist "tz" Pflicht.
`tz`	query	string	nein	IANA-Zeitzonenname (z.B. "Europe/Berlin"). Pflicht, wenn "datetime" keinen Offset enthaelt.
`lat`	query	number	ja	Breitengrad in Dezimalgrad (−90..90).
`lon`	query	number	ja	Laengengrad in Dezimalgrad (−180..180). Ostwaerts positiv.
`alt`	query	number	nein	Hoehe in Metern. Default 0.
`system`	query	string	nein	Haeusersystem. Default "koch". Siehe Seite "Haeusersysteme" in der Doku fuer alle Werte.

Beispiel-Aufruf

Variante: Direkter HTTP-Aufruf, keine Abhaengigkeit.

curl -sS \
  -H "X-API-Key: ak_test_<DEIN_KEY>" \
  "https://astroapi.services/v1/houses?datetime=2026-04-20T12%3A00%3A00Z&lat=0&lon=0"

<?php
$ch = curl_init("https://astroapi.services/v1/houses?datetime=2026-04-20T12%3A00%3A00Z&lat=0&lon=0");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: ak_test_<DEIN_KEY>"]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);

<?php
require 'astroapi-client.php';
$api = new AstroApiClient('ak_test_<DEIN_KEY>');
$response = $api->houses([
    'datetime' => '2026-04-20T12:00:00Z',
    'lat' => '0',
    'lon' => '0',
]);
print_r($response);

const response = await fetch('https://astroapi.services/v1/houses?datetime=2026-04-20T12%3A00%3A00Z&lat=0&lon=0', {
  method: 'GET',
  headers: { 'X-API-Key': 'ak_test_<DEIN_KEY>' },
});
const data = await response.json();
console.log(data);

import { AstroApiClient } from './astroapi-client.js';

const api = new AstroApiClient('ak_test_<DEIN_KEY>');
const response = await api.houses({
    "datetime": "2026-04-20T12:00:00Z",
    "lat": "0",
    "lon": "0"
});
console.log(response);

import requests

url = 'https://astroapi.services/v1/houses?datetime=2026-04-20T12%3A00%3A00Z&lat=0&lon=0'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
response = requests.get(url, headers=headers)
print(response.json())

from astroapi_client import AstroApiClient

api = AstroApiClient('ak_test_<DEIN_KEY>')
response = api.houses({
    'datetime': '2026-04-20T12:00:00Z',
    'lat': '0',
    'lon': '0',
})
print(response)