API biểu đồ sinh
Chuyển một khoảnh khắc sinh thành một biểu đồ sinh đầy đủ, có cấu trúc - các hành tinh, điểm đầu nhà, khía cạnh và dữ liệu góc - trong một POST duy nhất. Cung hoàng đạo nhiệt đới, mười ba hệ thống nhà, độ chính xác Swiss Ephemeris, xuất JSON.
API biểu đồ sinh
Endpoint natal-chart tính ngày sinh, giờ đồng hồ và chênh lệch UTC thành ngày Julian chính xác, sau đó yêu cầu engine Swiss Ephemeris cung cấp kinh độ, vĩ độ và tốc độ địa tâm của mọi thiên thể - mười hành tinh cổ điển cộng nút mặt trăng, Chiron và Black Moon Lilith. Nó suy ra Ascendant và Midheaven từ vĩ độ và kinh độ sinh, chia các nhà theo hệ thống bạn chọn, gán mỗi hành tinh vào cung và nhà của nó, và tính toàn bộ lưới khía cạnh với cờ applying/separating và các orb chính xác. Chuyển động lùi được đánh dấu từ tốc độ của thiên thể, và chart sect (sinh ngày hay đêm) được trả về để việc giải thích sau này có thể cân nhắc đúng benefics và malefics.
POST/v1/chart
curl -X POST https://api.astroway.info/v1/chart \
-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,
"houseSystem": "P"
}'{
"ok": true,
"data": {
"planets": [
{ "name": "Sun", "longitude": 54.23, "sign": "Taurus", "house": 10, "retrograde": false },
{ "name": "Moon", "longitude": 282.7, "sign": "Capricorn", "house": 6 }
],
"houses": { "ascendant": 160.4, "mc": 70.1, "cusps": [160.4, 190.3, ...] },
"aspects": [ { "body1": "Sun", "body2": "Moon", "type": "trine", "orb": 1.2 } ]
}
}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). |
| houseSystem | string | no | One-letter Swiss Ephemeris code - P (Placidus, default), K (Koch), W (whole-sign), R (Regiomontanus), and 10 more. |
When to use it
Hãy dùng endpoint này mỗi khi bạn cần khung cấu trúc của một lá số tử vi: widget biểu đồ sinh, báo cáo natal, luồng onboarding cá nhân hoá nội dung theo Sun/Moon/Rising, hoặc một AI agent cần vị trí thô trước khi giải thích. Đây là lời gọi tiền đề cho synastry, transits, progressions và hầu hết các loại báo cáo - tính biểu đồ một lần, lưu cache JSON, và đưa vào các endpoint nặng hơn thay vì tính lại mỗi lần. Vì phản hồi chỉ là dữ liệu thuần (không có văn bản, không có hình ảnh), nó dễ dàng tích hợp vào bất kỳ stack nào: tự render, chuyển cho LLM, hoặc đưa cho một trong các endpoint render SVG của chúng tôi.
Notes
Mặc định tuân theo chuẩn Tây phương phổ biến: cung hoàng đạo nhiệt đới, nhà Placidus, "Ba lớn" Sun–Moon–Ascendant. Engine là Swiss Ephemeris (Astrodienst) và chia sẻ với công cụ tính trong trình duyệt, vì vậy server và client đồng ý tới độ giây cung. Khi Placidus không xác định ở vùng cực, các nhà sẽ quay lại Porphyry.
Try the Biểu đồ sinh API
Grab a key and make your first call in under a minute.