Периоды ретроградности

Расчёт периодов ретроградности планет в указанном диапазоне дат, включая теневые периоды до и после ретроградности.

Необходимый модуль

Требуется модуль retrograde:calc.

Расчёт периодов ретроградности

curl -X POST "https://api.astroapi.cloud/api/calc/retrograde" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2024-01-01",
    "endDate": "2024-12-31",
    "points": ["mercury", "venus", "mars"]
  }'

Параметры

Параметр	Тип	Обязателен	Описание
startDate	string	Да	Начальная дата в формате YYYY-MM-DD
endDate	string	Да	Конечная дата в формате YYYY-MM-DD
points	array	Нет	Планеты для расчёта периодов ретроградности (см. значения по умолчанию ниже)

Точки по умолчанию

Если points не указан, периоды ретроградности рассчитываются для всех стандартных внешних и внутренних планет:

mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, chiron

Диапазон дат

Более длинные диапазоны дат будут включать больше периодов ретроградности, но могут требовать несколько большего времени для расчёта. Строгих ограничений по диапазону дат нет, однако типичными являются диапазоны в один или два года.

Ответ

{
    "data": {
        "dateRange": {
            "startDate": "2024-01-01",
            "endDate": "2024-12-31"
        },
        "periodsByPoint": {
            "mercury": [
                {
                    "retrogradeStation": {
                        "date": "2024-04-01T15:14:00Z",
                        "longitude": 27.3,
                        "sign": "aries",
                        "degreesInSign": 27.3
                    },
                    "directStation": {
                        "date": "2024-04-25T08:54:00Z",
                        "longitude": 15.6,
                        "sign": "aries",
                        "degreesInSign": 15.6
                    },
                    "durationDays": 24,
                    "signsTraversed": ["aries"],
                    "preRetrogradeShadow": {
                        "startDate": "2024-03-18T00:00:00Z",
                        "endDate": "2024-04-01T15:14:00Z",
                        "durationDays": 14
                    },
                    "postRetrogradeShadow": {
                        "startDate": "2024-04-25T08:54:00Z",
                        "endDate": "2024-05-13T00:00:00Z",
                        "durationDays": 18
                    }
                }
            ],
            "mars": [
                {
                    "retrogradeStation": {
                        "date": "2024-12-06T09:33:00Z",
                        "longitude": 86.0,
                        "sign": "gemini",
                        "degreesInSign": 6.0
                    },
                    "directStation": {
                        "date": "2025-02-23T22:00:00Z",
                        "longitude": 47.2,
                        "sign": "cancer",
                        "degreesInSign": 17.2
                    },
                    "durationDays": 79,
                    "signsTraversed": ["gemini", "cancer"],
                    "preRetrogradeShadow": {
                        "startDate": "2024-10-26T00:00:00Z",
                        "endDate": "2024-12-06T09:33:00Z",
                        "durationDays": 41
                    },
                    "postRetrogradeShadow": {
                        "startDate": "2025-02-23T22:00:00Z",
                        "endDate": "2025-05-01T00:00:00Z",
                        "durationDays": 66
                    }
                }
            ]
        },
        "periods": [
            {
                "point": "mercury",
                "retrogradeStation": {
                    "date": "2024-04-01T15:14:00Z",
                    "longitude": 27.3,
                    "sign": "aries",
                    "degreesInSign": 27.3
                },
                "directStation": {
                    "date": "2024-04-25T08:54:00Z",
                    "longitude": 15.6,
                    "sign": "aries",
                    "degreesInSign": 15.6
                },
                "durationDays": 24,
                "signsTraversed": ["aries"],
                "preRetrogradeShadow": {
                    "startDate": "2024-03-18T00:00:00Z",
                    "endDate": "2024-04-01T15:14:00Z",
                    "durationDays": 14
                },
                "postRetrogradeShadow": {
                    "startDate": "2024-04-25T08:54:00Z",
                    "endDate": "2024-05-13T00:00:00Z",
                    "durationDays": 18
                }
            }
        ]
    }
}

Поля ответа

Поле	Тип	Описание
dateRange	object	Начальная и конечная даты запрошенного диапазона
periodsByPoint	object	Периоды ретроградности, сгруппированные по названию планеты
periods	array	Все периоды ретроградности в хронологическом порядке

Объект RetrogradePeriod

Поле	Тип	Описание
retrogradeStation	object	Данные о моменте перехода планеты в ретроградное движение
directStation	object	Данные о моменте перехода планеты в прямое движение
durationDays	number	Продолжительность периода ретроградности в днях
signsTraversed	array	Знаки зодиака, через которые проходит планета в период ретроградности
preRetrogradeShadow	object	Теневой период до начала ретроградности
postRetrogradeShadow	object	Теневой период после перехода планеты в прямое движение

Объект Station

Поле	Тип	Описание
date	string	Временная метка UTC момента станции
longitude	number	Эклиптическая долгота (0–360) в момент станции
sign	string	Знак зодиака в момент станции
degreesInSign	number	Градус в пределах знака (0–30)

Объект Shadow Period

Поле	Тип	Описание
startDate	string	Начало теневого периода (UTC)
endDate	string	Конец теневого периода (UTC)
durationDays	number	Продолжительность теневого периода в днях

Пояснение теневых периодов

Каждая ретроградность имеет два теневых периода:

• Теневой период до ретроградности: начинается, когда планета впервые достигает градуса, на котором впоследствии перейдёт в прямое движение. Планета «предварительно просматривает» территорию, которую позже пересмотрит.
• Теневой период после ретроградности: заканчивается, когда планета возвращается к градусу, где она впервые перешла в ретроградное движение. Планета завершает пересмотр зоны ретроградности.

Планирование с учётом теневых периодов

Многие астрологи советуют соблюдать осторожность не только во время самой ретроградности, но и в оба теневых периода. Полный цикл ретроградности — предтеневой период, ретроградность, послетеневой период — является полным периодом пересмотра тем данной планеты.

Типичная частота ретроградности

Планета	Частота	Продолжительность
Меркурий	3–4 раза в год	~3 недели
Венера	Раз в ~18 месяцев	~6 недель
Марс	Раз в ~2 года	~2–3 месяца
Юпитер	Раз в год	~4 месяца
Сатурн	Раз в год	~4,5 месяца
Уран	Раз в год	~5 месяцев
Нептун	Раз в год	~5 месяцев
Плутон	Раз в год	~5–6 месяцев
Хирон	Раз в год	~5 месяцев