Directions symboliques

Directions symboliques : 1 an = 1 degré

POST/api/v1/western/directions/primary

Cette page décrit la technique des directions zodiacales dans laquelle chaque année de vie fait avancer un point d’exactement un degré. Dans l’API, elle utilise l’endpoint des directions primaires avec method=zodiacal, direction=directet key=ptolemy.

URL complète

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

Routes associées

/directions/primary/calendar/directions/primary/search

Réglages exacts

method: zodiacal

Utiliser des arcs zodiacaux symboliques plutôt que des directions mondaines in-mundo.

direction: direct

Faire avancer le prometteur dans le zodiaque.

key: ptolemy

Appliquer la clé fixe de Ptolémée : 1,0 degré par an.

Requête minimale

La réponse contient les directions exactes sur la période demandée. La requête ci-dessous correspond à l’exemple versionné utilisé pour la réponse.

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": "Symbolic Directions 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": "zodiacal",
    "direction": "direct",
    "key": "ptolemy",
    "promissors": [
      "sun",
      "moon",
      "mercury",
      "venus",
      "mars"
    ],
    "significators": [
      "asc",
      "mc",
      "sun",
      "moon"
    ],
    "aspects": [
      "conjunction",
      "sextile",
      "square",
      "trine",
      "opposition"
    ],
    "orb_years": 1,
    "include_natal_reference": false
  },
  "range": {
    "start_date": "2026-01-01",
    "end_date": "2030-12-31",
    "limit": 20
  }
}'

Ptolémée, Naibod ou clé personnalisée

Pour cette technique, utilisez key=ptolemy. Cette clé vaut exactement 1.0 degré par an.

key=naibod est proche, mais différente : cette clé utilise l’arc solaire moyen, soit environ 0,9856 degré par an. Choisissez-la uniquement si vous souhaitez appliquer la clé de Naibod.

Vous pouvez aussi exprimer explicitement cette clé fixe avec une clé personnalisée :

{
  "settings": {
    "method": "zodiacal",
    "direction": "direct",
    "key": "custom",
    "custom_key_deg_per_year": 1.0
  }
}

Variante calendrier

Utilisez la route calendrier lorsque l’interface a besoin d’un flux compact de directions symboliques exactes. L’exemple de réponse ci-dessous est produit à partir de cette requête.

curl -X POST "https://api.freeastroapi.com/api/v1/western/directions/primary/calendar" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "natal": {
    "name": "Symbolic Directions 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": "zodiacal",
    "direction": "direct",
    "key": "ptolemy",
    "promissors": [
      "sun",
      "moon",
      "mercury",
      "venus",
      "mars"
    ],
    "significators": [
      "asc",
      "mc",
      "sun",
      "moon"
    ],
    "aspects": [
      "conjunction",
      "square",
      "trine",
      "opposition"
    ],
    "orb_years": 1,
    "include_natal_reference": false
  },
  "range": {
    "start_date": "2026-01-01",
    "end_date": "2026-12-31",
    "limit": 20
  }
}'

Champs de réponse à vérifier

Champ	Signification
meta.key_deg_per_year	Confirme la clé de direction appliquée. Ptolémée renvoie 1.0.
directions[].age_years	Âge au moment de la direction exacte, calculé par arc / clé.
directions[].arc_deg	Arc dirigé en degrés zodiacaux.
directions[].directed_longitude_deg	Longitude du prometteur après direction symbolique.
directions[].active_window	Fenêtre d’orbe autour de la direction exacte, définie par orb_years.

Requête réelle

Cette requête versionnée utilise un thème natal de Londres avec heure connue et la clé fixe de Ptolémée. Elle reprend le même corps que l’exemple cURL.

{
  "natal": {
    "name": "Symbolic Directions 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": "zodiacal",
    "direction": "direct",
    "key": "ptolemy",
    "promissors": [
      "sun",
      "moon",
      "mercury",
      "venus",
      "mars"
    ],
    "significators": [
      "asc",
      "mc",
      "sun",
      "moon"
    ],
    "aspects": [
      "conjunction",
      "sextile",
      "square",
      "trine",
      "opposition"
    ],
    "orb_years": 1,
    "include_natal_reference": false
  },
  "range": {
    "start_date": "2026-01-01",
    "end_date": "2030-12-31",
    "limit": 20
  }
}

Réponse réelle

Cette réponse a été produite par l’implémentation locale des directions primaires avec la requête ci-dessus. Elle confirme key_deg_per_year: 1 et renvoie les directions symboliques exactes.

{
  "meta": {
    "endpoint": "primary_directions",
    "version": "v1",
    "method": "zodiacal",
    "calculation_method": "zodiacal_ptolemy_key_symbolic_zodiacal",
    "zodiac_type": "tropical",
    "direction": "direct",
    "key": "ptolemy",
    "key_deg_per_year": 1,
    "range_start": "2026-01-01",
    "range_end": "2030-12-31",
    "generated_at": "2026-05-19T16:59:59.930337+00:00",
    "warnings": [
      "Zodiacal directions are symbolic arc directions unless a named zodiacal primary-direction method is selected."
    ]
  },
  "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"
    ],
    "significators": [
      "asc",
      "mc",
      "sun",
      "moon"
    ],
    "aspects": [
      "conjunction",
      "sextile",
      "square",
      "trine",
      "opposition"
    ],
    "orb_years": 1,
    "search_step_deg": 0.25,
    "secondary_motion": "none",
    "latitude_doctrine": "none",
    "bounds_system": "egyptian",
    "include_bounds": false,
    "include_bound_promissors": false,
    "include_antiscia": false,
    "include_contra_antiscia": false,
    "include_mundane_parallels": false
  },
  "directions": [
    {
      "id": "pd.direct.moon.square.mc.2026-08-13T18:47:00.430412Z",
      "date": "2026-08-13",
      "exact_datetime_utc": "2026-08-13T18:47:00.430412Z",
      "exact_datetime_local": "2026-08-13T19:47:00.430412+01:00",
      "age_years": 36.6148,
      "direction": "direct",
      "promissor": "moon",
      "significator": "mc",
      "aspect": {
        "name": "square",
        "angle_deg": 90
      },
      "arc_deg": 36.614835,
      "arc_group_id": "pdg.zodiacal.direct.moon.2026-08-13T18:47:00.430412Z.36.614835",
      "key": "ptolemy",
      "key_deg_per_year": 1,
      "promissor_natal_longitude_deg": 333.267655,
      "directed_longitude_deg": 9.88249,
      "significator_longitude_deg": 279.88249,
      "measurement": "zodiacal",
      "orb_years": 1,
      "active_window": {
        "from": "2025-08-13",
        "exact": "2026-08-13",
        "to": "2027-08-14",
        "from_datetime_utc": "2025-08-13T12:58:15.300812Z",
        "exact_datetime_utc": "2026-08-13T18:47:00.430412Z",
        "to_datetime_utc": "2027-08-14T00:35:45.560012Z",
        "from_datetime_local": "2025-08-13T13:58:15.300812+01:00",
        "exact_datetime_local": "2026-08-13T19:47:00.430412+01:00",
        "to_datetime_local": "2027-08-14T01:35:45.560012+01:00"
      },
      "interpretation_key": "primary_direction.direct.square.moon.mc"
    },
    {
      "id": "pd.direct.moon.square.sun.2027-07-20T02:30:41.783478Z",
      "date": "2027-07-20",
      "exact_datetime_utc": "2027-07-20T02:30:41.783478Z",
      "exact_datetime_local": "2027-07-20T03:30:41.783478+01:00",
      "age_years": 37.5466,
      "direction": "direct",
      "promissor": "moon",
      "significator": "sun",
      "aspect": {
        "name": "square",
        "angle_deg": 90
      },
      "arc_deg": 37.546606,
      "arc_group_id": "pdg.zodiacal.direct.moon.2027-07-20T02:30:41.783478Z.37.546606",
      "key": "ptolemy",
      "key_deg_per_year": 1,
      "promissor_natal_longitude_deg": 333.267655,
      "directed_longitude_deg": 10.814261,
      "significator_longitude_deg": 280.814261,
      "measurement": "zodiacal",
      "orb_years": 1,
      "active_window": {
        "from": "2026-07-19",
        "exact": "2027-07-20",
        "to": "2028-07-19",
        "from_datetime_utc": "2026-07-19T20:41:56.653878Z",
        "exact_datetime_utc": "2027-07-20T02:30:41.783478Z",
        "to_datetime_utc": "2028-07-19T08:19:26.913078Z",
        "from_datetime_local": "2026-07-19T21:41:56.653878+01:00",
        "exact_datetime_local": "2027-07-20T03:30:41.783478+01:00",
        "to_datetime_local": "2028-07-19T09:19:26.913078+01:00"
      },
      "interpretation_key": "primary_direction.direct.square.moon.sun"
    },
    {
      "id": "pd.direct.mercury.conjunction.moon.2027-08-06T17:13:33.433592Z",
      "date": "2027-08-06",
      "exact_datetime_utc": "2027-08-06T17:13:33.433592Z",
      "exact_datetime_local": "2027-08-06T18:13:33.433592+01:00",
      "age_years": 37.5948,
      "direction": "direct",
      "promissor": "mercury",
      "significator": "moon",
      "aspect": {
        "name": "conjunction",
        "angle_deg": 0
      },
      "arc_deg": 37.594829,
      "arc_group_id": "pdg.zodiacal.direct.mercury.2027-08-06T17:13:33.433592Z.37.594829",
      "key": "ptolemy",
      "key_deg_per_year": 1,
      "promissor_natal_longitude_deg": 295.672825,
      "directed_longitude_deg": 333.267655,
      "significator_longitude_deg": 333.267655,
      "measurement": "zodiacal",
      "orb_years": 1,
      "active_window": {
        "from": "2026-08-06",
        "exact": "2027-08-06",
        "to": "2028-08-05",
        "from_datetime_utc": "2026-08-06T11:24:48.303992Z",
        "exact_datetime_utc": "2027-08-06T17:13:33.433592Z",
        "to_datetime_utc": "2028-08-05T23:02:18.563192Z",
        "from_datetime_local": "2026-08-06T12:24:48.303992+01:00",
        "exact_datetime_local": "2027-08-06T18:13:33.433592+01:00",
        "to_datetime_local": "2028-08-06T00:02:18.563192+01:00"
      },
      "interpretation_key": "primary_direction.direct.conjunction.mercury.moon"
    }
  ]
}

Réponse réelle du calendrier

Ce flux compact d’événements est produit à partir de la requête calendrier ci-dessus et convient aux interfaces chronologiques ou d’alertes.

{
  "meta": {
    "endpoint": "primary_directions",
    "version": "v1",
    "method": "zodiacal",
    "calculation_method": "zodiacal_ptolemy_key_symbolic_zodiacal",
    "zodiac_type": "tropical",
    "direction": "direct",
    "key": "ptolemy",
    "key_deg_per_year": 1,
    "range_start": "2026-01-01",
    "range_end": "2026-12-31",
    "generated_at": "2026-05-19T16:59:59.931677+00:00",
    "warnings": [
      "Zodiacal directions are symbolic arc directions unless a named zodiacal primary-direction method is selected."
    ]
  },
  "events": [
    {
      "date": "2026-08-13",
      "exact_datetime_utc": "2026-08-13T18:47:00.430412Z",
      "exact_datetime_local": "2026-08-13T19:47:00.430412+01:00",
      "type": "primary_direction",
      "title": "Moon direct square Midheaven",
      "direction_id": "pd.direct.moon.square.mc.2026-08-13T18:47:00.430412Z",
      "interpretation_key": "primary_direction.direct.square.moon.mc"
    }
  ]
}

Note pour les astrologues

Cette page décrit le calcul des dates de directions symboliques à un degré par an. Si vous souhaitez un thème complet où chaque planète, angle et cuspide avance visiblement du même arc, utilisez cet endpoint pour les dates et consultez la documentation du système Quotidiennes pour la réponse de thème fondée sur un arc. Le système quotidien utilise un arc solaire et n’est donc pas identique à la clé fixe de Ptolémée.

Directions primaires

Toutes les options de directions classiques et symboliques.

Progressions

Thèmes secondaires, secondaires converses, tertiaires, quotidiens et quaternaires.