Solar Return API
Tạo biểu đồ cho khoảnh khắc chính xác khi Mặt Trời quay lại độ sinh của nó trong năm bạn chọn – sinh nhật chiêm tinh. Đưa vào biểu đồ sinh và một năm, nhận biểu đồ solar return cho chu kỳ đó. Đúng tropic, Sun-to-natal-Sun, độ chính xác Swiss Ephemeris, xuất JSON.
Solar Return API
Endpoint solar-return đầu tiên đọc độ kinh độ hoàng đạo chính xác của Mặt Trời sinh từ dữ liệu sinh đã cung cấp, sau đó tìm trong năm cho trước thời điểm chính xác khi Mặt Trời chuyển động trở lại cùng độ kinh độ – thường trong vòng một ngày so với sinh nhật dương lịch. Nó chuyển thời điểm trả về thành ngày Julian, lấy vị trí và tốc độ địa tâm từ engine Swiss Ephemeris, và tạo một biểu đồ đầy đủ: các hành tinh trả về với cung và vị trí trong nhà, các đỉnh nhà, và lưới khía cạnh đầy đủ với cờ đang áp dụng và tách ra và các quỹ đạo chính xác. Khớp là tropical và Sun-to-natal-Sun, không được precession-corrected mặc định, nên Mặt Trời trả về nằm trên độ tropical của Mặt Trời sinh. Biểu đồ kết quả được đọc như bản đồ chủ đề thống trị cho năm từ sinh nhật này tới sinh nhật kế.
POST/v1/solar-return
curl -X POST https://api.astroway.info/v1/solar-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,
"year": 2026
}'{
"ok": true,
"data": {
"input": {},
"planets": [
{
"name": "Sun",
"longitude": 54.23,
"sign": "Taurus",
"house": 9
}
],
"houses": {
"ascendant": 188.2,
"mc": 95,
"cusps": [
"…"
]
},
"aspects": [
"…"
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| 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). |
| year | number | yes | Required integer year in which to find the Sun's return to its natal longitude. |
When to use it
Sử dụng solar return để dự báo hàng năm – báo cáo 'năm tới', tính năng biểu đồ sinh nhật, hoặc luồng AI tạo dự báo 12 tháng từ một biểu đồ có ngày. Nó là công cụ chính của dự đoán dựa trên return: các góc, nhà mà Mặt Trời return rơi vào, và các khía cạnh chặt nhất được đọc như chủ đề tiêu đề cho năm solar đó. Kết hợp với transits và progressions để sâu hơn, nhưng solar return một mình cung cấp một bức tranh năm sạch sẽ, tự chứa, dựa trên sinh nhật của người thay vì lịch. Vì bạn chỉ đưa dữ liệu sinh và một năm, nó vừa vặn với trigger kỷ niệm và email hàng năm đã lên lịch – tính lại mỗi năm để đẩy dự báo lên phía trước.
Notes
Return được khớp tropic, Sun to natal Sun, và không được precession-corrected mặc định, vì vậy nó phản ánh solar return phương Tây truyền thống hơn là biến thể đã hiệu chỉnh sidereal. Nó được tạo cho vị trí sinh đã cung cấp; solar return di chuyển sẽ cần tạo lại ở nơi khác. Cung tropical và Swiss Ephemeris suốt quá trình.
Try the Solar Return API
Grab a key and make your first call in under a minute.