Déclinaisons
Un thème astral est une projection sur l'écliptique, et cette projection écarte un axe. La déclinaison est ce qui reste lorsque les mêmes corps sont mesurés depuis l'équateur céleste — la seconde table d'une éphéméride imprimée, et la coordonnée qui ne figure dans aucune grille d'aspects.
Deux choses vivent sur cet axe, et aucune n'est visible dans une carte zodiacale :
- Parallèles et contre-parallèles. Deux corps à la même déclinaison forment un parallèle, qui se comporte comme une conjonction. La même distance à l'équateur de part et d'autre est un contre-parallèle, qui se comporte comme une opposition. Les deux peuvent se produire entre des corps qui ne forment aucun aspect en longitude.
- Hors limites (out of bounds). Un corps au-delà de la déclinaison maximale du Soleil lui-même. La Lune l'est quelques jours par mois autour d'un arrêt lunaire majeur ; Mercure, Vénus, Mars et Pluton par intervalles. C'est une condition réelle et très discutée, et presque aucun logiciel grand public ne la signale.
Module Requis
Les deux points de terminaison nécessitent le module declination:calc. Il est inclus dans tous les forfaits et n'est pas vendu séparément.
Déclinaisons pour un instant
curl -X POST "https://api.astroapi.cloud/api/calc/declination" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"dateTime": "1990-06-15T14:30",
"location": {
"latitude": 52.37,
"longitude": 4.89,
"timezone": "Europe/Amsterdam"
},
"orb": 1
}'Paramètres
| Paramètre | Type | Requis | Description |
|---|---|---|---|
dateTime | string | Oui | YYYY-MM-DDTHH:mm, heure locale à location |
location | object | Oui | latitude, longitude et un timezone IANA |
points | array | Non | Points à calculer. Par défaut les dix corps, les deux nœuds et les deux Lilith |
orb | number | Non | Orbe des parallèles et contre-parallèles, de 0 à 3 degrés. Défaut 1 |
moonCenter | string | Non | topocentric (défaut) ou geocentric |
Un orbe ici n'est pas un orbe là-bas
Un orbe de déclinaison est bien plus serré qu'un orbe de longitude. Un degré est la convention et la valeur par défaut ; au-delà de deux degrés, presque tout est parallèle à quelque chose.
Réponse
{
"data": {
"dateTime": "1990-06-15T12:30:00.000Z",
"points": {
"sun": {
"pointId": "sun",
"declination": 23.32,
"declinationDms": [23, 19, 12],
"rightAscension": 84.1,
"latitude": 0,
"speedDeclination": 0.04,
"outOfBounds": false,
"hemisphere": "north"
},
"moon": {
"pointId": "moon",
"declination": -18.44,
"declinationDms": [18, 26, 24],
"rightAscension": 312.7,
"latitude": -4.61,
"speedDeclination": -3.1,
"outOfBounds": false,
"hemisphere": "south"
}
},
"aspects": [
{
"pointA": "venus",
"pointB": "mars",
"aspect": "parallel",
"orb": 0.31,
"applying": true,
"declinationA": 21.08,
"declinationB": 21.39
}
],
"extremes": {
"northernmost": "sun",
"southernmost": "moon",
"outOfBoundsCount": 0
},
"obliquity": 23.4405
}
}declinationDms est la valeur absolue sous forme [degrés, minutes, secondes] ; le côté figure dans hemisphere et dans le signe de declination. speedDeclination est en degrés par jour, et négatif signifie vers le sud — c'est ce qui indique si un parallèle est applicatif ou séparatif, la même question à laquelle applying répond pour un aspect en longitude.
La limite du hors limites
obliquity est l'obliquité vraie de l'écliptique à la date demandée — la déclinaison maximale du Soleil lui-même, et donc la limite par rapport à laquelle outOfBounds a été jugé. Elle est renvoyée pour qu'un client puisse dessiner la bande sans inventer sa propre limite.
Le chiffre conventionnel est 23°26'. Le vrai bouge : la nutation le déplace jusqu'à neuf secondes d'arc, et cela suffit à trancher un cas limite dans un sens ou dans l'autre. Comparer à l'obliquity renvoyée et comparer à un 23.4367 codé en dur donneront des réponses différentes pour un corps situé exactement sur la ligne.
Le Soleil n'est jamais hors limites
Par définition — la condition est « au-delà du Soleil ». Un corps exactement sur la limite n'est pas hors limites ; il doit être au-delà.
Déclinaison sur une période
L'autre moitié, et la raison pour laquelle ceci est un point de terminaison à part plutôt qu'un champ d'un thème natal : un graphique de déclinaison est une série temporelle, et les dates auxquelles un corps franchit la limite du hors limites sont ce qu'un astrologue note réellement.
curl -X POST "https://api.astroapi.cloud/api/calc/declination/series" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"startDate": "2025-01-01",
"endDate": "2025-12-31",
"stepDays": 2,
"points": ["sun", "moon", "mercury", "venus", "mars", "pluto"]
}'Paramètres
| Paramètre | Type | Requis | Description |
|---|---|---|---|
startDate | string | Oui | YYYY-MM-DD ou ISO 8601 |
endDate | string | Oui | YYYY-MM-DD ou ISO 8601 |
stepDays | number | Non | Jours entre deux points de la série, de 0,25 à 30. Défaut 1 |
points | array | Non | Points à tracer. Valeurs par défaut comme ci-dessus |
Réponse
{
"data": {
"startDate": "2025-01-01T00:00:00.000Z",
"endDate": "2025-12-31T23:59:00.000Z",
"stepDays": 2,
"points": ["sun", "moon", "mercury", "venus", "mars", "pluto"],
"series": {
"moon": [
["2025-01-01T00:00:00.000Z", -14.02],
["2025-01-03T00:00:00.000Z", 8.71]
]
},
"crossings": [
{
"pointId": "moon",
"date": "2025-03-06T07:41:12.000Z",
"direction": "out",
"declination": 23.4392
},
{
"pointId": "moon",
"date": "2025-03-10T02:18:55.000Z",
"direction": "in",
"declination": 23.4392
}
]
}
}Les franchissements ne sont pas échantillonnés à stepDays
Une sortie de la Lune au-delà de la limite dure quelques jours. Une série tracée au pas hebdomadaire l'enjamberait — c'est pourquoi les franchissements sont recherchés sur une grille plus fine que celle à laquelle la série est renvoyée, puis chacun est affiné contre l'éphéméride à la seconde près.
Conséquence pratique : un stepDays large vous coûte la forme de la courbe, jamais une date de franchissement. Demandez la résolution dont le graphique a besoin, et pas davantage.
La limite de la série
Une série est limitée à 400 points. Une année au pas journalier en fait 365 ; une décennie au pas journalier en fait 3653 et revient sous forme de 400 avec le conseil d'élargir le pas :
{
"error": "That range at a 1-day step is 3654 points; the limit is 400. Widen stepDays or shorten the range."
}C'est une seule requête dans les deux cas. Construire la même table à partir de 400 appels individuels coûte 400 requêtes de votre quota mensuel ; le point de terminaison de série les calcule en une seule passe et compte pour une.
Déclinaison dans un thème natal
À partir de la version d'API 2026-09-10, chaque point d'une réponse de thème natal porte également declination et outOfBounds, de sorte qu'une roue peut marquer un corps hors limites sans second appel :
curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
-H "X-Api-Key: your-api-key" \
-H "X-Api-Version: 2026-09-10" \
-H "Content-Type: application/json" \
-d '{ "dateTime": "1990-06-15T14:30", "location": { "latitude": 52.37, "longitude": 4.89, "timezone": "Europe/Amsterdam" } }'Un appelant sur une version antérieure conserve la forme de réponse qu'il a toujours reçue. Voir Versionnage de l'API pour savoir comment épingler une version.
La réponse natale ne porte que ces deux champs. Parallèles, contre-parallèles, ascension droite, vitesse de déclinaison et la série se trouvent tous sur les points de terminaison ci-dessus.
Ce que ce n'est pas
Il n'y a pas de vue 3D ici, et c'est délibéré. La bonne image de la déclinaison est une ligne contre un axe ; une sphère céleste la rend plus jolie sans la rendre plus claire.