Swiss Ephemeris API

Swiss Ephemeris - tiêu chuẩn de facto cho các tính toán thiên văn trong chiêm tinh: nó được dùng bởi Astrodienst (astro.com), Solar Fire, Kerykeion và hầu hết phần mềm nghiêm túc. Nó đọc các hiệu chuẩn DE431 từ NASA JPL và cung cấp độ chính xác dưới giây. AstroWay API cung cấp truy cập HTTP trực tiếp tới nó - không cần biên dịch thư viện C, không cần tải các tệp .se1, không cần quản lý bộ nhớ. Một yêu cầu POST, JSON trong phản hồi.

Tại sao Swiss Ephemeris qua API

Tự host Swiss Ephemeris có nghĩa là: biên dịch thư viện C (hoặc bản build WASM), lưu trữ hàng trăm megabyte tệp .se1, duy trì chúng luôn cập nhật và tự mình triển khai các cusp nhà, khía cạnh, pha. Qua API, tất cả đều là phiền toái của người khác:

• Không cần hạ tầng: không có binary, tệp hiệu chuẩn hay độ trễ cold-start. Tính toán được thực hiện server-side trên cùng engine với Astrodienst.
• Độ chính xác dưới giây: < 0.1″ so với chuẩn swetest CGI của Astrodienst, đã được xác minh trên 873 snapshot-test đóng băng ở mỗi lần deploy.
• Khoảng ngày đầy đủ: DE431 bao phủ 13201 BCE – 17191 CE, vì vậy các bản đồ lịch sử và tương lai xa đều được tính mà không mất độ chính xác.
• Không chỉ vị trí: trên hiệu chuẩn ngay lập tức có sẵn cusp nhà (15 hệ thống), khía cạnh, nhật thực, chuyển vị, tiến triển - những gì nếu tự host bạn phải tự viết.

Mẹo

Độ chính xác của engine được bảo chứng bằng ba nguồn độc lập (swetest CGI, Kerykeion, Prokerala) + so với NASA 5-Millennium Eclipse Catalog. Chi tiết và số liệu - trên trang Độ chính xác tính toán.

Những gì được tính bằng Swiss Ephemeris

Endpoint	Credits	Kết quả trả về
/v1/chart	20	Bản đồ đầy đủ: hành tinh + nhà + khía cạnh
/v1/planets	10	Vị trí địa tâm của các hành tinh (kinh độ, vĩ độ, tốc độ, retrograde)
/v1/houses	10	Cusp nhà - 15 hệ thống (Placidus, Koch, Whole Sign, Equal…)
/v1/transits	50	Chuyển vị tới bản đồ sinh ngày cho ngày được chỉ định
/v1/progressions	50	Tiến triển phụ (ngày = năm)
/v1/eclipses	100	Nhật thực và nguyệt thực (verified vs NASA Catalog)
/v1/moon-phase	10	Giai đoạn Mặt Trăng, độ sáng, các phần tư tiếp theo
/v1/fixed-stars	20	Kết hợp hành tinh với các sao cố định

Đây là một phần của 760 endpoint của nền tảng - danh sách đầy đủ trong hướng dẫn API.

Ví dụ

cURL

curl -X POST https://api.astroway.info/v1/planets \
  -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
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/planets', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  }),
});
const { data } = await r.json();
const sun = data.planets.find((p) => p.name === 'Sun');
console.log(`Sun: ${sun.longitude.toFixed(4)}° retrograde: ${sun.isRetrograde}`);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/planets',
    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,
    },
)
data = r.json()['data']
sun = next(p for p in data['planets'] if p['name'] == 'Sun')
print(f"Sun: {sun['longitude']:.4f}° retrograde: {sun['isRetrograde']}")

Ai đang sử dụng

• Nhà phát triển ứng dụng chiêm tinh: vị trí dưới giây mà không cần self-host thư viện C
• AI-agent: hiệu chuẩn chính xác làm grounding cho LLM (qua MCP-server)
• Nhà nghiên cứu: tính toán hàng loạt trên khoảng thời gian lịch sử DE431
• Di chuyển từ self-host: thay thế swisseph cục bộ bằng HTTP mà không mất độ chính xác

Chi phí

Vị trí hành tinh (/v1/planets) - 10 credit, bản đồ đầy đủ (/v1/chart) - 20. Trong gói Free (760+ endpoint, 10 000 credit/tháng) - khoảng 1000 yêu cầu vị trí hành tinh mỗi tháng miễn phí, không cần thẻ.

Độ chính xác tính toán → Triangulation, xác thực NASA, snapshot-test

Bắt đầu nhanh Yêu cầu đầu tiên trong 5 phút

Bảng giá Từ miễn phí tới Enterprise