AstroWay/api v2.201.7 · ko
모든 시스템 정상 작동 중
// astrology api · POST /v1/lunar-return

월귀환 API

선택한 날짜 이후에 달이 출생 경도로 돌아오는 다음 순간을 찾고(약 27.3일마다) 선택한 위치에서 차트를 작성하세요. 출생 데이터와 시작 날짜를 전달하여 월귀환 차트를 얻으세요. 스위스 에페메리스 정밀도, JSON 출력.

Endpoint
POST /v1/lunar-return
Cost
50 credits
Latency
~62 ms
Tier
Tier 3
// 01 / What it computes

월귀환 API

월귀환 엔드포인트는 제공된 출생 데이터에서 출생 달의 정확한 경도를 읽고, 주어진 시작 날짜에서부터 출달이 동일한 경도로 돌아오는 첫 순간을 찾습니다. 달이 약 27.3일에 항성 주기를 완성하기 때문에 이 귀환은 약 한 달에 한 번 발생합니다. 엔드포인트는 일치하는 순간을 율리우스일로 변환하고, 스위스 에페메리스 엔진에서 지심좌표와 속도를 가져와 전체 차트를 작성합니다 - 별자리와 하위 배치가 있는 귀환 행성, 하위 경계, 그리고 적용 및 분리 플래그와 정확한 궤도를 포함하는 완전한 측면 그리드. 기본적으로 차트는 출생지에서 작성되지만, 다른 위도와 경도를 제공하여 귀환을 재배치할 수 있으며, 이는 동일한 귀환 순간을 유지하면서 각도와 하위를 재구성합니다. 결과는 다음 달의 감정적이고 리듬감 있는 주제 지도로 읽힙니다.

// 02 / Live request

POST/v1/lunar-return

curl -X POST https://api.astroway.info/v1/lunar-return \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "afterDate": "2026-06-15"
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "input": {},
    "planets": [
      {
        "name": "Moon",
        "longitude": 282.7,
        "sign": "Capricorn",
        "house": 6
      }
    ],
    "houses": {
      "ascendant": 201.5,
      "mc": 110.3,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      "…"
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Birth date.
time string (HH:MM:SS) yes Local clock time at birth.
timezoneOffset number (hours) yes UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones.
latitude number yes Birth-place latitude, decimal degrees (north positive).
longitude number yes Birth-place longitude, decimal degrees (east positive).
afterDate string (YYYY-MM-DD) yes Required start date (YYYY-MM-DD); the endpoint finds the first lunar return on or after it.
afterTime string (HH:MM:SS) no Optional clock time of the start point (HH:MM:SS).
afterTzOffset number (hours) no Optional UTC offset for the start point, in hours.
locationLat number no Optional latitude in decimal degrees to relocate the return chart, north positive.
locationLng number no Optional longitude in decimal degrees to relocate the return chart, east positive.
// 04 / When to use it

When to use it

단기 주기의 약 한 달간 예측에 월귀환을 사용하세요 - '한 달 앞' 기능, 감정적 리듬 추적기, 또는 연간 태양귀환의 더 세밀한 동반자로서. 태양귀환이 한 해를 프레임으로 잡는 반면, 월귀환은 다음 너희 주간을 프레임으로 잡아, 반복되는 월간 보고서와 습관 또는 기분 주기에 적합합니다. 시작 날짜를 다음 귀환을 원하는 지점으로 전달하세요 - 보통 오늘 또는 마지막 귀환의 날짜 - 그러면 엔드포인트가 다음 귀환으로 전진합니다. 선택적 위치 재설정은 사람이 실제로 있는 곳에서 귀환을 작성할 수 있게 하여 출생지가 아닌, 이는 각도에 민감한 하위에 중요합니다. 연속적인 호출을 연결하여 월간 차트의 롤링 시퀀스를 구축하세요.

// 05 / Notes

Notes

엔드포인트는 주어진 날짜 이후의 다음 단일 귀환을 반환하며, 시리즈가 아닙니다 - 시퀀스를 구축하려면 시작 날짜를 진행시키며 반복적으로 호출하세요. ~27.3일은 항성월이므로 귀환이 달력에 대해 점점 밀려납니다. 위치가 제공되지 않으면 차트는 출생지에서 작성됩니다; 재설정은 각도와 하위만 재배치합니다. 전체적으로 열대 황도와 스위스 에페메리스를 사용합니다.

Try the 월귀환 API

Grab a key and make your first call in under a minute.

99.9% SLA · 유료 플랜 · 30일 상태 →