Перейти к основному содержимому
Occult API
POST/api/astro/retrograde/1 кредит

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

Все периоды ретроградности за год в одном небольшом ответе. Ретроградное движение, или вакри, — это видимое попятное смещение планеты на фоне звёзд; в астрологической практике такие интервалы считаются особой фазой в поведении планеты. Передайте только `year`. Ответ — `data.planets`: объект с ключами по названиям планет, в каждом — список меток `{start, end}` в UTC. Периоды, переходящие через границу года, обрезаются по 1 января и 31 декабря, так что окно, начинающееся в `01-01 00:00:00`, на самом деле началось в предыдущем году. Если планета в этом году ни разу не становится ретроградной, её список пуст. Возвращается десять ключей: mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, rahu и ketu. Солнца и Луны в списке нет: с Земли они никогда не бывают ретроградными. Раху и Кету рассчитываются по среднему лунному узлу, который весь год равномерно движется назад без стационарных точек, поэтому у обоих всегда одно окно на весь год; с истинным узлом получились бы десятки ложных записей длиной в несколько дней. Чтобы найти момент стационарной точки, сначала определяется день, когда скорость по долготе меняет знак, затем момент уточняется внутри этого дня; погрешность значительно меньше минуты. Те же данные есть в `/api/planetary_details/` вместе с восемью другими расчётами, а этот эндпоинт возвращает только ретроградность.

https://api.occultapi.com/api/astro/retrograde/
Попробовать запрос
«Периоды ретроградности» — результат в интерфейсе
Данные этого эндпоинта в живом интерфейсе. API отдаёт значения, а внешний вид вы делаете сами.

Аутентификация

Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запроса

ПолеТипОбязательноПримечания
yearintegerобязательный

Год рождения числом, например 1990. Четыре цифры.

min 1800 · max 2400

Пример запроса

curl -X POST https://api.occultapi.com/api/astro/retrograde/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

Ответ

{
  "data": {
    "year": 2026,
    "planets": {
      "mercury": [
        {
          "start": "2026-02-26 06:47:34",
          "end": "2026-03-20 19:33:02"
        },
        {
          "start": "2026-06-29 17:34:35",
          "end": "2026-07-23 22:58:49"
        },
        {
          "start": "2026-10-24 07:12:44",
          "end": "2026-11-13 15:54:27"
        }
      ],
      "venus": [
        {
          "start": "2026-10-03 07:13:14",
          "end": "2026-11-14 00:29:50"
        }
      ],
      "mars": [],
      "jupiter": [
        {
          "start": "2026-01-01 00:00:00",
          "end": "2026-03-11 03:53:41"
        },
        {
          "start": "2026-12-13 00:30:39",
          "end": "2026-12-31 00:00:00"
        }
      ],
      "saturn": [
        {
          "start": "2026-07-26 18:57:26",
          "end": "2026-12-11 00:30:23"
        }
      ],
      "uranus": [
        {
          "start": "2026-01-01 00:00:00",
          "end": "2026-02-04 02:56:33"
        },
        {
          "start": "2026-09-10 18:24:34",
          "end": "2026-12-31 00:00:00"
        }
      ],
      "neptune": [
        {
          "start": "2026-07-07 09:57:49",
          "end": "2026-12-13 00:46:51"
        }
      ],
      "pluto": [
        {
          "start": "2026-05-06 12:13:55",
          "end": "2026-10-16 05:33:46"
        }
      ],
      "rahu": [
        {
          "start": "2026-01-01 00:00:00",
          "end": "2026-12-31 00:00:00"
        }
      ],
      "ketu": [
        {
          "start": "2026-01-01 00:00:00",
          "end": "2026-12-31 00:00:00"
        }
      ]
    }
  },
  "message": "successful",
  "is_error": false
}

Записано с реального вызова ровно с этим запросом. Результаты лежат в data.

Ошибки

Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.