AstroWay/api v2.201.6 · vi
tất cả hệ thống hoạt động bình thường
// astrology api · POST /v1/lunar-return

API Trăng Trở về

Tìm thời điểm tiếp theo Mặt Trăng trở về kinh độ sinh của nó vào hoặc sau một ngày được chọn - khoảng mỗi 27.3 ngày - và tạo biểu đồ cho nó tại một vị trí bạn chọn. Truyền dữ liệu sinh và ngày bắt đầu, nhận biểu đồ Trăng Trở về. Độ chính xác Swiss Ephemeris, JSON ra.

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

API Trăng Trở về

Điểm cuối Trăng Trở về đọc kinh độ chính xác của Mặt Trăng sinh từ dữ liệu sinh được cung cấp, sau đó tìm kiếm từ ngày bắt đầu đã cho để tìm thời điểm đầu tiên Mặt Trăng di chuyển trở lại cùng kinh độ đó. Vì Mặt Trăng hoàn thành một chu kỳ sideral trong khoảng 27.3 ngày, lần trở về đó xảy ra hàng tháng. Điểm cuối giải quyết thời điểm khớp thành một ngày Julian, lấy vị trí và tốc độ địa tâm từ động lực Swiss Ephemeris, và tạo một biểu đồ đầy đủ cho nó - các hành tinh trở về với vị trí cung và nhà, các đỉnh nhà, và lưới khía cạnh hoàn chỉnh với các cờ áp dụng và tách biệt và độ chính xác. Theo mặc định, biểu đồ được tạo cho nơi sinh, nhưng bạn có thể cung cấp vĩ độ và kinh độ vị trí khác để di chuyển lại lần trở về, điều đó định hình lại các góc và nhà trong khi giữ cùng thời điểm trở về. Kết quả đọc như bản đồ chủ đề cảm xúc và nhịp điệu cho tháng trăng tiếp theo.

// 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

Sử dụng Trăng Trở về cho dự báo chu kỳ ngắn, khoảng hàng tháng - một tính năng 'tháng trăng trước', theo dõi nhịp điệu cảm xúc, hoặc người bạn đồng hành chi tiết hơn với Trăng Trở về hàng năm. Trong khi Trăng Trở về hàng năm khung cho cả một năm, Trăng Trở về khung cho bốn tuần tiếp theo, làm cho nó rất phù hợp với các báo cáo hàng tháng lặp lại và chu kỳ thói quen hoặc tâm trạng. Truyền ngày bắt đầu như điểm bạn muốn lần trở về tiếp theo sau - thường là hôm nay, hoặc ngày của lần trở về cuối cùng - và điểm cuối đi tiếp đến lần tiếp theo. Việc ghi đè vị trí tùy chọn cho phép bạn tạo biểu đồ trở về cho bất cứ nơi nào người đó thực sự trong tháng đó thay vì nơi sinh của họ, điều này quan trọng đối với các nhạy cảm góc độ. Liên tiếp các cuộc gọi để xây dựng một chuỗi biểu đồ hàng tháng.

// 05 / Notes

Notes

Điểm cuối trả về lần trở về tiếp theo đơn lẻ vào hoặc sau ngày được cung cấp, không phải một chuỗi - gọi lặp lại, tiến ngày bắt đầu, để xây dựng một chuỗi. Con số ~27.3 ngày là tháng sideral, vì vậy các lần trở về trôi so với lịch. Nếu không có vị trí được cung cấp, biểu đồ được tạo tại nơi sinh; một ghi đệch chỉ di chuyển lại các góc và nhà. Cung hoàng đạo nhiệt đới và Swiss Ephemeris xuyên suốt.

Try the Trăng Trở về API

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

99,9% SLA · gói trả phí · 30 ngày trạng thái →