Lịch sinh

Điểm cuối POST /v1/chart là nền tảng cho hầu hết các yêu cầu. Nó trả về bản đồ natal đầy đủ: vị trí của các hành tinh, điểm giao hội của các nhà, khía cạnh giữa các hành tinh, sect của bản đồ. Chi phí: 20 tín dụng (Tier 2).

Tham số yêu cầu

Tham số	Kiểu	Bắt buộc	Mô tả
date	string	Có	Ngày sinh YYYY-MM-DD
time	string	Có	Giờ sinh HH:mm:ss
timezoneOffset	number	Có	Độ lệch UTC theo giờ (ví dụ: 2 cho Kyiv vào mùa hè)
latitude	number	Không (0)	Vĩ độ theo độ thập phân
longitude	number	Không (0)	Kinh độ theo độ thập phân
houseSystem	string	Không (P)	Hệ thống nhà: P Placidus, K Koch, W Whole Sign, E Equal và các hệ thống khác
name	string	Không	Tên (trả về trong phản hồi)
city	string	Không	Thành phố (trả về trong phản hồi)
zodiacType	string	Không	tropical (mặc định) hoặc sidereal
cosmogram	boolean	Không	true — không có nhà (khi không biết vị trí)

Ví dụ yêu cầu

Bản đồ natal cho Kyiv, 14 tháng 7 năm 1990, 14:30:

cURL

curl -X POST https://api.astroway.info/v1/chart \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "houseSystem": "P"
  }'

Node.js

const res = await fetch('https://api.astroway.info/v1/chart', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
    houseSystem: 'P',
  }),
});
const chart = await res.json();
console.log(chart.planets[0]); // Vị trí Mặt trời

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/chart',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
        'houseSystem': 'P',
    },
)
chart = r.json()
print(chart['planets'][0])  # Vị trí Mặt trời

PHP

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->post('chart', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'date' => '1990-07-14',
        'time' => '14:30:00',
        'timezoneOffset' => 3,
        'latitude' => 50.4501,
        'longitude' => 30.5234,
        'houseSystem' => 'P',
    ],
]);

$chart = json_decode($r->getBody(), true);
print_r($chart['planets'][0]); // Vị trí Mặt trời

Ví dụ phản hồi

{
  "input": {
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "houseSystem": "P"
  },
  "julianDay": 2448087.979166,
  "siderealTime": 8.234,
  "planets": [
    {
      "name": "Sun",
      "longitude": 111.87,
      "latitude": 0.0,
      "speed": 0.955,
      "sign": "cancer",
      "signIndex": 3,
      "house": 10,
      "retrograde": false
    },
    {
      "name": "Moon",
      "longitude": 87.23,
      "latitude": -4.2,
      "speed": 13.3,
      "sign": "gemini",
      "signIndex": 2,
      "house": 8,
      "retrograde": false
    }
  ],
  "houses": {
    "system": "P",
    "cusps": [12.34, 43.21, 72.56, 100.12, 130.45, 162.78, 192.34, 223.21, 252.56, 280.12, 310.45, 342.78],
    "ascendant": 12.34,
    "mc": 280.12
  },
  "aspects": [
    {
      "planet1": "Sun",
      "planet2": "Moon",
      "type": "sextile",
      "orb": 1.36,
      "applying": true
    }
  ],
  "chartSect": "diurnal"
}

Ghi chú

Phản hồi được rút gọn để minh họa. Phản hồi đầy đủ bao gồm tất cả 12 hành tinh (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto + North Node, Chiron), 12 điểm giao hội nhà và tất cả khía cạnh giữa chúng.

Hệ thống nhà

Mã	Hệ thống	Ghi chú
P	Placidus	Mặc định, phổ biến nhất
K	Koch	Phổ biến ở Đức
W	Whole Sign	Cổ điển Hy Lạp
E	Equal	Bằng nhau từ ASC
R	Regiomontanus	Chiêm tinh horary
C	Campanus	Hệ thống không gian
T	Topocentric	Polich-Page
B	Alcabitius	Truyền thống thời trung cổ

Danh sách đầy đủ 15 hệ thống — trong API reference.

Cosmogram (không có vị trí sinh)

Nếu bạn biết giờ sinh nhưng không biết nơi sinh, hãy truyền "cosmogram": true. Các nhà và ASC/MC sẽ không được tính toán, phí vẫn như nhau (20 tín dụng).

Tiêu đề phản hồi

X-Credits-Used: 20
X-Credits-Remaining: 4980
X-Credits-Reset: 2026-05-01T00:00:00Z
X-Request-Id: 01HXY2A7ZM...

Tiếp theo

• Synastry — sự tương thích giữa hai bản đồ
• Transits — lớp phủ chuyển tiếp và lịch sự kiện
• Human Design — bản đồ HD đầy đủ
• Tài liệu tham khảo API đầy đủ — tất cả các điểm cuối 723