/api/astro/transit/1 créditPassages en transit
Cet endpoint recherche des moments plutôt que de décrire un thème à un instant fixe. Il répond aux questions du type : quand le Soleil atteindra-t-il de nouveau 0 degré du Bélier, quand Mars franchira-t-il un degré donné entre deux dates, quand Saturne et le Soleil partageront-ils de nouveau une même longitude écliptique, et où se trouve exactement un corps à un instant donné. Deux des clés sont des commutateurs de mode plutôt que des calculs. `set_default_transit` sélectionne les éphémérides tropicales simples et `set_sidereal_transit` les éphémérides sidérales, et les deux renvoient null. Les clés d’une requête sont évaluées dans l’ordre où vous les listez : placez donc le commutateur en premier si vous voulez que les recherches suivantes soient sidérales. Les champs `planet`, `celestial`, `celestial1` et `celestial2` utilisent des noms d’éphémérides en majuscules (`SUN`, `MOON`, `MEAN_NODE`, `TRUE_NODE`, `CHIRON`, les points uraniens et plusieurs lunes planétaires), un vocabulaire différent des noms `Sun`/`Moon` utilisés sur la plupart des autres endpoints proposés ici. `tz` est un simple décalage en heures appliqué à chaque horodatage renvoyé, `when` détermine s’il faut chercher 'after' ou 'before' le moment de référence, et `datetime_start`/`datetime_end` bornent la plage pour `planet_transit`.
https://api.occultapi.com/api/astro/transit/
Authentification
Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonChamps de la requête
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| date_time | string (date-time) | obligatoire | Le moment du calcul, en ISO 8601. Incluez TOUJOURS un décalage ou un Z final - une valeur sans fuseau est lue comme Asia/Kolkata (UTC+05:30), et non comme UTC, et peut renvoyer le résultat de la veille avec un statut 200. '2026-09-01T06:00:00Z' et '2026-09-01 06:00:00' sont des instants différents et donnent des réponses différentes. |
| datetime_end | string (date-time) | obligatoire | |
| datetime_start | string (date-time) | obligatoire | |
| keys | array | obligatoire | Les calculs à renvoyer, sous forme de liste de noms. Consultez le tableau des clés de cet endpoint ; un nom non reconnu fait rejeter toute la requête. Un appel coûte un crédit quel que soit le nombre de clés demandées : demandez donc tout ce dont vous avez besoin en une seule fois plutôt que de faire plusieurs appels. |
| planet | string | obligatoire | SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE36 valeurs acceptées, qui couvrent les 10 planètes, les deux nœuds lunaires, 6 astéroïdes, 9 corps uraniens/fictifs et 9 lunes planétaires. Un nom non reconnu est converti sans avertissement en None au lieu de provoquer une erreur, ce qui fait ensuite échouer le calcul plus loin dans le moteur d’éphémérides. Notez que les nœuds s’écrivent avec un tiret bas, MEAN_NODE / TRUE_NODE (il n’existe pas d’alias 'RAHU'/'KETU'). |
| tz | number (double) | obligatoire | min -12 · max 14 |
| celestial | string | facultatif | SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE36 valeurs acceptées, qui couvrent les 10 planètes, les deux nœuds lunaires, 6 astéroïdes, 9 corps uraniens/fictifs et 9 lunes planétaires. Un nom non reconnu est converti sans avertissement en None au lieu de provoquer une erreur, ce qui fait ensuite échouer le calcul plus loin dans le moteur d’éphémérides. Notez que les nœuds s’écrivent avec un tiret bas, MEAN_NODE / TRUE_NODE (il n’existe pas d’alias 'RAHU'/'KETU'). |
| celestial1 | string | facultatif | SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE36 valeurs acceptées, qui couvrent les 10 planètes, les deux nœuds lunaires, 6 astéroïdes, 9 corps uraniens/fictifs et 9 lunes planétaires. Un nom non reconnu est converti sans avertissement en None au lieu de provoquer une erreur, ce qui fait ensuite échouer le calcul plus loin dans le moteur d’éphémérides. Notez que les nœuds s’écrivent avec un tiret bas, MEAN_NODE / TRUE_NODE (il n’existe pas d’alias 'RAHU'/'KETU'). |
| celestial2 | string | facultatif | SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE36 valeurs acceptées, qui couvrent les 10 planètes, les deux nœuds lunaires, 6 astéroïdes, 9 corps uraniens/fictifs et 9 lunes planétaires. Un nom non reconnu est converti sans avertissement en None au lieu de provoquer une erreur, ce qui fait ensuite échouer le calcul plus loin dans le moteur d’éphémérides. Notez que les nœuds s’écrivent avec un tiret bas, MEAN_NODE / TRUE_NODE (il n’existe pas d’alias 'RAHU'/'KETU'). |
| degr | number (double) | facultatif | |
| latitude | number (double) | facultatif | Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord. min -89.9 · max 89.9 |
| longitude | number (double) | facultatif | Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine. min -180 · max 180 |
| nakshatras | string | facultatif | specialPARAMÈTRE SANS EFFET au niveau HTTP : TransitView ne le transmet jamais, si bien que l’envoyer n’a aucun effet. Dans le moteur, la seule valeur significative est le littéral 'special', qui sélectionne la table nakshatras_special de 28 entrées au lieu de celle de 27 entrées par défaut. |
| when | string | facultatif | afterbeforeLa valeur par défaut du moteur est 'after'. Utilisé par les clés 'solar_crossing', 'find_moon_crossing', 'moon_node_crossing' et 'celestial_conjunction'. |
| x2cross | number (double) | facultatif |
Clés disponibles (8)
Listez dans keys exactement les calculs voulus. Une clé inconnue fait rejeter toute la requête. Vous payez 1 crédit, quel que soit le nombre de clés demandées : regroupez-les donc.
| Clé | Champs supplémentaires requis | Description |
|---|---|---|
| celestial_conjunction | celestial1, celestial2, datetime_start, when | Le premier moment après `datetime_start` où `celestial1` et `celestial2` ont la même longitude écliptique. Renvoie un objet avec `long1` et `long2`, les deux longitudes au moment trouvé — proches mais pas exactement égales, puisque la recherche s’arrête à une tolérance donnée — et `date`, l’horodatage ISO. |
| find_moon_crossing | x2cross, date_time, tz, when | L’instant où la Lune atteint la longitude écliptique indiquée dans `x2cross`, en cherchant vers l’avant ou vers l’arrière à partir de `date_time` selon `when`. Renvoie un seul horodatage ISO décalé de `tz`. Comme la Lune avance d’environ 13 degrés par jour, la réponse se situe normalement à moins d’un mois du moment de référence. |
| moon_node_crossing | date_time, tz, when | Le passage suivant ou précédent par le nœud lunaire, en cherchant à partir de `date_time` dans la direction indiquée par `when`. Renvoie un objet avec `date`, l’horodatage ISO décalé de `tz`, ainsi que `long` et `lat`, la longitude et la latitude écliptiques à ce moment. Utile pour repérer les saisons d’éclipses. |
| planet_transit | degr, planet, datetime_start, datetime_end, tz | Le moment où le corps indiqué dans `planet` franchit la longitude écliptique indiquée dans `degr`, recherché entre `datetime_start` et `datetime_end`. Renvoie un seul horodatage ISO décalé de `tz`, ou null lorsque le corps n’atteint jamais ce degré dans la plage. Contrairement aux passages du Soleil et de la Lune, celui-ci est borné : donnez-lui donc une plage assez large pour contenir l’événement. |
| set_default_transit | — | Un commutateur de mode, pas un calcul : règle les éphémérides en tropical (aucun ayanamsa appliqué) pour le reste de la requête. Renvoie null. Les clés sont évaluées dans l’ordre où vous les listez : placez-le donc avant les clés de passage qu’il doit affecter. |
| set_sidereal_transit | — | Un commutateur de mode, pas un calcul : règle les éphémérides en sidéral, de sorte que les passages et positions suivants de la même requête sont mesurés par rapport à l’ayanamsa plutôt qu’au point zéro tropical. Renvoie null, et doit être listé avant les clés qu’il doit affecter. |
| solar_crossing | x2cross, date_time, tz, when | L’instant où le Soleil atteint la longitude écliptique indiquée dans `x2cross`, en cherchant vers l’avant ou vers l’arrière à partir de `date_time` selon `when`. Renvoie un seul horodatage ISO décalé de `tz` heures. Passez 0 pour trouver un nouvel an sidéral, ou une longitude solaire natale pour trouver un anniversaire à la minute près. |
| transit_details | celestial, date_time, tz | Un relevé de position complet pour le corps indiqué dans `celestial` à `date_time`. Renvoie un objet avec `longitude` sous forme de chaîne d’affichage préformatée, `nakshatra` et son `nakshatra_lord`, `padam` (le quart du nakshatra, 1-4), `full_degree` (la longitude sidérale divisée par 30, soit le numéro du signe plus la fraction parcourue), `latitude_shara` sous la forme `{degrees, minutes, seconds}`, `speed` en degrés par jour sous forme de chaîne, `right_ascension` au format 'hh.mm.ss.ss' et `declination_kranti` en degrés sous forme de chaîne. |
Exemple de requête
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"}'Réponse
{
"data": {
"set_sidereal_transit": null,
"planet_transit": "2026-05-11T12:38:41+05:30",
"solar_crossing": "2025-04-14T03:21:25+05:30",
"celestial_conjunction": {
"long1": 327.886,
"long2": 327.877,
"date": "2025-03-12T10:13:52.466000Z"
},
"transit_details": {
"longitude": "4° Mesh 4'° 25\"",
"nakshatra": "Makha",
"padam": 2,
"nakshatra_lord": "Ketu",
"full_degree": 4.15,
"latitude_shara": {
"degrees": 2,
"minutes": 5,
"seconds": 52.8
},
"speed": "0.2",
"right_ascension": "08.29.10.92",
"declination_kranti": "21.19"
}
},
"status": 200,
"is_error": false,
"message": "successful"
}Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data, sous le nom de chaque clé demandée.
Erreurs
Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.