Directions primaires

Techniques prévisionnelles occidentales

Directions primaires

Calculez les dates des directions primaires d’un thème natal sur une période. La méthode par défaut est Regiomontanus in-mundo. Des variantes Campanus, topocentrique, Placidus par semi-arcs, Placidus zodiacal sous le pôle et zodiacale symbolique sont également disponibles.

Les options classiques comprennent les dates-heures exactes, la correction du mouvement secondaire de la Lune, les doctrines de latitude, les cuspides de maisons comme significateurs, la Part de Fortune, les antisces, contre-antisces, termes égyptiens ou ptolémaïques, la syzygie, le nœud sud et les parallèles mondains facultatifs.

Endpoint

POST

https://api.freeastroapi.com/api/v1/western/directions/primary

Routes associées

/directions/primary/exact-aspects/directions/primary/search/directions/primary/calendar

Méthodes classiques prises en charge

regiomontanus_in_mundo, campanus_in_mundo, topocentric_in_mundoet placidus_semiarc_in_mundo renvoient des directions mondaines sous forme de tableau.
placidus_under_pole_zodiacal et zodiacal renvoient des directions zodiacales sous forme de tableau.
Chaque événement conserve date et ajoute exact_datetime_utc ainsi que exact_datetime_local lorsque le fuseau natal est exploitable.
Utilisez une variante explicite de Placidus ; les requêtes ambiguës placidus sont rejetées afin que le client choisisse la doctrine voulue.
La limite de réponse en production est de range.limit: 300. Utilisez une limite plus faible pour les widgets chronologiques et les interfaces paginées.

Vous cherchez la règle « 1 an = 1 degré » ?

Utilisez les réglages des directions symboliques : method=zodiacal, direction=directet key=ptolemy. Ils appliquent la clé fixe de Ptolémée, soit exactement un degré par an.

Consulter les directions symboliques

Exemples de code

curl -X POST "https://api.freeastroapi.com/api/v1/western/directions/primary" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "natal": {
    "name": "Documentation Sample",
    "datetime": "1990-01-01 12:00",
    "time_known": true,
    "location": {
      "city": "London",
      "lat": 51.5074,
      "lng": -0.1278,
      "tz_str": "Europe/London"
    }
  },
  "settings": {
    "method": "regiomontanus_in_mundo",
    "direction": "both",
    "key": "naibod",
    "secondary_motion": "moon",
    "latitude_doctrine": "both",
    "bounds_system": "egyptian",
    "include_bounds": true,
    "include_natal_reference": false,
    "promissors": [
      "sun",
      "moon",
      "mercury",
      "venus",
      "mars",
      "jupiter",
      "saturn"
    ],
    "significators": [
      "asc",
      "mc",
      "dc",
      "ic",
      "sun",
      "moon",
      "lot_of_fortune"
    ],
    "aspects": [
      "conjunction",
      "sextile",
      "square",
      "trine",
      "opposition"
    ],
    "orb_years": 1
  },
  "range": {
    "start_date": "2026-01-01",
    "end_date": "2030-12-31",
    "limit": 5
  }
}'

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 interprétées à l’aide de natal.location.tz_str.
natal.time_known	boolean	Non	Requis lorsque des angles, des cuspides de maisons ou la Part de Fortune sont demandés. Par défaut : true.
natal.location	object	Oui	Ville et coordonnées natales. Les requêtes contenant uniquement une ville sont résolues lorsque cela est possible.
settings.method	string	Non	regiomontanus_in_mundo, campanus_in_mundo, topocentric_in_mundo, placidus_semiarc_in_mundo, placidus_under_pole_zodiacal ou zodiacal. Par défaut : regiomontanus_in_mundo.
settings.direction	string	Non	direct, converse ou both. Par défaut : direct.
settings.key	string	Non	naibod, ptolemy ou custom. Par défaut : naibod.
settings.custom_key_deg_per_year	number	Non	Requis lorsque settings.key vaut custom.
settings.secondary_motion	boolean\|string	Non	false/none, true/moon. all_planets est réservé à un futur mode expérimental.
settings.latitude_doctrine	string	Non	none, promissor, significator, both ou bianchini. Par défaut : both pour les méthodes in-mundo, none pour les méthodes zodiacales.
settings.bounds_system	string	Non	egyptian ou ptolemaic. Par défaut : egyptian.
settings.include_bounds	boolean	Non	Ajoute le maître du terme aux métadonnées du prometteur, du significateur et des positions dirigées.
settings.include_bound_promissors	boolean	Non	Génère des prometteurs de limites de termes tels que term_aries_1 selon le système de termes choisi.
settings.include_antiscia	boolean	Non	Génère des points antiscion_<point> sélectionnables pour les planètes, la Part de Fortune, les angles et la syzygie, lorsqu’ils sont disponibles.
settings.include_contra_antiscia	boolean	Non	Génère des points contra_antiscion_<point> sélectionnables.
settings.include_mundane_parallels	boolean	Non	Active parallel et contra_parallel pour les méthodes in-mundo.
settings.include_natal_reference	boolean	Non	Inclure le tableau des points natals résolus. Par défaut : true ; utilisez false pour une réponse plus compacte.
settings.promissors	array[string]	Non	Points natals dirigés. Par défaut : du Soleil à Saturne. Prend en charge les planètes, south_node, syzygy, lot_of_fortune, les antisces et contre-antisces ainsi que les limites de termes facultatives. Les angles et cuspides de maisons ne sont pas des prometteurs.
settings.significators	array[string]	Non	Points natals de référence. Prend en charge asc, mc, dc, ic, house_1 à house_12, les planètes, south_node, syzygy, lot_of_fortune et les points classiques générés.
settings.aspects	array[string]	Non	conjunction, sextile, square, trine, opposition. Avec include_mundane_parallels=true : parallel, contra_parallel.
settings.orb_years	number	Non	Fenêtre d’activation du calendrier autour des directions exactes. Par défaut : 1.
range.start_date	string	Oui	Début de la recherche au format YYYY-MM-DD ou date-heure ISO.
range.end_date	string	Oui	Fin de la recherche au format YYYY-MM-DD ou date-heure ISO.
range.limit	integer	Non	Nombre maximal de lignes renvoyées. Par défaut : 100 ; maximum : 300.

Requête réelle

Cette requête versionnée utilise un thème natal de Londres avec heure connue, Regiomontanus in-mundo, le mouvement secondaire lunaire, la latitude des deux points, les termes égyptiens et une limite de cinq lignes.

{
  "natal": {
    "name": "Documentation Sample",
    "datetime": "1990-01-01 12:00",
    "time_known": true,
    "location": {
      "city": "London",
      "lat": 51.5074,
      "lng": -0.1278,
      "tz_str": "Europe/London"
    }
  },
  "settings": {
    "method": "regiomontanus_in_mundo",
    "direction": "both",
    "key": "naibod",
    "secondary_motion": "moon",
    "latitude_doctrine": "both",
    "bounds_system": "egyptian",
    "include_bounds": true,
    "include_natal_reference": false,
    "promissors": [
      "sun",
      "moon",
      "mercury",
      "venus",
      "mars",
      "jupiter",
      "saturn"
    ],
    "significators": [
      "asc",
      "mc",
      "dc",
      "ic",
      "sun",
      "moon",
      "lot_of_fortune"
    ],
    "aspects": [
      "conjunction",
      "sextile",
      "square",
      "trine",
      "opposition"
    ],
    "orb_years": 1
  },
  "range": {
    "start_date": "2026-01-01",
    "end_date": "2030-12-31",
    "limit": 5
  }
}

Réponse réelle

Cette réponse a été produite par l’implémentation locale du backend avec la requête ci-dessus. Elle montre les dates-heures exactes en UTC et en heure locale, les fenêtres d’activation, les positions mondaines Regiomontanus et les métadonnées des maîtres des termes.

{
  "meta": {
    "endpoint": "primary_directions",
    "version": "v1",
    "method": "regiomontanus_in_mundo",
    "calculation_method": "regiomontanus_in_mundo_naibod_key_diurnal_armc_house_position_lunar_secondary_motion_both_latitude",
    "zodiac_type": "tropical",
    "direction": "both",
    "key": "naibod",
    "key_deg_per_year": 0.985647362,
    "range_start": "2026-01-01",
    "range_end": "2030-12-31",
    "generated_at": "2026-05-14T00:00:00Z",
    "warnings": [
      "In-mundo directions are computed as classical table rows with the selected primary-direction house system; zodiacal directions remain available with method=zodiacal.",
      "Secondary motion correction is applied astronomically to the Moon promissor using the directed arc converted from sidereal time to UT."
    ]
  },
  "input": {
    "birth_datetime": "1990-01-01 12:00",
    "birth_location": {
      "city": "London",
      "lat": 51.5074,
      "lng": -0.1278,
      "tz_str": "Europe/London"
    },
    "time_known": true,
    "promissors": [
      "sun",
      "moon",
      "mercury",
      "venus",
      "mars",
      "jupiter",
      "saturn"
    ],
    "significators": [
      "asc",
      "mc",
      "dc",
      "ic",
      "sun",
      "moon",
      "lot_of_fortune"
    ],
    "aspects": [
      "conjunction",
      "sextile",
      "square",
      "trine",
      "opposition"
    ],
    "orb_years": 1,
    "search_step_deg": 0.25,
    "secondary_motion": "moon",
    "latitude_doctrine": "both",
    "bounds_system": "egyptian",
    "include_bounds": true,
    "include_bound_promissors": false,
    "include_antiscia": false,
    "include_contra_antiscia": false,
    "include_mundane_parallels": false
  },
  "directions": [
    {
      "id": "pd.direct.saturn.trine.moon.2027-05-28T23:01:50.388898Z",
      "date": "2027-05-28",
      "exact_datetime_utc": "2027-05-28T23:01:50.388898Z",
      "exact_datetime_local": "2027-05-29T00:01:50.388898+01:00",
      "age_years": 37.4038,
      "direction": "direct",
      "promissor": "saturn",
      "significator": "moon",
      "aspect": {
        "name": "trine",
        "angle_deg": 120
      },
      "arc_deg": 36.866994,
      "arc_group_id": "pdg.mundane.direct.saturn.2027-05-28T23:01:50.388898Z.36.866994",
      "key": "naibod",
      "key_deg_per_year": 0.985647362,
      "promissor_natal_longitude_deg": 285.657498,
      "directed_longitude_deg": 285.657498,
      "significator_longitude_deg": 333.267655,
      "measurement": "mundane",
      "house_system": "regiomontanus",
      "promissor_natal_mundane_position": 282.675724,
      "directed_mundane_position": 214.161957,
      "significator_mundane_position": 334.161957,
      "promissor_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 3,
        "lord": "venus",
        "start_deg": 284,
        "end_deg": 292
      },
      "significator_bound": {
        "system": "egyptian",
        "sign": "pisces",
        "index": 1,
        "lord": "venus",
        "start_deg": 330,
        "end_deg": 342
      },
      "directed_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 3,
        "lord": "venus",
        "start_deg": 284,
        "end_deg": 292
      },
      "orb_years": 1,
      "active_window": {
        "from": "2026-05-28",
        "exact": "2027-05-28",
        "to": "2028-05-28",
        "from_datetime_utc": "2026-05-28T17:13:05.259298Z",
        "exact_datetime_utc": "2027-05-28T23:01:50.388898Z",
        "to_datetime_utc": "2028-05-28T04:50:35.518498Z",
        "from_datetime_local": "2026-05-28T18:13:05.259298+01:00",
        "exact_datetime_local": "2027-05-29T00:01:50.388898+01:00",
        "to_datetime_local": "2028-05-28T05:50:35.518498+01:00"
      },
      "interpretation_key": "primary_direction.direct.trine.saturn.moon"
    },
    {
      "id": "pd.converse.saturn.sextile.lot_of_fortune.2027-07-27T23:53:26.349170Z",
      "date": "2027-07-27",
      "exact_datetime_utc": "2027-07-27T23:53:26.349170Z",
      "exact_datetime_local": "2027-07-28T00:53:26.349170+01:00",
      "age_years": 37.5682,
      "direction": "converse",
      "promissor": "saturn",
      "significator": "lot_of_fortune",
      "aspect": {
        "name": "sextile",
        "angle_deg": 60
      },
      "arc_deg": 37.029008,
      "arc_group_id": "pdg.mundane.converse.saturn.2027-07-27T23:53:26.349170Z.37.029008",
      "key": "naibod",
      "key_deg_per_year": 0.985647362,
      "promissor_natal_longitude_deg": 285.657498,
      "directed_longitude_deg": 285.657498,
      "significator_longitude_deg": 77.397434,
      "measurement": "mundane",
      "house_system": "regiomontanus",
      "promissor_natal_mundane_position": 282.675724,
      "directed_mundane_position": 342.60122,
      "significator_mundane_position": 42.60122,
      "promissor_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 3,
        "lord": "venus",
        "start_deg": 284,
        "end_deg": 292
      },
      "significator_bound": {
        "system": "egyptian",
        "sign": "gemini",
        "index": 4,
        "lord": "mars",
        "start_deg": 77,
        "end_deg": 84
      },
      "directed_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 3,
        "lord": "venus",
        "start_deg": 284,
        "end_deg": 292
      },
      "orb_years": 1,
      "active_window": {
        "from": "2026-07-27",
        "exact": "2027-07-27",
        "to": "2028-07-27",
        "from_datetime_utc": "2026-07-27T18:04:41.219570Z",
        "exact_datetime_utc": "2027-07-27T23:53:26.349170Z",
        "to_datetime_utc": "2028-07-27T05:42:11.478770Z",
        "from_datetime_local": "2026-07-27T19:04:41.219570+01:00",
        "exact_datetime_local": "2027-07-28T00:53:26.349170+01:00",
        "to_datetime_local": "2028-07-27T06:42:11.478770+01:00"
      },
      "interpretation_key": "primary_direction.converse.sextile.saturn.lot_of_fortune"
    },
    {
      "id": "pd.converse.jupiter.trine.mc.2027-10-31T09:31:58.251733Z",
      "date": "2027-10-31",
      "exact_datetime_utc": "2027-10-31T09:31:58.251733Z",
      "exact_datetime_local": "2027-10-31T09:31:58.251733+00:00",
      "age_years": 37.8294,
      "direction": "converse",
      "promissor": "jupiter",
      "significator": "mc",
      "aspect": {
        "name": "trine",
        "angle_deg": 120
      },
      "arc_deg": 37.28646,
      "arc_group_id": "pdg.mundane.converse.jupiter.2027-10-31T09:31:58.251733Z.37.286460",
      "key": "naibod",
      "key_deg_per_year": 0.985647362,
      "promissor_natal_longitude_deg": 95.148794,
      "directed_longitude_deg": 95.148794,
      "significator_longitude_deg": 279.88249,
      "measurement": "mundane",
      "house_system": "regiomontanus",
      "promissor_natal_mundane_position": 78.877261,
      "directed_mundane_position": 150,
      "significator_mundane_position": 270,
      "promissor_bound": {
        "system": "egyptian",
        "sign": "cancer",
        "index": 1,
        "lord": "mars",
        "start_deg": 90,
        "end_deg": 97
      },
      "significator_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 2,
        "lord": "jupiter",
        "start_deg": 277,
        "end_deg": 284
      },
      "directed_bound": {
        "system": "egyptian",
        "sign": "cancer",
        "index": 1,
        "lord": "mars",
        "start_deg": 90,
        "end_deg": 97
      },
      "orb_years": 1,
      "active_window": {
        "from": "2026-10-31",
        "exact": "2027-10-31",
        "to": "2028-10-30",
        "from_datetime_utc": "2026-10-31T03:43:13.122133Z",
        "exact_datetime_utc": "2027-10-31T09:31:58.251733Z",
        "to_datetime_utc": "2028-10-30T15:20:43.381333Z",
        "from_datetime_local": "2026-10-31T03:43:13.122133+00:00",
        "exact_datetime_local": "2027-10-31T09:31:58.251733+00:00",
        "to_datetime_local": "2028-10-30T15:20:43.381333+00:00"
      },
      "interpretation_key": "primary_direction.converse.trine.jupiter.mc"
    },
    {
      "id": "pd.converse.jupiter.sextile.ic.2027-10-31T09:31:58.251733Z",
      "date": "2027-10-31",
      "exact_datetime_utc": "2027-10-31T09:31:58.251733Z",
      "exact_datetime_local": "2027-10-31T09:31:58.251733+00:00",
      "age_years": 37.8294,
      "direction": "converse",
      "promissor": "jupiter",
      "significator": "ic",
      "aspect": {
        "name": "sextile",
        "angle_deg": 60
      },
      "arc_deg": 37.28646,
      "arc_group_id": "pdg.mundane.converse.jupiter.2027-10-31T09:31:58.251733Z.37.286460",
      "key": "naibod",
      "key_deg_per_year": 0.985647362,
      "promissor_natal_longitude_deg": 95.148794,
      "directed_longitude_deg": 95.148794,
      "significator_longitude_deg": 99.88249,
      "measurement": "mundane",
      "house_system": "regiomontanus",
      "promissor_natal_mundane_position": 78.877261,
      "directed_mundane_position": 150,
      "significator_mundane_position": 90,
      "promissor_bound": {
        "system": "egyptian",
        "sign": "cancer",
        "index": 1,
        "lord": "mars",
        "start_deg": 90,
        "end_deg": 97
      },
      "significator_bound": {
        "system": "egyptian",
        "sign": "cancer",
        "index": 2,
        "lord": "venus",
        "start_deg": 97,
        "end_deg": 103
      },
      "directed_bound": {
        "system": "egyptian",
        "sign": "cancer",
        "index": 1,
        "lord": "mars",
        "start_deg": 90,
        "end_deg": 97
      },
      "orb_years": 1,
      "active_window": {
        "from": "2026-10-31",
        "exact": "2027-10-31",
        "to": "2028-10-30",
        "from_datetime_utc": "2026-10-31T03:43:13.122133Z",
        "exact_datetime_utc": "2027-10-31T09:31:58.251733Z",
        "to_datetime_utc": "2028-10-30T15:20:43.381333Z",
        "from_datetime_local": "2026-10-31T03:43:13.122133+00:00",
        "exact_datetime_local": "2027-10-31T09:31:58.251733+00:00",
        "to_datetime_local": "2028-10-30T15:20:43.381333+00:00"
      },
      "interpretation_key": "primary_direction.converse.sextile.jupiter.ic"
    },
    {
      "id": "pd.direct.saturn.sextile.sun.2028-10-19T11:15:59.846321Z",
      "date": "2028-10-19",
      "exact_datetime_utc": "2028-10-19T11:15:59.846321Z",
      "exact_datetime_local": "2028-10-19T12:15:59.846321+01:00",
      "age_years": 38.7988,
      "direction": "direct",
      "promissor": "saturn",
      "significator": "sun",
      "aspect": {
        "name": "sextile",
        "angle_deg": 60
      },
      "arc_deg": 38.241964,
      "arc_group_id": "pdg.mundane.direct.saturn.2028-10-19T11:15:59.846321Z.38.241964",
      "key": "naibod",
      "key_deg_per_year": 0.985647362,
      "promissor_natal_longitude_deg": 285.657498,
      "directed_longitude_deg": 285.657498,
      "significator_longitude_deg": 280.814261,
      "measurement": "mundane",
      "house_system": "regiomontanus",
      "promissor_natal_mundane_position": 282.675724,
      "directed_mundane_position": 212.165018,
      "significator_mundane_position": 272.165018,
      "promissor_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 3,
        "lord": "venus",
        "start_deg": 284,
        "end_deg": 292
      },
      "significator_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 2,
        "lord": "jupiter",
        "start_deg": 277,
        "end_deg": 284
      },
      "directed_bound": {
        "system": "egyptian",
        "sign": "capricorn",
        "index": 3,
        "lord": "venus",
        "start_deg": 284,
        "end_deg": 292
      },
      "orb_years": 1,
      "active_window": {
        "from": "2027-10-20",
        "exact": "2028-10-19",
        "to": "2029-10-19",
        "from_datetime_utc": "2027-10-20T05:27:14.716721Z",
        "exact_datetime_utc": "2028-10-19T11:15:59.846321Z",
        "to_datetime_utc": "2029-10-19T17:04:44.975921Z",
        "from_datetime_local": "2027-10-20T06:27:14.716721+01:00",
        "exact_datetime_local": "2028-10-19T12:15:59.846321+01:00",
        "to_datetime_local": "2029-10-19T18:04:44.975921+01:00"
      },
      "interpretation_key": "primary_direction.direct.sextile.saturn.sun"
    }
  ]
}