astroAPI — POST /v1/transits

Beschreibung

Liefert entweder aktuell wirksame Transit-Aspekte zum Zeitpunkt "at" (Snapshot-Modus) oder alle Aspekt-Exaktereignisse zwischen "start" und "end" (Window-Modus, inklusive Retrograd-Mehrfachtreffer). Radix-Input entweder als Geburtsdaten ("natal") oder als vorberechnete Positionen ("natal_positions").

Parameter

Name	In	Typ	Pflicht	Beschreibung
`natal`	body	object	nein	Geburtsdaten: { datetime, timezone, location: {latitude, longitude} }. Alternativ "natal_positions" nutzen.
`natal_positions`	body	object	nein	Vorberechnete Radix-Positionen: { sun: 25.53, moon: 358.79, ascendant: 170.79, ... }.
`at`	body	string	nein	Zeitpunkt (ISO 8601) fuer Snapshot-Modus. Alternativ "start"+"end" nutzen.
`start`	body	string	nein	Fenster-Beginn fuer Window-Modus.
`end`	body	string	nein	Fenster-Ende fuer Window-Modus.
`step_days`	body	number	nein	Abtast-Schrittweite in Tagen (Window-Modus). Default: 1.0; 0.5 wenn Mars/Venus/Merkur/Sonne; 0.25 wenn Mond.
`transit_points`	body	array	nein	Welche beweglichen Punkte. Default: Sonne-Pluto + Chiron.
`aspect_types`	body	array	nein	["major"] \| ["minor"] \| ["major","minor"]. Default: ["major"].
`aspects`	body	array	nein	Explizite Aspekt-Liste, ueberschreibt aspect_types.
`orbs`	body	mixed	nein	Orben-Konfiguration wie bei /v1/aspects. Default: "transit" (1° pauschal) — passt zur Natur des Transits.

Beispiel-Aufruf

Variante: Direkter HTTP-Aufruf, keine Abhaengigkeit.

curl -sS \
  -H "X-API-Key: ak_test_<DEIN_KEY>" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "natal": {
        "datetime": "1980-05-17T14:32:00",
        "timezone": "Europe/Berlin",
        "location": {
            "latitude": 52.52,
            "longitude": 13.405
        }
    },
    "start": "2026-04-15T00:00:00Z",
    "end": "2026-05-15T00:00:00Z",
    "transit_points": [
        "jupiter",
        "saturn"
    ],
    "aspect_types": [
        "major"
    ]
}' \
  "https://astroapi.services/v1/transits"

<?php
$ch = curl_init("https://astroapi.services/v1/transits");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: ak_test_<DEIN_KEY>", "Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"natal":{"datetime":"1980-05-17T14:32:00","timezone":"Europe/Berlin","location":{"latitude":52.52,"longitude":13.405}},"start":"2026-04-15T00:00:00Z","end":"2026-05-15T00:00:00Z","transit_points":["jupiter","saturn"],"aspect_types":["major"]}');
$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->transits([
    'natal' => [
        'datetime' => '1980-05-17T14:32:00',
        'timezone' => 'Europe/Berlin',
        'location' => [
            'latitude' => 52.52,
            'longitude' => 13.405,
        ],
    ],
    'start' => '2026-04-15T00:00:00Z',
    'end' => '2026-05-15T00:00:00Z',
    'transit_points' => [
        'jupiter',
        'saturn',
    ],
    'aspect_types' => [
        'major',
    ],
]);
print_r($response);

const response = await fetch('https://astroapi.services/v1/transits', {
  method: 'POST',
  headers: { 'X-API-Key': 'ak_test_<DEIN_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "natal": {
        "datetime": "1980-05-17T14:32:00",
        "timezone": "Europe/Berlin",
        "location": {
            "latitude": 52.52,
            "longitude": 13.405
        }
    },
    "start": "2026-04-15T00:00:00Z",
    "end": "2026-05-15T00:00:00Z",
    "transit_points": [
        "jupiter",
        "saturn"
    ],
    "aspect_types": [
        "major"
    ]
}),
});
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.transits({
    "natal": {
        "datetime": "1980-05-17T14:32:00",
        "timezone": "Europe/Berlin",
        "location": {
            "latitude": 52.52,
            "longitude": 13.405
        }
    },
    "start": "2026-04-15T00:00:00Z",
    "end": "2026-05-15T00:00:00Z",
    "transit_points": [
        "jupiter",
        "saturn"
    ],
    "aspect_types": [
        "major"
    ]
});
console.log(response);

import requests

url = 'https://astroapi.services/v1/transits'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
payload = {
    "natal": {
        "datetime": "1980-05-17T14:32:00",
        "timezone": "Europe/Berlin",
        "location": {
            "latitude": 52.52,
            "longitude": 13.405
        }
    },
    "start": "2026-04-15T00:00:00Z",
    "end": "2026-05-15T00:00:00Z",
    "transit_points": [
        "jupiter",
        "saturn"
    ],
    "aspect_types": [
        "major"
    ]
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

from astroapi_client import AstroApiClient

api = AstroApiClient('ak_test_<DEIN_KEY>')
response = api.transits({
    'natal': {
        'datetime': '1980-05-17T14:32:00',
        'timezone': 'Europe/Berlin',
        'location': {
            'latitude': 52.52,
            'longitude': 13.405,
        },
    },
    'start': '2026-04-15T00:00:00Z',
    'end': '2026-05-15T00:00:00Z',
    'transit_points': [
        'jupiter',
        'saturn',
    ],
    'aspect_types': [
        'major',
    ],
})
print(response)