Склонения
Натальная карта — это проекция на эклиптику, и эта проекция отбрасывает одну ось. Склонение — это то, что остаётся, когда те же тела измеряются от небесного экватора: вторая таблица печатной эфемериды и координата, которой нет ни в одной сетке аспектов.
На этой оси живут две вещи, и ни одна из них не видна в зодиакальной карте:
- Параллели и контрпараллели. Два тела с одинаковым склонением образуют параллель, которая работает как соединение. Такое же расстояние от экватора по разные стороны — это контрпараллель, работающая как оппозиция. И то и другое может возникать между телами, не образующими в долготе никакого аспекта.
- Вне границ (out of bounds). Тело за пределами максимального склонения самого Солнца. Луна бывает такой несколько дней в месяц вблизи большого лунного стояния; Меркурий, Венера, Марс и Плутон — с интервалами. Это реальное и широко обсуждаемое состояние, и почти никакое потребительское ПО о нём не сообщает.
Необходимый модуль
Обе конечные точки требуют модуль declination:calc. Он входит во все тарифы и отдельно не продаётся.
Склонения на момент
curl -X POST "https://api.astroapi.cloud/api/calc/declination" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"dateTime": "1990-06-15T14:30",
"location": {
"latitude": 52.37,
"longitude": 4.89,
"timezone": "Europe/Amsterdam"
},
"orb": 1
}'Параметры
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
dateTime | string | Да | YYYY-MM-DDTHH:mm, местное время в location |
location | object | Да | latitude, longitude и часовой пояс IANA в timezone |
points | array | Нет | Точки для расчёта. По умолчанию десять тел, оба узла и обе Лилит |
orb | number | Нет | Орбис для параллелей и контрпараллелей, от 0 до 3 градусов. По умолчанию 1 |
moonCenter | string | Нет | topocentric (по умолчанию) или geocentric |
Орбис здесь — не орбис там
Орбис склонения значительно уже орбиса долготы. Один градус — общепринятая величина и значение по умолчанию; за двумя градусами почти всё чему-нибудь параллельно.
Ответ
{
"data": {
"dateTime": "1990-06-15T12:30:00.000Z",
"points": {
"sun": {
"pointId": "sun",
"declination": 23.32,
"declinationDms": [23, 19, 12],
"rightAscension": 84.1,
"latitude": 0,
"speedDeclination": 0.04,
"outOfBounds": false,
"hemisphere": "north"
},
"moon": {
"pointId": "moon",
"declination": -18.44,
"declinationDms": [18, 26, 24],
"rightAscension": 312.7,
"latitude": -4.61,
"speedDeclination": -3.1,
"outOfBounds": false,
"hemisphere": "south"
}
},
"aspects": [
{
"pointA": "venus",
"pointB": "mars",
"aspect": "parallel",
"orb": 0.31,
"applying": true,
"declinationA": 21.08,
"declinationB": 21.39
}
],
"extremes": {
"northernmost": "sun",
"southernmost": "moon",
"outOfBoundsCount": 0
},
"obliquity": 23.4405
}
}declinationDms — это величина в виде [градусы, минуты, секунды]; сторона указана в hemisphere и в знаке declination. speedDeclination — градусы в сутки, отрицательное значение означает движение к югу: именно это показывает, сходится параллель или расходится, тот же вопрос, на который для аспекта в долготе отвечает applying.
Граница «вне границ»
obliquity — истинный наклон эклиптики на запрошенную дату, то есть максимальное склонение самого Солнца и, следовательно, граница, относительно которой вычислен outOfBounds. Она возвращается, чтобы клиент мог нарисовать полосу, не выдумывая собственный предел.
Общепринятая величина — 23°26'. Настоящая же смещается: нутация сдвигает её до девяти угловых секунд, и этого достаточно, чтобы решить пограничный случай в ту или иную сторону. Сравнение с возвращённым obliquity и сравнение с жёстко заданным 23.4367 дадут разные ответы для тела ровно на линии.
Солнце никогда не бывает вне границ
По определению: условие — «за пределами Солнца». Тело точно на границе не находится вне границ; оно должно быть за ней.
Склонение на протяжении периода
Вторая половина и причина, по которой это отдельная конечная точка, а не поле натальной карты: график склонения — это ряд во времени, а даты, когда тело пересекает границу «вне границ», — это то, что астролог действительно записывает.
curl -X POST "https://api.astroapi.cloud/api/calc/declination/series" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"startDate": "2025-01-01",
"endDate": "2025-12-31",
"stepDays": 2,
"points": ["sun", "moon", "mercury", "venus", "mars", "pluto"]
}'Параметры
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
startDate | string | Да | YYYY-MM-DD или ISO 8601 |
endDate | string | Да | YYYY-MM-DD или ISO 8601 |
stepDays | number | Нет | Дней между точками ряда, от 0,25 до 30. По умолчанию 1 |
points | array | Нет | Точки для построения. Значения по умолчанию как выше |
Ответ
{
"data": {
"startDate": "2025-01-01T00:00:00.000Z",
"endDate": "2025-12-31T23:59:00.000Z",
"stepDays": 2,
"points": ["sun", "moon", "mercury", "venus", "mars", "pluto"],
"series": {
"moon": [
["2025-01-01T00:00:00.000Z", -14.02],
["2025-01-03T00:00:00.000Z", 8.71]
]
},
"crossings": [
{
"pointId": "moon",
"date": "2025-03-06T07:41:12.000Z",
"direction": "out",
"declination": 23.4392
},
{
"pointId": "moon",
"date": "2025-03-10T02:18:55.000Z",
"direction": "in",
"declination": 23.4392
}
]
}
}Пересечения не дискретизируются с шагом stepDays
Выход Луны за границу длится пару дней. Ряд, построенный с недельным шагом, просто перешагнул бы через него — поэтому пересечения ищутся на сетке более мелкой, чем та, с которой возвращается ряд, и каждое затем уточняется по эфемериде до секунды.
Практическое следствие: широкий stepDays стоит вам формы кривой, но никогда — даты пересечения. Запрашивайте то разрешение, которое нужно графику, и не больше.
Ограничение ряда
Ряд ограничен 400 точками. Год с суточным шагом — это 365; десятилетие с суточным шагом — 3653, и оно возвращается как 400 с советом увеличить шаг:
{
"error": "That range at a 1-day step is 3654 points; the limit is 400. Widen stepDays or shorten the range."
}В любом случае это один запрос. Построить ту же таблицу из 400 отдельных вызовов стоит 400 запросов из вашей месячной квоты; конечная точка ряда вычисляет их за один проход и считается за один.
Склонение в натальной карте
Начиная с версии API 2026-09-10 каждая точка ответа натальной карты также несёт declination и outOfBounds, так что колесо может отметить тело вне границ без второго вызова:
curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
-H "X-Api-Key: your-api-key" \
-H "X-Api-Version: 2026-09-10" \
-H "Content-Type: application/json" \
-d '{ "dateTime": "1990-06-15T14:30", "location": { "latitude": 52.37, "longitude": 4.89, "timezone": "Europe/Amsterdam" } }'Клиент на более старой версии сохраняет ту форму ответа, которую всегда получал. О том, как закрепить версию, см. Версионирование API.
Натальный ответ несёт только эти два поля. Параллели, контрпараллели, прямое восхождение, скорость склонения и ряд — всё это на конечных точках выше.
Чем это не является
Здесь нет трёхмерного вида, и это сделано намеренно. Правильное изображение склонения — линия относительно оси; небесная сфера делает картинку красивее, но не понятнее.