POSThttps://api.occultapi.com/api/astro/transit/

Transit-Übergänge

Anfrage-BodyJSON

Füg oben einen API-Schlüssel ein, um zu senden.

Code-Snippet

curl -X POST https://api.occultapi.com/api/astro/transit/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2024-11-20T06:52:42.466Z","keys":["set_sidereal_transit","planet_transit","solar_crossing","celestial_conjunction","transit_details"],"latitude":26.1046,"longitude":75.7873,"tz":5.5,"planet":"MARS","datetime_start":"2024-11-20T06:52:42.466Z","datetime_end":"2040-11-20T06:52:42.466Z","degr":0,"x2cross":0,"celestial1":"SATURN","celestial2":"SUN","celestial":"MARS","when":"after"}'

Dieser Endpoint sucht nach Zeitpunkten, statt ein Horoskop zu einem festen Zeitpunkt zu beschreiben. Er beantwortet Fragen wie: Wann erreicht die Sonne als Nächstes 0 Grad Widder? Wann überquert Mars zwischen zwei Daten als Nächstes einen bestimmten Grad? Wann haben Saturn und Sonne als Nächstes dieselbe ekliptikale Länge? Und wo genau steht ein Himmelskörper zu einem bestimmten Zeitpunkt? Zwei der Keys sind Modusschalter, keine Berechnungen. `set_default_transit` wählt die einfache tropische Ephemeride, `set_sidereal_transit` die siderische; beide liefern null. Keys in einer Anfrage werden in der Reihenfolge ausgewertet, in der du sie aufführst – setze den Schalter also an die erste Stelle, wenn die folgenden Suchen siderisch sein sollen. Die Felder `planet`, `celestial`, `celestial1` und `celestial2` verwenden Ephemeridennamen in Großbuchstaben (`SUN`, `MOON`, `MEAN_NODE`, `TRUE_NODE`, `CHIRON`, die uranischen Punkte und mehrere Planetenmonde) – ein anderes Vokabular als die Namen `Sun`/`Moon`, die die meisten anderen Endpoints hier verwenden. `tz` ist ein einfacher Stunden-Offset, der auf jeden zurückgegebenen Zeitstempel angewendet wird; `when` legt fest, ob nach ('after') oder vor ('before') dem Bezugszeitpunkt gesucht wird, und `datetime_start`/`datetime_end` begrenzen das Zeitfenster für `planet_transit`.

Felder der Anfrage

Feld	Typ	Pflicht	Hinweise
date_time	string (date-time)	Pflicht	Der Zeitpunkt, für den gerechnet wird, im Format ISO 8601. Gib IMMER einen Offset oder ein abschließendes Z an – ein Wert ohne Zone wird als Asia/Kolkata (UTC+05:30) gelesen, nicht als UTC, und kann mit Status 200 das Ergebnis des Vortags liefern. '2026-09-01T06:00:00Z' und '2026-09-01 06:00:00' sind verschiedene Zeitpunkte und ergeben verschiedene Antworten.
datetime_end	string (date-time)	Pflicht
datetime_start	string (date-time)	Pflicht
keys	array	Pflicht	Welche Berechnungen zurückgegeben werden, als Liste von Namen. Siehe die Key-Tabelle dieses Endpoints; ein unbekannter Name lässt die ganze Anfrage scheitern. Ein Aufruf kostet einen Credit, egal wie viele Keys du anforderst – fordere also alles, was du brauchst, auf einmal an, statt mehrere Aufrufe zu machen.
planet	string	Pflicht	`SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE` 36 zulässige Werte für die 10 Planeten, die beiden Mondknoten, 6 Asteroiden, 9 uranische/fiktive Himmelskörper und 9 Planetenmonde. Ein unbekannter Name wird stillschweigend zu None, statt einen Fehler auszulösen, und scheitert dann erst tief im Ephemeriden-Rechenkern. Beachte: Die Mondknoten verwenden die Schreibweise mit Unterstrich MEAN_NODE / TRUE_NODE (einen Alias 'RAHU'/'KETU' gibt es nicht).
tz	number (double)	Pflicht	min -12 · max 14
celestial	string	optional	`SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE` 36 zulässige Werte für die 10 Planeten, die beiden Mondknoten, 6 Asteroiden, 9 uranische/fiktive Himmelskörper und 9 Planetenmonde. Ein unbekannter Name wird stillschweigend zu None, statt einen Fehler auszulösen, und scheitert dann erst tief im Ephemeriden-Rechenkern. Beachte: Die Mondknoten verwenden die Schreibweise mit Unterstrich MEAN_NODE / TRUE_NODE (einen Alias 'RAHU'/'KETU' gibt es nicht).
celestial1	string	optional	`SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE` 36 zulässige Werte für die 10 Planeten, die beiden Mondknoten, 6 Asteroiden, 9 uranische/fiktive Himmelskörper und 9 Planetenmonde. Ein unbekannter Name wird stillschweigend zu None, statt einen Fehler auszulösen, und scheitert dann erst tief im Ephemeriden-Rechenkern. Beachte: Die Mondknoten verwenden die Schreibweise mit Unterstrich MEAN_NODE / TRUE_NODE (einen Alias 'RAHU'/'KETU' gibt es nicht).
celestial2	string	optional	`SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE` 36 zulässige Werte für die 10 Planeten, die beiden Mondknoten, 6 Asteroiden, 9 uranische/fiktive Himmelskörper und 9 Planetenmonde. Ein unbekannter Name wird stillschweigend zu None, statt einen Fehler auszulösen, und scheitert dann erst tief im Ephemeriden-Rechenkern. Beachte: Die Mondknoten verwenden die Schreibweise mit Unterstrich MEAN_NODE / TRUE_NODE (einen Alias 'RAHU'/'KETU' gibt es nicht).
degr	number (double)	optional
latitude	number (double)	optional	Breitengrad des Ortes in Dezimalgrad. Positiv ist Nord, negativ ist Süd. Beispiel: 26.9124 für Jaipur, 40.7128 für New York. Minuten und Sekunden werden nicht akzeptiert – vorher umrechnen. min -89.9 · max 89.9
longitude	number (double)	optional	Längengrad des Ortes in Dezimalgrad. Positiv ist Ost, negativ ist West. Beispiel: 75.7873 für Jaipur, -74.0060 für New York. Achte auf das Vorzeichen: Ein fehlendes Minus verlegt New York nach China. min -180 · max 180
nakshatras	string	optional	`special` WIRKUNGSLOSER PARAMETER auf der HTTP-Ebene: TransitView reicht ihn nie weiter, daher hat das Senden keine Wirkung. Im Rechenkern ist der einzige sinnvolle Wert das Literal 'special', das statt der standardmäßigen Tabelle mit 27 Einträgen die Tabelle nakshatras_special mit 28 Einträgen auswählt.
when	string	optional	`afterbefore` Standardwert des Rechenkerns: 'after'. Wird von den Keys 'solar_crossing', 'find_moon_crossing', 'moon_node_crossing' und 'celestial_conjunction' verwendet.
x2cross	number (double)	optional

Verfügbare Keys (8)

Liste in keys genau die Berechnungen auf, die du brauchst. Ein unbekannter Key lässt die ganze Anfrage scheitern. Du zahlst 1 Credit, ganz gleich, wie viele du anforderst – fass sie also in einer Anfrage zusammen.

Key	Zusätzliche Felder	Beschreibung
celestial_conjunction	celestial1, celestial2, datetime_start, when	Der erste Zeitpunkt nach `datetime_start`, zu dem `celestial1` und `celestial2` dieselbe ekliptikale Länge haben. Liefert ein Objekt mit `long1` und `long2`, den beiden Längen zum gefundenen Zeitpunkt – nahe beieinander, aber nicht exakt gleich, da die Suche bis zu einer Toleranz konvergiert – und `date`, dem ISO-Zeitstempel.
find_moon_crossing	x2cross, date_time, tz, when	Der Zeitpunkt, zu dem der Mond die in `x2cross` angegebene ekliptikale Länge erreicht, gesucht ab `date_time`, vorwärts oder rückwärts je nach `when`. Liefert einen einzelnen ISO-Zeitstempel, um `tz` verschoben. Da der Mond etwa 13 Grad pro Tag zurücklegt, liegt das Ergebnis normalerweise höchstens einen Monat vom Bezugszeitpunkt entfernt.
moon_node_crossing	date_time, tz, when	Der nächste oder vorherige Durchgang durch den Mondknoten, gesucht ab `date_time` in der durch `when` angegebenen Richtung. Liefert ein Objekt mit `date`, dem um `tz` verschobenen ISO-Zeitstempel, sowie `long` und `lat`, der ekliptikalen Länge und Breite zu diesem Zeitpunkt. Nützlich, um Finsternissaisons zu finden.
planet_transit	degr, planet, datetime_start, datetime_end, tz	Der Zeitpunkt, zu dem der in `planet` genannte Himmelskörper die in `degr` angegebene ekliptikale Länge überquert, gesucht zwischen `datetime_start` und `datetime_end`. Liefert einen einzelnen ISO-Zeitstempel, um `tz` verschoben, oder null, wenn der Himmelskörper diesen Grad innerhalb des Zeitfensters nie erreicht. Anders als bei den Übergängen von Sonne und Mond ist diese Suche begrenzt; wähle den Zeitraum also groß genug, dass das Ereignis darin liegt.
set_default_transit	—	Ein Modusschalter, keine Berechnung: Setzt die Ephemeride für den Rest der Anfrage auf tropisch (kein Ayanamsa angewandt). Liefert null. Keys werden in der Reihenfolge ausgewertet, in der du sie aufführst – setze diesen Schalter also vor die Übergangs-Keys, auf die er wirken soll.
set_sidereal_transit	—	Ein Modusschalter, keine Berechnung: Setzt die Ephemeride auf siderisch, sodass nachfolgende Übergänge und Positionen in derselben Anfrage gegenüber dem Ayanamsa statt dem tropischen Nullpunkt gemessen werden. Liefert null und muss vor den Keys aufgeführt werden, auf die er wirken soll.
solar_crossing	x2cross, date_time, tz, when	Der Zeitpunkt, zu dem die Sonne die in `x2cross` angegebene ekliptikale Länge erreicht, gesucht ab `date_time`, vorwärts oder rückwärts je nach `when`. Liefert einen einzelnen ISO-Zeitstempel, um den Stunden-Offset `tz` verschoben. Übergib 0, um ein siderisches Neujahr zu finden, oder eine Radix-Sonnenlänge, um einen Geburtstag auf die Minute genau zu bestimmen.
transit_details	celestial, date_time, tz	Eine vollständige Positionsausgabe für den in `celestial` genannten Himmelskörper zu `date_time`. Liefert ein Objekt mit `longitude` als vorformatiertem Anzeigestring, `nakshatra` und dessen `nakshatra_lord`, `padam` (das Viertel des Nakshatras, 1-4), `full_degree` (die siderische Länge geteilt durch 30, also die Zeichennummer plus der durchlaufene Bruchteil), `latitude_shara` als `{degrees, minutes, seconds}`, `speed` in Grad pro Tag als String, `right_ascension` im Format 'hh.mm.ss.ss' und `declination_kranti` in Grad als String.

Vollständige Referenz zu diesem Endpoint