Progressions secondaires

Astrologie occidentale

Progressions secondaires

Calculez un thème progressé secondaire selon la règle symbolique classique : un jour après la naissance équivaut à un an de vie. L’endpoint précise la base de progression, renvoie le thème progressé et peut ajouter les données natales de référence, les mouvements du cycle de vie, les événements marquants et une chronologie future.

Les valeurs de target_date contenant uniquement une date sont normalisées à 00:00:00Z. Le mode chronologie recherche, à partir de la date cible, les prochaines entrées, stations, aspects majeurs exacts et principales phases de la Lune progressée sur la durée définie par timeline_years.

Les événements d’aspect de la chronologie distinguent exact_at_target et becomes_exact pour que l’application distingue les aspects déjà exacts à la date cible de ceux qui le deviendront. Les contacts exacts de moindre importance impliquant principalement des angles sont filtrés pour rendre la chronologie plus utile.

Le comportement des nœuds est volontaire : le point par défaut north_node reste le nœud de référence de l’endpoint pour préserver la compatibilité. Demander true_node ajoute un point distinct pour le nœud vrai au lieu de le remplacer. Les stelliums excluent les points dérivés, notamment les nœuds et vertex , afin de ne pas gonfler le nombre de regroupements.

Paramètres de requête

Paramètre	Type	Requis	Description
natal.datetime	string	Oui	Date et heure de naissance. Les valeurs locales sans fuseau explicite sont normalisées à l’aide de natal.location.tz_str.
natal.location.tz_str	string	Non	Fuseau horaire, par exemple `Europe/Paris` ou `AUTO`. Par défaut : `AUTO`.
natal.time_known	boolean	Non	Inclure les maisons et les angles uniquement lorsque l’heure de naissance est connue.
secondary_progression.target_date	string	Oui	Date cible au format YYYY-MM-DD ou date-heure ISO complète. Les dates seules sont normalisées à 00:00:00Z.
settings.zodiac_type	string	Non	Zodiaque tropical ou sidéral.
settings.sidereal_ayanamsa	string	Non	Lorsque zodiac_type vaut sidereal : lahiri, raman, kp, fagan_bradley ou yukteshwar.
settings.orb_deg	number	Non	Orbe des aspects progressés. Doit être strictement supérieur à 0 et inférieur ou égal à 5.
settings.orb_settings	object	Non	Réglages d’orbe facultatifs par aspect, par exemple { Conjunction: 2.0, Trine: 1.5 }.
response_mode	query string	Non	Structure de la réponse. Par défaut : `full`. Utilisez `full` pour le thème imbriqué ou `table` pour des tableaux plus légers organisés en lignes.
settings.include_speed	boolean	Non	Renvoyer la vitesse des points et les indicateurs de station. Par défaut : false.
settings.include_dignity	boolean	Non	Renvoyer les dignités classiques des points concernés. Par défaut : false.
settings.include_minor_aspects	boolean	Non	Inclure les aspects mineurs pris en charge en plus des aspects majeurs. Par défaut : false.
settings.include_stelliums	boolean	Non	Renvoyer les groupes de stelliums calculés pour le thème. Par défaut : false.
settings.include_features	array[string]	Non	Points supplémentaires à inclure, par exemple chiron, lilith, true_node, mean_node ou vertex.
settings.include_dominants	boolean	Non	Renvoyer les distributions des dominantes du thème. Par défaut : false.
settings.timeline_years	number	Non	Durée de la chronologie future, en années. Utilisée uniquement lorsque include=timeline.
include	query string	Non	Valeurs de requête séparées par des virgules ou répétées : natal_reference, movements, lifecycle, timeline, highlights.

curl -X POST "https://api.freeastroapi.com/api/v1/western/progressions/secondary?response_mode=full&include=natal_reference,movements,lifecycle,timeline,highlights" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
    "natal": {
        "name": "User",
        "datetime": "1990-01-01 12:00",
        "time_known": true,
        "location": {
            "city": "London",
            "lat": 51.5074,
            "lng": -0.1278,
            "tz_str": "AUTO"
        }
    },
    "secondary_progression": {
        "target_date": "2026-03-30"
    }
}'

Extrait de réponse

Cet extrait a été enregistré depuis l’API en production le 14 avril 2026 avec la requête ci-dessus.

{
  "meta": {
    "endpoint": "secondary_progressions",
    "version": "v1",
    "zodiac_type": "tropical",
    "house_system": "placidus",
    "calculation_method": "secondary_progressions_day_for_year",
    "target_date": "2026-03-30",
    "target_datetime": "2026-03-30T00:00:00Z",
    "orb_deg": 1,
    "generated_at": "2026-04-14T15:54:50Z"
  },
  "progression_basis": {
    "age_years_decimal": 36.240337,
    "progressed_days_after_birth": 36.240337,
    "natal_datetime_utc": "1990-01-01T12:00:00Z",
    "progressed_datetime_utc": "1990-02-06T17:46:05Z"
  },
  "progressed_chart": {
    "points": {
      "sun": {
        "name": "Sun",
        "longitude_deg": 317.683036,
        "longitude_text": "17°41' Aqu",
        "latitude_deg": 0.000109,
        "distance_au": 0.986195,
        "sign": {
          "name": "Aquarius",
          "index": 10,
          "abbr": "Aqu"
        },
        "position_in_sign_deg": 17.683036,
        "house": 6,
        "retrograde": false
      },
      "moon": {
        "name": "Moon",
        "longitude_deg": 99.435703,
        "longitude_text": "09°26' Can",
        "latitude_deg": 3.189366,
        "distance_au": 0.002508,
        "sign": {
          "name": "Cancer",
          "index": 3,
          "abbr": "Can"
        },
        "position_in_sign_deg": 9.435703,
        "house": 11,
        "retrograde": false
      },
      "mercury": {
        "name": "Mercury",
        "longitude_deg": 293.169941,
        "longitude_text": "23°10' Cap",
        "latitude_deg": -0.005584,
        "distance_au": 1.089444,
        "sign": {
          "name": "Capricorn",
          "index": 9,
          "abbr": "Cap"
        },
        "position_in_sign_deg": 23.169941,
        "house": 5,
        "retrograde": false
      }
    },
    "angles": {
      "ascendant": {
        "longitude_deg": 146.991,
        "longitude_text": "26°59' Leo",
        "sign": {
          "name": "Leo",
          "index": 4,
          "abbr": "Leo"
        },
        "position_in_sign_deg": 26.991
      },
      "midheaven": {
        "longitude_deg": 45.46,
        "longitude_text": "15°28' Tau",
        "sign": {
          "name": "Taurus",
          "index": 1,
          "abbr": "Tau"
        },
        "position_in_sign_deg": 15.46
      }
    }
  },
  "movements": {
    "ingresses": [
      {
        "point": "moon",
        "from_sign": {
          "name": "Gemini",
          "index": 2,
          "abbr": "Gem"
        },
        "to_sign": {
          "name": "Cancer",
          "index": 3,
          "abbr": "Can"
        },
        "event_date": "2025-07-24T14:26:15Z",
        "interpretation_key": "progressed_moon_ingress_cancer"
      }
    ],
    "stations": [],
    "phase_markers": []
  },
  "lifecycle": {
    "progressed_moon": {
      "phase_angle_deg": 141.753,
      "phase_name": "Waxing Gibbous",
      "waxing": true,
      "next_major_phase": {
        "name": "New Moon",
        "event_date": "2029-04-21T11:10:25Z"
      }
    },
    "progressed_sun": {
      "sign": {
        "name": "Aquarius",
        "index": 10,
        "abbr": "Aqu"
      },
      "position_in_sign_deg": 17.683036
    }
  },
  "highlights": [
    {
      "type": "aspect",
      "title": "Progressed Pluto Square Progressed Sun",
      "severity": "strong",
      "score": 99,
      "category": "career",
      "interpretation_key": "progressed_pluto_square_progressed_sun",
      "reason_codes": [
        "MAJOR_ASPECT",
        "TIGHT_ORB",
        "LUMINARY_WEIGHTED"
      ]
    },
    {
      "type": "aspect",
      "title": "Progressed Mars Conjunction Natal Uranus",
      "severity": "strong",
      "score": 90,
      "category": "general",
      "interpretation_key": "progressed_mars_conjunction_natal_uranus",
      "reason_codes": [
        "MAJOR_ASPECT",
        "TIGHT_ORB"
      ]
    },
    {
      "type": "ingress",
      "title": "Progressed Moon entered Cancer",
      "severity": "medium",
      "score": 71,
      "category": "relationships",
      "interpretation_key": "progressed_moon_ingress_cancer",
      "reason_codes": [
        "SIGN_CHANGE",
        "LIFECYCLE_TRANSITION"
      ]
    },
    {
      "type": "aspect",
      "title": "Progressed Sun Square Natal Pluto",
      "severity": "light",
      "score": 48,
      "category": "career",
      "interpretation_key": "progressed_sun_square_natal_pluto",
      "reason_codes": [
        "MAJOR_ASPECT",
        "LUMINARY_WEIGHTED"
      ]
    },
    {
      "type": "aspect",
      "title": "Progressed Pluto Conjunction Natal Pluto",
      "severity": "light",
      "score": 35,
      "category": "general",
      "interpretation_key": "progressed_pluto_conjunction_natal_pluto",
      "reason_codes": [
        "MAJOR_ASPECT"
      ]
    }
  ],
  "aspects": {
    "progressed_to_natal": [
      {
        "id": "p_mars_conjunction_n_uranus",
        "aspect": {
          "name": "conjunction",
          "angle_deg": 0
        },
        "progressed_point": "mars",
        "natal_point": "uranus",
        "orb_deg": 0.1,
        "separation_deg": 0.1,
        "applying": false,
        "exact": false,
        "exact_date": "2026-02-08T00:00:00Z",
        "polarity": "neutral",
        "strength": 0.9,
        "category": "major",
        "interpretation_key": "progressed_mars_conjunction_natal_uranus"
      },
      {
        "id": "p_ic_sextile_n_saturn",
        "aspect": {
          "name": "sextile",
          "angle_deg": 60
        },
        "progressed_point": "ic",
        "natal_point": "saturn",
        "orb_deg": 0.197,
        "separation_deg": 60.197,
        "applying": false,
        "exact": false,
        "exact_date": "2026-03-30T04:46:31Z",
        "polarity": "soft",
        "strength": 0.803,
        "category": "major",
        "interpretation_key": "progressed_ic_sextile_natal_saturn"
      },
      {
        "id": "p_midheaven_trine_n_saturn",
        "aspect": {
          "name": "trine",
          "angle_deg": 120
        },
        "progressed_point": "midheaven",
        "natal_point": "saturn",
        "orb_deg": 0.197,
        "separation_deg": 119.803,
        "applying": false,
        "exact": false,
        "exact_date": "2026-03-30T04:46:31Z",
        "polarity": "soft",
        "strength": 0.867,
        "category": "major",
        "interpretation_key": "progressed_midheaven_trine_natal_saturn"
      }
    ],
    "progressed_to_progressed": [
      {
        "id": "p_pluto_square_p_sun",
        "aspect": {
          "name": "square",
          "angle_deg": 90
        },
        "point_1": "pluto",
        "point_2": "sun",
        "orb_deg": 0.058,
        "separation_deg": 89.942,
        "applying": true,
        "exact": false,
        "exact_date": "2026-04-19T22:30:00Z",
        "polarity": "hard",
        "strength": 0.999,
        "category": "major",
        "interpretation_key": "progressed_pluto_square_progressed_sun"
      }
    ]
  }
}

L’exemple de production versionné est disponible dans frontend/src/app/docs/western/secondary-progressions/live_response.json.