astroAPI — POST /v1/ephemeris

Beschreibung

Abtastung mit frei waehlbarer Schrittweite (Tage, Stunden oder Minuten). Liefert pro Sample die gewaehlten Felder (longitude, latitude, distance, speed, retrograde, sign, sign_degree). Maximum 10000 Samples pro Request — sonst "invalid_input". Ideal fuer Prognose-Grafiken, Retrograd-Kalender, externe Datenbanken.

Parameter

Name	In	Typ	Pflicht	Beschreibung
`start`	body	string	ja	Start des Zeitraums (ISO 8601 UTC).
`end`	body	string	ja	Ende des Zeitraums (ISO 8601 UTC, muss nach "start" liegen).
`step_days`	body	number	nein	Schrittweite in Tagen. Default 1.0.
`step_hours`	body	number	nein	Alternative zu step_days (wird intern umgerechnet).
`step_minutes`	body	number	nein	Alternative zu step_days.
`points`	body	array	nein	Liste der Punkte. Default: Sonne-Pluto + Mean Node + Chiron. Alle Werte aus dem Planeten-Katalog erlaubt.
`asteroids`	body	array	nein	Nummerierte Asteroiden-IDs (z.B. [433, 80]). Werden als "asteroid_<id>" benannt.
`fields`	body	array	nein	Welche Werte pro Sample. Erlaubt: longitude, latitude, distance, speed, latitude_speed, distance_speed, retrograde, sign, sign_degree. Default: ["longitude","retrograde"].

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 '{
    "start": "2026-04-15T00:00:00Z",
    "end": "2026-05-15T00:00:00Z",
    "step_days": 1,
    "points": [
        "sun",
        "mars",
        "jupiter"
    ],
    "fields": [
        "longitude",
        "sign",
        "sign_degree",
        "retrograde"
    ]
}' \
  "https://astroapi.services/v1/ephemeris"

<?php
$ch = curl_init("https://astroapi.services/v1/ephemeris");
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, '{"start":"2026-04-15T00:00:00Z","end":"2026-05-15T00:00:00Z","step_days":1,"points":["sun","mars","jupiter"],"fields":["longitude","sign","sign_degree","retrograde"]}');
$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->ephemeris([
    'start' => '2026-04-15T00:00:00Z',
    'end' => '2026-05-15T00:00:00Z',
    'step_days' => 1,
    'points' => [
        'sun',
        'mars',
        'jupiter',
    ],
    'fields' => [
        'longitude',
        'sign',
        'sign_degree',
        'retrograde',
    ],
]);
print_r($response);

const response = await fetch('https://astroapi.services/v1/ephemeris', {
  method: 'POST',
  headers: { 'X-API-Key': 'ak_test_<DEIN_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "start": "2026-04-15T00:00:00Z",
    "end": "2026-05-15T00:00:00Z",
    "step_days": 1,
    "points": [
        "sun",
        "mars",
        "jupiter"
    ],
    "fields": [
        "longitude",
        "sign",
        "sign_degree",
        "retrograde"
    ]
}),
});
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.ephemeris({
    "start": "2026-04-15T00:00:00Z",
    "end": "2026-05-15T00:00:00Z",
    "step_days": 1,
    "points": [
        "sun",
        "mars",
        "jupiter"
    ],
    "fields": [
        "longitude",
        "sign",
        "sign_degree",
        "retrograde"
    ]
});
console.log(response);

import requests

url = 'https://astroapi.services/v1/ephemeris'
headers = {'X-API-Key': 'ak_test_<DEIN_KEY>'}
payload = {
    "start": "2026-04-15T00:00:00Z",
    "end": "2026-05-15T00:00:00Z",
    "step_days": 1,
    "points": [
        "sun",
        "mars",
        "jupiter"
    ],
    "fields": [
        "longitude",
        "sign",
        "sign_degree",
        "retrograde"
    ]
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

from astroapi_client import AstroApiClient

api = AstroApiClient('ak_test_<DEIN_KEY>')
response = api.ephemeris({
    'start': '2026-04-15T00:00:00Z',
    'end': '2026-05-15T00:00:00Z',
    'step_days': 1,
    'points': [
        'sun',
        'mars',
        'jupiter',
    ],
    'fields': [
        'longitude',
        'sign',
        'sign_degree',
        'retrograde',
    ],
})
print(response)