Direkt zum Inhalt
POST/api/astro/panchanga/1 Credit

Panchanga

Das Panchanga ist der hinduistische Almanach für einen Zeitpunkt an einem Ort: fünf „Glieder“ – Tithi, Vaara, Nakshatra, Yoga und Karana – und dazu alles, was ein gedrucktes Panchang sonst noch enthält. Mit siebenundfünfzig Keys ist es der größte Endpoint der API; die meisten Aufrufer brauchen nur eine Handvoll davon. Beginne mit tithi, vaara, nakshatra_segments, yogam und karana für die fünf Glieder und mit day_length, night_length, midday und midnight für den Rahmen des Tages. Die Keys *_segments – tithi_segments, karana_segments, yoga_segments, nakshatra_segments – unterscheiden sich von ihren Gegenstücken im Singular auf eine Weise, die leicht missverstanden wird: Der Singular-Key beantwortet die Frage „Was gilt in diesem Moment?“, der Segments-Key dagegen listet jeden Zeitraum auf, der den ganzen lokalen Kalendertag berührt, mit genauen Anfangs- und Endzeiten – genau das, was eine Kalenderseite braucht. Der Rest lässt sich in Gruppen einteilen. Zeiteinteilungen: choghadiya und gauri_choghadiya in Achtel, hora in Planetenstunden, do_ghati in die dreißig Muhurtas, trikalam in Drittel. Benannte Zeitfenster: abhijit_muhurta, brahma_muhurta, vijaya_muhurta, nishita_muhurta, godhuli_muhurta, amrit_kalam und die beiden Sandhyas gegenüber rahu_kaalam, yamaganda_kaalam, gulika_kaalam und durmuhurata. Kalender: lunar_month und lunar_month_poornima (derselbe Monat nach den beiden Zählungen), shaka_samvat, vikram_samvat, kali_samvat, samvatsara_name, ritu, sankranti_dates und tamil_solar_month_date. Positionen statt Zeiten: upagraha_longitudes, special_longitudes, lagnas, sree_lagna und die beiden Varianten von bhaava_madhya. Bewertungen der Tagesqualität: tarabala, chandrabalam, panchaka_rahita, disha_shool, agni_vasa_segments, shiva_vasa_segments, yogas und shunya_nakshatra. Jeder Aufruf braucht date_time und timezone_as_float; alles, was vom Sonnenaufgang abhängt, braucht zusätzlich latitude und longitude. Mehrere optionale Felder ändern nicht nur die Formatierung, sondern das Ergebnis: samvata_type ist für samvatsara_name erforderlich, mode legt fest, wie ritu bestimmt wird, und gulika_rises_at, mandi_rises_at, gulika_portion, mandi_portion, kala_mrityu_rise_at und dhuma_vyatipata_relation wählen zwischen konkurrierenden klassischen Konventionen für die Upagraha-Positionen. Ein Aufruf kostet einen Credit, egal wie viele Keys du anforderst – fordere also gleich alles an, was eine ganze Seite braucht.

https://api.occultapi.com/api/astro/panchanga/
Anfrage testen
Ausgabe von Panchanga in einer Benutzeroberfläche
So sehen die Daten dieses Endpoints in einer echten Oberfläche aus. Die API liefert die Werte, das Layout baust du selbst.

Authentifizierung

Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Felder der Anfrage

FeldTypPflichtHinweise
date_timestring (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.

keysarrayPflicht

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.

timezone_as_floatnumber (double)Pflicht

UTC-Offset des Ortes in Stunden, als Dezimalzahl. Beispiel: 5.5 für Indien (UTC+05:30), -5 für New York im Winter, 5.75 für Nepal. Wird NICHT gegen date_time validiert – stimmen beide nicht überein, erhältst du eine erfolgreiche Antwort für den falschen Zeitpunkt; leite daher beide aus derselben Quelle ab. Nutze den an diesem Datum gültigen Offset, nicht den heutigen: Eine Sommergeburt in einem Land mit Sommerzeit braucht den Sommer-Offset.

min -12 · max 14

dhuma_vyatipata_relationstringoptional
360_minus_dhumadhuma_plus_53_20

Standard: '360_minus_dhuma'. Wird weitergereicht.

eccentric_anomalynumber (double)optional
eccentricitynumber (double)optional
gulika_portionstringoptional
saturneighth

Standard: 'saturn'. Wird weitergereicht.

gulika_rises_atstringoptional
beginningmiddleend

Standard: 'beginning'. Wird an das Panchanga-Objekt des Rechenkerns weitergereicht.

kala_mrityu_rise_atstringoptional
beginningmiddleend

Standard: 'middle'. Wird weitergereicht.

latitudenumber (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

longitudenumber (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

mandi_portionstringoptional
saturneighth

Standard: 'saturn'. Wird weitergereicht.

mandi_rises_atstringoptional
beginningmiddleend

Standard: 'middle'. Wird weitergereicht.

mean_anomalynumber (double)optional
modestringoptional
vedicdrik

Wird nur vom Key 'ritu' verwendet. 'vedic' leitet die Jahreszeit aus dem Mondmonat ab, 'drik' aus dem tropischen Zeichen der Sonne. Standardwert des Rechenkerns: 'drik'. WARNUNG: Die Funktion meldet bei einem ungültigen Wert keinen Fehler – jeder andere String fällt stillschweigend durch beide Zweige, und der Key liefert null (das mitgelieferte Katalogbeispiel sendet sogar mode=0 und erhält Status 200 mit dem Ergebnis null).

nakshatrasstringoptional
special

Im Rechenkern ist der einzige sinnvolle Wert der String 'special': Er ersetzt die Tabelle `nakshatras` mit 27 Einträgen durch die Tabelle `nakshatras_special` mit 28 Einträgen, die Abhijit enthält und moderne Schreibweisen verwendet. Weil der Wert nie weitergereicht wird, bricht der Key 'yogas' dieses Endpoints derzeit mit einem 500-Fehler ab: "'Panchanga' object has no attribute 'nakshatras'".

samvata_typestringoptional
shakavikram

Wird nur vom Key 'samvatsara_name' verwendet.

tolerancenumber (double)optional

Verfügbare Keys (57)

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.

KeyZusätzliche FelderBeschreibung
abhijit_muhurta—Abhijit: das achte der fünfzehn Tages-Muhurtas, das um die Mitte der hellen Tageszeit liegt – das günstige Zeitfenster für alle Zwecke. Liefert {start, end}.
agni_vasa_segments—Wo Agni, der Gott des Feuers, weilen soll – das wird vor einem Homa geprüft. Abgeleitet aus Tithi und Wochentag, wechselt der Wert also mit der Tithi. Liefert eine Liste von {state, is_patala, start_time, end_time}, eine pro Tithi-Segment des Tages; state ist 'Prithvi (Earth)', 'Akasha (Heaven)' oder 'Patala (Nadir)'. Homas für ein bestimmtes Ziel sollen vollzogen werden, während Agni auf Prithvi weilt; is_patala kennzeichnet den Zustand, den manche Panchangs Bhadravasa nennen.
amrit_kalam—Die Perioden vom Typ Amrit aus dem Gowri Panchangam, die den Tag berühren – die günstigsten Zeilen dieser Tabelle. Liefert eine Liste von {start, end}, normalerweise zwei: eine am Tag und eine in der Nacht. Abgeleitet aus denselben Wochentagstabellen wie gauri_choghadiya; mit der auf Nakshatras beruhenden Amrita Gadiya mancher anderer Panchangs hat sie nichts zu tun.
bhaava_madhya_sripati—Die zwölf Häuserspitzen in derselben Struktur {degree, sign, minutes, seconds, nakshatra, pada} wie bhaava_madhya_swe. Das Sripati-System ist klassisch eine Quadrantenteilung, diese Implementierung übernimmt daraus aber nur den Aszendenten und addiert dann jeweils dreißig Grad. Für einen bestimmten Zeitpunkt liefert sie deshalb dieselben zwölf Werte wie bhaava_madhya_swe.
bhaava_madhya_swe—Die zwölf Häuserspitzen nach dem System der äqualen Häuser im siderischen Tierkreis, beginnend mit dem ersten Haus. Liefert eine Liste von zwölf Objekten, jeweils {degree, sign, minutes, seconds, nakshatra, pada}; sign ist eine Abkürzung aus zwei Buchstaben wie 'Ar' oder 'Cp'.
brahma_muhurta—Brahma-Muhurta: die letzten beiden Muhurtas der Nacht vor Sonnenaufgang, jedes ein Fünfzehntel der Nachtlänge – die traditionelle Zeit für Studium, Gebet und Meditation. Liefert {start, end}.
calcualte_special_tithi—Die Tithi mit ihren klassischen Sondernamen: dasselbe Objekt wie beim Key tithi, dazu ein Feld special_name mit einem kommagetrennten String aller Labels, die auf die Tithi des Tages zutreffen, oder null, wenn keines zutrifft. In der Praxis greifen die Labels, die daran hängen, dass die Tithi bei Sonnenaufgang oder mittags gilt (Udayayvapini, Madhyanaha), sowie die speziellen Labels für Amavasya (Sinivaali, Vriddhigami). Viele Einträge der zugrunde liegenden Tabelle sind an Telugu-Namen von Tithis gebunden, die die eigene Tithi-Berechnung dieses Endpoints nicht erzeugt – sie treffen daher nie zu. Beachte, dass der Key-Name mit der gezeigten Buchstabenvertauschung geschrieben wird.
chandrabalam—Chandra Bala: welche der aufsteigenden Zeichen des Tages im Verhältnis zum aktuellen Zeichen des Mondes gut stehen und sich daher eignen, um etwas zu beginnen. Liefert eine Liste von Zeichennamen in der Reihenfolge Widder bis Fische, meist sechs der zwölf, entnommen aus den udaya_lagna_muhurta-Zeitfenstern, die vor dem nächsten Sonnenaufgang beginnen.
choghadiya—Die Choghadiya-Perioden: Der helle Tag und die Nacht werden jeweils in acht gleiche Teile geteilt, deren Namen in fester Reihenfolge rotieren, beginnend mit dem Choghadiya des jeweiligen Wochentags. Liefert {day_choghadiyas, night_choghadiyas, current_choghadiya, day_periods, night_periods}. Die beiden Namenslisten haben je acht Einträge – der Zyklus aus sieben Namen, so verschoben, dass er mit dem Startnamen des Tages beginnt, und dieser Name am Ende noch einmal. day_periods und night_periods enthalten dieselben acht als {name, start, end}, und current_choghadiya ist der Name, der zum angefragten Zeitpunkt gilt.
day_length—Sonnenuntergang minus Sonnenaufgang für den Tag, in den der angefragte Zeitpunkt fällt, als Dauer in Sekunden. Wird als JSON-STRING geliefert, nicht als Zahl – "48927.0" –; parse den Wert also, bevor du damit rechnest. Die meisten Einteilungen des Tages in diesem Endpoint – choghadiya, hora, rahu_kaalam, die Tages-Muhurtas – sind Achtel, Zwölftel oder Fünfzehntel dieses Werts.
disha_shool—Die Richtung, in die man heute nicht reisen soll, allein abhängig vom Wochentag. Ein einzelner String: East, South, West, North oder eine der vier Zwischenrichtungen.
do_ghati—Die vollständige Tabelle der dreißig Muhurtas – fünfzehn zwischen Sonnenaufgang und Sonnenuntergang und fünfzehn zwischen Sonnenuntergang und dem nächsten Sonnenaufgang. Liefert {day_muhurtas, night_muhurtas, current}. Jedes Muhurta hat die Form {index, number, muhurta, auspicious, name, division, special, start, end}: muhurta ist die zuständige Gottheit, number seine Position 1-30 über Tag und Nacht hinweg, name das zugehörige Nakshatra, division der Abschnitt des Tages (Pratah, Sangava, Madhyahna und so weiter), auspicious ein boolescher Wert, und special kennzeichnet benannte Zeitfenster wie Abhijit. current ist der Eintrag, in den der angefragte Zeitpunkt fällt, oder null.
durmuhurata—Durmuhurta: das eine oder die zwei kurzen ungünstigen Zeitfenster des Tages. Liefert {first, second, interval}; first und second sind ISO-Zeitstempel, second ist an Wochentagen mit nur einem Fenster null. `interval` ist die Dauer jedes Fensters in Sekunden und, wie die anderen Dauern hier, ein JSON-STRING – "2880.0" für die üblichen 48 Minuten. Beachte: Die Abstände zum Sonnenaufgang sind feste Uhrzeitstunden aus einer Wochentagstabelle, keine anteiligen Teile der Tageslänge.
eccentric_anomalymean_anomaly, eccentricity, toleranceKeine astrologische Größe, sondern eine allgemeine Hilfsfunktion aus der Bahnmechanik: löst die Kepler-Gleichung per Newton-Iteration. Nimmt mean_anomaly in Grad, eccentricity und optional eine Toleranz (Standard: 1e-6) entgegen und liefert eine einzelne Zahl in Grad.
gauri_choghadiya—Gowri Panchangam, die südindische Achtteilung aus der tamilischen Praxis: acht Perioden am Tag und acht in der Nacht, jede ein Achtel des hellen Tages bzw. der Nacht, jede mit einem Namen und nach einer Tabelle je Wochentag als gut oder schlecht eingestuft. Liefert {day_gowri, night_gowri}, jeweils eine Liste von acht {name, status, start, end}; status ist 'Good' oder 'Bad'.
godhuli_muhurta—Godhuli, die „Kuhstaub-Stunde“ um den Sonnenuntergang: von einem Viertel eines Tages-Muhurtas vor Sonnenuntergang bis zu einem Viertel eines Nacht-Muhurtas danach. Liefert {start, end}.
gulika_kaalam—Gulika Kaalam, auch Kulika genannt: das Achtel des hellen Tages, das dem Schatten Saturns zugeordnet ist. Anders als die beiden anderen gilt es als günstig für alles, was dauern oder sich wiederholen soll. Liefert {gulika_start, gulika_end}. Nicht zu verwechseln mit dem Eintrag 'gulika' in special_longitudes, der eine Position im Tierkreis ist und kein Zeitfenster.
hora—Die vierundzwanzig Planetenstunden: zwölf gleiche Abschnitte des hellen Tages und zwölf der Nacht, jeder von einem Planeten beherrscht – in der klassischen Reihenfolge, beginnend mit dem Herrscher des Wochentags. Liefert {day_horas, night_horas}, jeweils eine Liste von zwölf {planet, start, end}. Außer zu den Tagundnachtgleichen sind Tages- und Nacht-Horas unterschiedlich lang.
kali_samvat—Das Jahr der Kali-Yuga-Zählung, shaka_samvat plus 3179; es wechselt mit Chaitra Shukla Pratipada. Eine einzelne Ganzzahl.
karana—Das zum angefragten Zeitpunkt gültige Karana – eine halbe Tithi, sechs Grad Elongation Mond minus Sonne. Liefert einen von elf Namen: die sieben beweglichen Bava, Balava, Kaulava, Taitula, Garaja, Vanija und Vishti oder die vier festen Kimstughna, Shakuni, Chatushpada und Naga. Vishti wird meist Bhadra genannt und gemieden.
karana_segments—Alle Karana-Perioden, die sich mit dem lokalen Kalendertag überschneiden, als geordnete Liste von {name, start_time, end_time}. Ein Karana dauert elf bis dreizehn Stunden; rechne also mit zwei oder drei Einträgen pro Tag.
lagnas—Fünf besondere Aszendenten, die schneller laufen als das aufsteigende Zeichen und alle ab Sonnenaufgang gemessen werden. Liefert ein Objekt mit 'Bhava Lagna' (ein Zeichen alle zwei Stunden), 'Hora Lagna' (ein Zeichen pro Stunde, herangezogen für das Einkommen), 'Ghati Lagna' (ein Zeichen alle vierundzwanzig Minuten, herangezogen für Status und Autorität), 'Indu Lagna' (der Wohlstandspunkt, gebildet aus den Herrschern des neunten Hauses, gezählt vom Aszendenten und vom Mond) und 'Bhrigu Lagna' (der Mittelpunkt zwischen Mond und Rahu, meist Bhrigu Bindu genannt), jeweils {degree, sign, minutes, seconds, nakshatra, pada}.
lunar_month—Der Amanta-Mondmonat, in den das angefragte Datum fällt – von Neumond zu Neumond –, benannt nach dem Zeichen des Mondes bei dem Neumond, mit dem er begann. Ein einzelner String, einer der zwölf Namen von Vaisakha bis Chaitra. Adhika-Monate (Schaltmonate) werden nicht eigens gekennzeichnet.
lunar_month_poornima—Derselbe Monat nach der Purnimanta-Zählung, die von Vollmond zu Vollmond reicht; benannt nach dem Zeichen der Sonne bei dem Vollmond, mit dem er begann. Ein einzelner String. Nordindische Kalender verwenden diese Zählung, und in der dunklen Monatshälfte nennt sie für denselben Tag einen anderen Monat als lunar_month.
lunar_phase—Die Elongation zwischen Sonne und Mond und die Monatshälfte, die sich daraus ergibt. Liefert {paksha, moon_phase}; moon_phase ist der Winkel in Grad von 0 bis 360, paksha ist unter 180 'Shukla' und ab 180 'Krishna'.
midday—Wahrer Ortsmittag – der Zeitpunkt, an dem die Sonne am angegebenen Ort den oberen Meridian überquert, einige Minuten vor oder nach 12 Uhr. Ein einzelner Zeitstempel mit dem in timezone_as_float übergebenen Offset.
midnight—Der Durchgang der Sonne durch den unteren Meridian, also die wahre Ortsmitternacht. Ein einzelner Zeitstempel mit dem angefragten Offset. Das ist nicht dasselbe wie die Mitte der Nacht zwischen Sonnenuntergang und Sonnenaufgang, um die herum nishita_muhurta gebildet wird.
nakshatra_segments—Jedes Mond-Nakshatra, das sich mit dem lokalen Kalendertag überschneidet, als Liste von {name, start_time, end_time}. Die Grenzen sind exakte Durchgänge der Mondlänge, gefunden per Bisektion. Die Namen verwenden die modernen Schreibweisen – Shatabhisha, Purva Bhadrapada – statt der älteren Transliterationen, die einige andere Endpoints dieser API verwenden.
night_length—Sonnenuntergang bis zum nächsten Sonnenaufgang, als Dauer in Sekunden und wie day_length als JSON-STRING statt als Zahl geliefert – "37464.0". Das Gegenstück zu day_length und die Grundlage für die Nachthälften von choghadiya, hora und do_ghati sowie für brahma_muhurta und nishita_muhurta.
nishita_muhurta—Nishita: je eine Ghati vor und nach der Mitte der Nacht zwischen Sonnenuntergang und nächstem Sonnenaufgang; eine Ghati ist hier ein Dreißigstel der Nachtlänge. Liefert {start, end}. Die Mitte der Nacht ist nicht derselbe Zeitpunkt wie Mitternacht.
panchaka_rahita—Der Tag, aufgeteilt in Zeitfenster, jedes mit dem Panchaka gekennzeichnet, in das es fällt, nach der klassischen Regel (Tithi + Nakshatra + Wochentag + aufsteigendes Zeichen) mod 9. Liefert eine Liste von {panchaka, start, end} von Sonnenaufgang bis zum nächsten Sonnenaufgang; panchaka ist für ein unbelastetes Zeitfenster null und sonst einer der Werte 'Mrityu Panchaka', 'Agni Panchaka', 'Raja Panchaka', 'Chora Panchaka' oder 'Roga Panchaka'. Ein neues Zeitfenster beginnt bei jedem Wechsel des aufsteigenden Zeichens und bei jedem Tithi- oder Nakshatra-Wechsel dazwischen; etwa vierzehn Einträge sind daher üblich.
pratah_sandhya—Das Zeitfenster für die Andacht in der Morgendämmerung: von zwei Ghatis vor bis eine Ghati nach Sonnenaufgang; eine Ghati ist hier ein Dreißigstel der Tageslänge. Liefert {start, end}.
rahu_kaalam—Rahu Kaalam: das Achtel des hellen Tages, das als ungeeignet gilt, um etwas zu beginnen; wo es im Tag liegt, bestimmt der Wochentag. Liefert {rahu_start, rahu_end}, die ein Achtel von day_length auseinanderliegen.
ritumodeDie Jahreszeit. mode wählt die Methode: 'drik' leitet sie aus dem tropischen Zeichen der Sonne ab, 'vedic' aus dem Mondmonat. Liefert {ritu, season, lord}, zum Beispiel {'Vasanta', 'Spring', 'Venus'}. Standardwert des Rechenkerns ist 'drik'; jeder andere Wert als diese beiden liefert stillschweigend null statt eines Fehlers.
samvatsara_namesamvata_typeDer Name des Jahres im sechzigjährigen Jupiterzyklus, Prabhava bis Kshaya. Erfordert samvata_type: 'vikram' liefert den nordindischen Namen (den Samvatsara des mittleren Jupiters zur Mesha-Sankranti des Jahres), 'shaka' den südindischen Namen, der an das Mondjahr gebunden ist – die beiden können also voneinander abweichen. Liefert einen einzelnen String; fehlt samvata_type, gibt es einen Fehler.
sankranti_dates—Die Eintritte der Sonne in die Zeichen vor und nach dem angefragten Zeitpunkt – die Grenzen des laufenden Sonnenmonats. Liefert {'Previous Sankranti', 'Next Sankranti'} als Zeitstempel mit dem angefragten Offset.
sayahna_sandhya—Das Zeitfenster für die Andacht in der Abenddämmerung: von einer Ghati vor bis zwei Ghatis nach Sonnenuntergang, wieder mit Ghatis auf Basis der Tageslänge. Liefert {start, end}.
shaka_samvat—Das Jahr der Shaka-Ära. Es wechselt mit Chaitra Shukla Pratipada: Von Januar bis dahin ist es das gregorianische Jahr minus 79, danach das gregorianische Jahr minus 78. Eine einzelne Ganzzahl.
shiva_vasa_segments—Wo Shiva weilt – die entsprechende Prüfung vor einem Rudrabhisheka, allein aus der Tithi abgeleitet. Liefert eine Liste von {state, start_time, end_time}, eine pro Tithi-Segment des Tages; state ist einer von sieben Zuständen – 'with Gowri', 'in Kailasha', 'on Vrishabha (Nandi)', 'at Bhojanam', 'in Sabha', 'at Work/Play' oder 'in Shmashana' –, von denen die ersten drei günstig sind.
shunya_nakshatra—Ob der Mond gerade in einem der zwei oder drei Nakshatras steht, die im laufenden Amanta-Mondmonat als leer gelten und in denen man nichts Neues beginnt. Liefert den String 'shunya_nakshatra', wenn das zutrifft, sonst null – nur ein Flag, ohne Namen oder Zeitfenster in der Antwort.
special_longitudes—Die sechs aus der Zeit abgeleiteten Upagrahas. Der helle Tag bzw. die Nacht wird in acht planetare Abschnitte geteilt, und das aufsteigende Zeichen wird an einem gewählten Punkt innerhalb eines bestimmten Abschnitts bestimmt. Liefert ein Objekt mit den Schlüsseln 'kaala', 'mrityu', 'artha_praharaka', 'yama_ghantaka', 'maandi' und 'gulika', jeweils {degree, sign, minutes, seconds, nakshatra, pada}. Kaala nutzt den Abschnitt der Sonne, Mrityu den des Mars, Artha Praharaka und Yama Ghantaka die Mitte der Abschnitte von Merkur und Jupiter, Gulika und Maandi den Abschnitt Saturns. Deshalb sind die Anfragefelder kala_mrityu_rise_at, gulika_rises_at und mandi_rises_at wichtig: Ob Beginn, Mitte oder Ende des Abschnitts gewählt wird, unterscheidet Gulika von Maandi.
sree_lagna—Sree-Lagna, der Wohlstandspunkt: der Aszendent, vorgerückt um den Anteil seines Nakshatras, den der Mond bereits durchlaufen hat, wobei dieser Anteil auf den ganzen Tierkreis übertragen wird. Liefert ein einzelnes {degree, sign, minutes, seconds, nakshatra, pada}.
tamil_solar_month_date—Das Datum im tamilischen Sonnenkalender. Liefert {'Tamil Solar Month', 'Tamil Solar Date'} – den Monatsnamen von Chithirai bis Panguni und den Tag als Ganzzahl. Diese Implementierung zählt die Tage ab einem festen Neujahr am 14. April in Blöcken zu dreißig Tagen statt ab den tatsächlichen Sankranti-Zeitpunkten; sie kann daher um ein bis zwei Tage von einem veröffentlichten tamilischen Panchangam abweichen.
tarabala—Tara Bala: welche der siebenundzwanzig Geburts-Nakshatras im Verhältnis zum Nakshatra des Transitmondes günstig stehen. Liefert {good_nakshatras, valid_until, good_nakshatras_tier2, tier2_valid_until}. Die erste Liste enthält fünfzehn Namen und gilt, bis der Mond sein aktuelles Nakshatra zum Zeitpunkt valid_until verlässt; das tier2-Paar wendet dieselbe Regel auf das folgende Nakshatra an und gilt bis zum nächsten Sonnenaufgang. Beide tier2-Felder sind null, wenn der Mond im Laufe des Tages das Nakshatra nicht wechselt.
tithi—Der Mondtag zum angefragten Zeitpunkt: {paksha, name, number, start_time, end_time, remaining_time}. number ist 1-15 für Shukla, 16-29 für Krishna und 30 für Amavasya; remaining_time gibt als {hours, minutes, seconds} an, wie lange die Tithi noch dauert. Bei Voll- und Neumond enthält das Feld paksha 'Purnima' bzw. 'Amavasya' statt des Namens der Monatshälfte. Für alle Tithis, die den Tag berühren, nutze tithi_segments.
tithi_segments—Alle Tithis, die sich mit dem lokalen Kalendertag überschneiden, als Liste von {paksha, name, number, start_time, end_time}. number ist 1-15 in der hellen Monatshälfte, 16-29 in der dunklen und 30 für Amavasya. Beachte: Bei Voll- und Neumond enthält das Feld paksha 'Purnima' bzw. 'Amavasya' statt 'Shukla' oder 'Krishna'. Eine Tithi dauert im Mittel 23.6 Stunden; an den meisten Tagen gibt es daher einen Eintrag, an manchen zwei.
trikalam—Der helle Tag, in drei gleiche Teile geteilt. Liefert {morning, afternoon, evening}, jeweils {start, end}. Es ist eine einfache Dreiteilung des Tages und nicht das Trio Rahu/Yamaganda/Gulika, das der Begriff in manchen tamilischen Panchangams bezeichnet.
true_anomalyeccentric_anomaly, eccentricityDas passende Gegenstück zur Umrechnung: Nimmt eccentric_anomaly in Grad und eccentricity entgegen und liefert die wahre Anomalie in Grad als einzelne Zahl. Beachte: Die exzentrische Anomalie wird aus dem gleichnamigen Anfragefeld gelesen – das Ergebnis des Keys eccentric_anomaly aus demselben Aufruf wird nicht übernommen.
udaya_lagna_muhurta—Die zwölf aufeinanderfolgenden Zeitfenster der aufsteigenden Zeichen über den Tag, beginnend mit dem Zeichen, das kurz vor Sonnenaufgang bereits aufsteigt. Liefert eine geordnete Liste von zwölf {rashi, start, end}, die etwa einen Sterntag umfasst – rund vier Minuten weniger als von Sonnenaufgang zu Sonnenaufgang. chandrabalam und panchaka_rahita werden beide aus dieser Liste berechnet.
upagraha_longitudes—Die fünf Schattenpunkte, rein rechnerisch aus der siderischen Länge der Sonne abgeleitet, jeder aus dem vorherigen: Dhuma bei Sonne plus 133°20', dann Vyatipata, Parivesha, Indrachapa und Upaketu. Liefert ein Objekt mit den Schlüsseln 'Dhuma', 'Vyatipata', 'Parivesha', 'Indrachapa' und 'Upaketu', jeweils {degree, sign, minutes, seconds, nakshatra, pada}. Das Feld dhuma_vyatipata_relation legt fest, welche der beiden klassischen Formeln Vyatipata aus Dhuma ableitet, und verschiebt damit alle vier nachfolgenden Punkte.
vaara—Der Wochentag, gerechnet ab Sonnenaufgang statt ab Mitternacht – ein Zeitpunkt zwischen Mitternacht und Sonnenaufgang gehört also noch zum vorherigen Vaara. Ein einzelner String: Ravivara, Somavara, Mangalavara, Budhavara, Guruvara, Shukravara oder Shanivara.
vijaya_muhurta—Vijaya-Muhurta, das 11. der fünfzehn gleich langen Muhurtas zwischen Sonnenaufgang und Sonnenuntergang, am Nachmittag – das Zeitfenster für alles, was sich gegen Widerstände durchsetzen muss. Liefert {start, end}.
vikram_samvat—Das Jahr nach Vikram Samvat. Es wechselt mit Chaitra Shukla Pratipada: Von Januar bis dahin ist es das gregorianische Jahr plus 56, danach das gregorianische Jahr plus 57. Eine einzelne Ganzzahl.
yamaganda_kaalam—Yamaganda Kaalam, ein zweites, durch den Wochentag bestimmtes ungünstiges Achtel des Tageslichts. Liefert {yamaganda_start, yamaganda_end}.
yoga_segments—Alle Nityayoga-Perioden, die sich mit dem lokalen Kalendertag überschneiden, als geordnete Liste von {name, start_time, end_time}. Ein Yoga dauert im Mittel etwa 22.6 Stunden, ein Tag umfasst daher meist zwei. Die Grenzen sind die exakten Zeitpunkte, an denen die Summe aus Sonnen- und Mondlänge die Grenzwerte überschreitet, nicht auf den Tag gerundet.
yogam—Das Nityayoga: Die siderischen Längen von Sonne und Mond werden addiert und die Summe in siebenundzwanzig gleiche Bögen zu 13°20' geteilt. Liefert für den angefragten Zeitpunkt einen einzelnen Namen, Vishkambha bis Vaidhriti. Für die Perioden davor und danach nutze yoga_segments.
yogas—Die gerade gültigen benannten Kombinationen aus Tithi, Nakshatra und Wochentag – die günstigen und ungünstigen „Yogas“, die ein Panchang für den Tag aufführt, etwa Sarvartha Siddhi, Amrit Siddhi, Dwipushkara, Tripushkara, Guru Pushya, Ravi Pushya, Panchaka, Dagdha, Yama Ghanta und Dutzende weitere aus rund zwanzig klassischen Tabellen. Liefert {yogas: [...]}, eine Liste von Namen, die leer ist, wenn keines zutrifft. Nicht zu verwechseln mit yogam, dem einzelnen Nityayoga des Zeitpunkts.

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-06-02T06:30:52.786Z","keys":["midday"],"latitude":26.849,"longitude":75.768,"timezone_as_float":5.5,"samvata_type":"shaka","mode":0,"mean_anomaly":0,"eccentricity":1,"tolerance":0.000001,"gulika_rises_at":"beginning","mandi_rises_at":"middle","kala_mrityu_rise_at":"middle","dhuma_vyatipata_relation":"360_minus_dhuma"}'

Antwort

{
  "data": {
    "midday": "2026-06-02T12:24:53+05:30"
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data, jeweils unter dem Key, den du angefordert hast.

Fehler

Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.