Transits (occidental)

POST/api/v1/transits/calculate

Calculez les transits planétaires pour une date précise et comparez-les à un thème natal. La réponse retourne les positions planétaires actuelles et les aspects formés entre les planètes en transit et les planètes natales.

Par défaut, la réponse inclut les blocs d'interprétation et le set de corps en transitsun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, true_node, chiron, lilith. Désactivez les interprétations avec "interpretation": {"enable": false}.

Les naissances sans heure sont prises en charge via natal.time_known=false. Dans ce mode, le côté natal se comporte comme l'endpoint Natal: les maisons et angles sont omis, et les placements de maisons des planètes natales ne sont pas retournés.

URL complète

https://api.freeastroapi.com/api/v1/transits/calculate

Fonctionnement des calculs de transits

Les transits comparent le ciel actuel (ou toute date précisée) avec le thème natal d'une personne.

•(T) indique une planète en transit (position actuelle)
•(N) indique une planète natale (position de naissance)
•Les aspects entre planètes (T) et (N) révèlent les thèmes de vie actuels

Paramètres de requête

Paramètre	Type	Requis	Description
natal.name	string	Non	Nom de la personne (par défaut: User)
natal.year	integer	Oui	Année de naissance natale
natal.month	integer	Oui	Mois de naissance natal (1-12)
natal.day	integer	Oui	Jour de naissance natal
natal.time_known	boolean	Non	Par défaut: true. Passez false quand l'heure de naissance est inconnue. En mode sans heure, les maisons et angles natals sont omis.
natal.hour	integer	Non	Heure de naissance natale (0-23). Requise quand natal.time_known=true. Ignorée structurellement quand natal.time_known=false.
natal.minute	integer	Non	Minute de naissance natale. Requise quand natal.time_known=true. Ignorée structurellement quand natal.time_known=false.
natal.lat	float	Oui	Latitude de naissance natale
natal.lng	float	Oui	Longitude de naissance natale
current_city	string	Oui	Nom de la ville actuelle
current_lat	float	Non	Latitude actuelle (optionnelle si city est fourni)
current_lng	float	Non	Longitude actuelle (optionnelle si city est fourni)
transit_date	string	Non	Date de transit au format ISO (par défaut: maintenant)
tz_str	string	Non	Timezone du lieu de transit (par défaut: AUTO)
orb_settings	object	Non	Overrides optionnels d'orbe par aspect, par ex. { Conjunction: 8, Trine: 6 }
interpretation	object	Non	Les interprétations sont activées par défaut. Passez { enable: false } pour désactiver les blocs d'interprétation.

📅 Format de date de transit

Utilisez le format ISO 8601: YYYY-MM-DDTHH:MM

Exemples:

2025-01-15T12:00 - 15 janvier 2025 à midi

2025-06-21T00:00 - 21 juin 2025 à minuit

Exemples de code

curl -X POST "https://api.freeastroapi.com/api/v1/transits/calculate" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
    "natal": {
        "name": "John Doe",
        "city": "New York",
        "year": 1990,
        "month": 5,
        "day": 15,
        "time_known": false,
        "hour": 10,
        "minute": 30,
        "lat": 40.7128,
        "lng": -74.006,
        "tz_str": "AUTO"
    },
    "transit_date": "2025-01-15T12:00",
    "current_city": "Paris",
    "current_lat": 48.8566,
    "current_lng": 2.3522,
    "tz_str": "AUTO",
    "orb_settings": {
        "Conjunction": 8.0,
        "Opposition": 8.0,
        "Trine": 6.0,
        "Square": 6.0,
        "Sextile": 4.0
    }
}'

Données de réponse

{
  "transit_date": "2025-01-15",
  "transit_time": "12:00:00",
  "mode": "transit_to_natal",
  "location": {
    "city": "Paris",
    "lat": 48.8566,
    "lng": 2.3522,
    "timezone": "Europe/Paris"
  },
  
  "natal_planets": [
    {
      "id": "sun",
      "name": "Sun",
      "sign": "Tau",
      "pos": 24.72,
      "abs_pos": 54.72,
      "house": 9
    }
    // ...
  ],
  
  "transit_planets": [
    {
      "id": "sun",
      "name": "Sun",
      "sign": "Cap",
      "pos": 25.12,
      "abs_pos": 295.12,
      "house": 5,
      "retrograde": false
    }
    // ...
  ],

  // Default set includes: sun, moon, mercury, venus, mars, jupiter,
  // saturn, uranus, neptune, pluto, true_node, chiron, lilith
  
  "aspects": [
    {
      "p1": "Sun (N)",
      "p2": "Sun (T)",
      "between": { "natal": "sun", "transit": "sun" },
      "type": "Trine",
      "orb": 0.4,
      "deg": 120.0,
      "is_major": true,
      "is_applying": true
    }
    // ...
  ],
  
  "aspects_summary": {
    "total": 18,
    "major": 12,
    "minor": 6,
    "applying": 8,
    "separating": 10,
    "by_type": { "Trine": 4, "Square": 3 }
  },

  "interpretation": {
    "metadata": { "found_count": 12, "missing_keys": [] },
    "sections": {
      "core_self": [
        {
          "key": "aspect.sun.trine.sun",
          "title": "Sun Trine Sun (Transit)",
          "body": "A period of vital harmony where your current path aligns perfectly with your core essence..."
        }
      ]
      // ... mind, love_relating, work_path, etc.
    },
    "index": {
      "aspects": [
        {
          "p1": "sun",
          "p2": "sun",
          "type": "trine",
          "title": "Sun Trine Sun (Transit)",
          "content": "..."
        }
      ]
    }
  }
}

Endpoints liés

Thème natal

Calculez d'abord le thème natal

Graphique SVG de synastrie

Générer une carte relationnelle à double roue pour deux personnes

BaZi Flow

Analyse de timing en astrologie chinoise