逆行周期
计算指定日期范围内行星的逆行周期，包括逆行前阴影期和逆行后阴影期。
所需模块
需要 retrograde:calc 模块。
计算逆行周期
bash
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
日期范围
更长的日期范围将包含更多逆行周期，但计算时间可能略长。日期范围没有严格限制，但通常使用一至两年的范围。
响应
json
{
"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） |
ShadowPeriod 对象
| 字段 | 类型 | 描述 |
|---|---|---|
startDate | string | 阴影期的 UTC 开始时间 |
endDate | string | 阴影期的 UTC 结束时间 |
durationDays | number | 阴影期的天数 |
阴影期说明
每次逆行都有两个阴影期：
- 逆行前阴影期：行星首次到达它最终顺行度数时开始。行星"预演"它之后将重新经过的区域。
- 逆行后阴影期：行星返回到它首次逆行停滞度数时结束。行星正在完成对逆行区域的审查。
结合阴影期规划
许多占星师建议不仅在逆行期间保持谨慎，在两个阴影期内也要如此。完整的逆行周期——前阴影、逆行、后阴影——是该行星主题的完整审查期。
典型逆行频率
| 行星 | 频率 | 持续时间 |
|---|---|---|
| 水星 | 每年 3–4 次 | 约 3 周 |
| 金星 | 约每 18 个月一次 | 约 6 周 |
| 火星 | 约每 2 年一次 | 约 2–3 个月 |
| 木星 | 每年一次 | 约 4 个月 |
| 土星 | 每年一次 | 约 4.5 个月 |
| 天王星 | 每年一次 | 约 5 个月 |
| 海王星 | 每年一次 | 约 5 个月 |
| 冥王星 | 每年一次 | 约 5–6 个月 |
| 凯龙星 | 每年一次 | 约 5 个月 |