API tính toán chiêm tinh · 748 endpoint · Swiss Ephemeris

v2.158.7 748 endpoints 873 CI tests sub-arcsecond Swiss Ephemeris

748 endpoint. <0.1″ độ chính xác. 99.97% thời gian hoạt động. Bản đồ sao, dự báo, sinastri, Human Design - chỉ với một yêu cầu HTTP.

Tạo khóa API Xem tài liệu 10.000 tín dụng miễn phí · không cần thẻ

// 01 / sân chơi · astrology api

Thực hiện một yêu cầu. Ngay tại đây.

● request.ts

1// native fetch - TS SDK auto-gen from OpenAPI 3.1 in dev23const chart = await fetch('https://api.astroway.info/v1/chart', {4 method: 'POST',5 headers: { 'X-Api-Key': process.env.AW_KEY!, 'Content-Type': 'application/json' },6 body: JSON.stringify({ date: '1991-08-24', time: '16:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234, houseSystem: 'P' }),7}).then(r => r.json());89console.log(chart.data.planets[0]);

1# requests - Python SDK in dev, native HTTP works today2import os, requests34r = requests.post('https://api.astroway.info/v1/chart',5 headers={'X-Api-Key': os.environ['AW_KEY']},6 json={'date': '1991-08-24', 'time': '16:30:00', 'timezoneOffset': 3, 'latitude': 50.4501,7 'longitude': 30.5234, 'houseSystem': 'P'})89print(r.json()['data']['planets'][0])

1curl https://api.astroway.info/v1/chart \2 -H "X-Api-Key: $AW_KEY" \3 -H "Content-Type: application/json" \4 -d '{5 "date": "1991-08-24",6 "time": "16:30:00",7 "timezoneOffset": 3,8 "latitude": 50.4501,9 "longitude": 30.5234,10 "houseSystem": "P"11}'

● response.json 200 · <100ms

1{2 "planets": {3 "sun": { "sign": "virgo", "degree": 1.123847 },4 "moon": { "sign": "libra", "degree": 14.892731 }5 },6 "houses": [/* 12 cusps */],7 "aspects": [/* 24 items */],8 "meta": {9 "engine": "swisseph",10 "precision": "sub-arcsecond",11 "credits": 1012 }13}

1HTTP/2 200 OK2content-type: application/json; charset=utf-83cache-control: private, max-age=04x-credits-used: 105x-credits-remaining: 499906x-credits-limit: 500007x-credits-reset: 2026-06-01T00:00:00Z8x-request-id: 01HQYK7ZF2N8RB3WPM5JTVD9XE9server-timing: ephe;dur=12, houses;dur=3, aspects;dur=510x-robots-tag: noindex, nofollow11strict-transport-security: max-age=3153600012vary: Origin, Accept-Language

1// Server-Timing breakdown (ms)2dns 2 ▏3tls 8 ▎4ttfb 14 ▍5ephe 12 ▍ // Swiss Ephemeris WASM6houses 3 ▏ // Placidus7aspects 5 ▏ // 24 hits, 8° orb8serialize1 ▏9total 45 ▕▍ // well under 100ms budget1011// Validated against swetest CGI + NASA Eclipse Catalog12// in CI on every PR (183 snapshot fixtures).

credits 10

latency <100ms

cache MISS

engine swisseph

DEMO · 30 req/hr per IP · 6 commands

Tab autocomplete · ↵ run · click to try: - demo only; get a key for the full 706-endpoint surface

Спробуй зараз, без реєстрації

Живий запит до /v1/public/chart. 30 запитів/годину з твоєї IP, без ключа.

Відповідь з'явиться тут

Заповни форму ліворуч і натисни "Побудувати карту"

// 02 / mô-đun

8 mô-đun chính + 8 mô-đun chuyên biệt. 748 endpoint của Astrology API.

// 01

Chiêm tinh cá nhân & phương Tây

Bản đồ, các góc chiêm tinh, nhà, người quản tinh, điểm giữa, sao cố định, lịch chu kỳ.

// 02

Dự báo

Chuyển động hành tinh, tiến trình, solara, profection, quay lại theo thời gian thực.

// 03

Human Design

Biểu đồ cơ thể (Bodygraph), Penta, Dream Rave, Hồ sơ Hologenetic, Incarnation Cross.

// 04

174

Chiêm tinh Ấn Độ (Vedic)

16 Vargas, Panchang, Shadbala, 4 hệ thống Dasha (Vimshottari/Yogini/Ashtottari/Kalachakra), Yogas, Doshas, Muhurat.

// 05

Tarot

Rider-Waite-Smith, Marseille, Lenormand. Bộ bài + hướng dẫn cho mọi bộ bài.

// 06

Chiêm tinh học số

5 hệ thống (Pythagore, Chaldean, Kabbalistic ×2, Vedic) + Ma trận số phận.

// 07

Chiêm tinh thời điểm & địa chiêm tinh

Horary, bầu cử, Mặt Trăng vô hiệu + bản đồ chiêm tinh, sinastri, bản đồ hợp thể.

// 08

Chiêm tinh AI

Hàng ngày/hàng tuần + giải nghĩa bằng AI, liên kết với số liệu thiên văn thực - không bị LLM ảo giác.

// 02b / phụ trợ

Thêm 8 mô-đun chuyên biệt. Các kịch bản và chức năng chuyên biệt dành cho nhà phát triển.

Ngoài 8 module hero chính, chúng tôi cung cấp 325 endpoint trong 8 danh mục chuyên biệt. Chi tiết từng endpoint xem tại trang /credits/.

// 09

Các trường phái phương Tây

4 trường phái Hy Lạp (Brennan, Greenbaum, Hand, Schmidt) × 10 + tâm lý hiện đại, tiến hóa, sinh học vũ trụ.

// 10

Bói toán & tra cứu

Địa chiêm (16 hình), Runic (Futhark cổ), Chiêm tay, I Ching, Ký hiệu Sabian, Tinh thể, Số thiên thần, Giấc mơ, Ký hiệu tra cứu.

// 11

Trung Hoa & Maya

BaZi (Tứ trụ), Tử Vi Đẩu Số (12 cung), Hoàng đạo Trung Hoa, Tzolkin / Haab / Long Count.

// 12

Ứng dụng ngách

Sức khỏe (y học / ăn kiêng / yoga), Thú cưng, Doanh nghiệp / Người sáng lập, Tài chính, Chiêm tinh gia đình - kèm cảnh báo.

// 13

Báo cáo PDF

12 loại PDF (natal / sinastri / vedic kundli / lal kitab / human-design / tarot…) + 5 nội dung AI. Puppeteer + Handlebars, 21 ngôn ngữ.

// 14

Cơ sở hạ tầng cho nhà phát triển

Webhook (10 sự kiện), truy vấn trạng thái thời gian thực (10), widget iframe để nhúng (10), MCP mở rộng (multi-agent / RAG), cấu hình PDF white-label.

// 15

Hình ảnh hóa

Render SVG bản đồ, bodygraph, kundli, dòng thời gian chuyển động - để nhúng và frontend.

// 16

Hệ thống

Sức khỏe, trạng thái, đặc tả OpenAPI 3.1, tài liệu trong ứng dụng.

// 03 / human design

HD-phủ sóng, mà không có ở đâu khác.

12 endpoint của Human Design API. Tất cả trên một API.

HumanDesign.ai hỗ trợ bodygraph + 4 endpoint cơ bản. AstrologyAPI.io - chỉ có profile. Chúng tôi là duy nhất có Penta, Dream Rave, Hologenetic Profile và Incarnation Cross trên cùng Swiss Ephemeris như chiêm tinh phương Tây.

// cũng có sẵn $9 gói HD-only

AstroWay

HumanDesign.ai

RoxyAPI

AstrologyAPI.io

Prokerala

VedicAstroAPI

// 04 / mcp & ai

Tác tử AI mà không bịa đặt ephemeris.

@astroway/mcp - máy chủ MCP bản địa

Kết nối tới Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) hoặc bất kỳ khách hàng MCP nào bằng một lệnh. Chạy trên GPT-4, Claude, Llama 3.3, DeepSeek, Gemini - AI truy cập 748 công cụ và đảm bảo gọi API thật thay vì bịa ra ngày tháng.

$ npm install -g @astroway/mcp

https://mcp.astroway.info/mcp

LLM thông thường sẽ nói «khoảng tháng Bảy, Sao Thổ tạo tam hợp...» - không có ngày chính xác. Tác tử của chúng tôi thực hiện tool_use POST /v1/transits và trả về timestamp UTC đến từng giây.

// hoạt động cục bộ · khóa trong cấu hình riêng · không telemetria từ AstroWay

// hoạt động trên mcp.astroway.info · Streamable HTTP · Bearer auth · multi-tenant

claude · @astroway/mcp · 748+ tools loaded

user

Khi nào thì lần tới Sao Thổ tạo tam hợp với Sao Mộc trong bản đồ sinh?

claude

Đang thực hiện tính toán ephemeris…

POST /v1/transits ✓

→ saturn_to_natal_jupiter · trine · exact: 2026-07-12T14:23:08Z

grounded · 4 credits · <100ms · sub-arcsecond

gpt-4 (không có MCP)

hallucinated«Khoảng tháng 7 năm 2026, Sao Thổ sẽ tạo tam hợp…»

không gọi công cụ · sai số ±15 ngày · ảo giác văn bản

// 04b / sdks

SDK chính thức cho ngăn xếp của bạn. TypeScript · Python · PHP.

Không muốn gọi 748 endpoint bằng tay? Ba khách hàng chính thức với đầy đủ kiểu dữ liệu, retry trên 429/5xx, tính idempotent và một hệ thống lỗi thống nhất. Một mẫu duy nhất trong cả ba.

// @astroway/sdk

TypeScript / Node

Bọc trên `openapi-fetch`, ~6 KB runtime. Path autocomplete + kiểu dữ liệu yêu cầu/trả lời cho từng endpoint. ESM + CJS, Node 18+, Cloudflare Workers / Deno / Bun.

$ npm install @astroway/sdk

import { Astroway } from '@astroway/sdk'; Mở trên registry →

// astroway

Python

Khách hàng đồng bộ + không đồng bộ. PEP 561 stubs, Pydantic v2 mô hình, httpx transport, tự động retry. Python 3.10+. PyPI Trusted Publisher.

$ pip install astroway

from astroway import Astroway Mở trên registry →

// astroway/sdk

PHP

Khách hàng HTTP PSR-18, logger PSR-3, nhà máy PSR-17. Thân thiện với Symfony / Laravel. PHP 8.1+. Packagist autoload.

$ composer require astroway/sdk

use Astroway\Astroway; Mở trên registry →

// cần các ngôn ngữ khác? Tất cả SDK

// 05 / so với

Độ sâu như Solar Fire. Giá như một side-project.

Provider	Entry	Credits	Western	HD	MCP	Unique	OpenAPI
AstroWay	$5	50K	✓ 182	✓ 12	✓	✓ 17	3.1
Astrology-API.io	$11	1K	✓ 130	– 1	✓	– 0	3.0
Prokerala	$19	100K	✓ 60	– 0	–	– 0	–
RoxyAPI	$39	5K	✓ 90	✓ 4	✓	– 2	3.0
HumanDesign.ai	$25	1K	–	✓ 4	–	– 0	–
VedicAstroAPI	$30	30K	✓ 50	– 0	–	– 0	–

// số liệu đối thủ - ước tính thủ công từ trang giá công khai · tháng 5 năm 2026 · kiểm tra hàng quý

// 06 / bảng giá

Chỉ trả tiền cho số lần gọi.

miễn phí

$0/mo

10 000 credits

Tất cả 748 endpoint
HD đầy đủ
1 API key
Không cần thẻ

Bắt đầu

indie

$5/mo

50 000 credits

Tất cả từ Free
3 API keys
Webhooks
Hỗ trợ email

Mua Indie

starter · phổ biến

$19/mo

200 000 credits

Tất cả từ Indie
10 API keys
MCP server
Pro kỹ thuật
Hỗ trợ ưu tiên

Mua Starter

pro

$59/mo

800 000 credits

Tất cả từ Starter
Không giới hạn key
IP chuyên dụng
SLA

Mua Pro

doanh nghiệp

$199/mo

3M credits

Tất cả từ Pro
White-label
Hợp đồng tùy chỉnh
Hỗ trợ Slack

Liên hệ chúng tôi

// cần thêm? Doanh nghiệp · Gói HD $9 dành cho ứng dụng chỉ dùng bodygraph

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

// 06b / add-ons

Gói chủ đề. Trả tiền chỉ cho những gì bạn đưa vào sản xuất.

Các gói add-on đăng ký ngang cho các ứng dụng có焦 điểm hẹp - thay vì mua toàn bộ gói cước. HD Pack được mô tả trong phần riêng biệt ở trên; ba gói còn lại - dưới đây.

// hd-pack

$9/mo

HD Pack

12 endpoint Human Design: bodygraph, Penta, Dream Rave, Hologenetic Profile, Incarnation Cross. Cùng Swiss Ephemeris như tây phương học.

Mua HD Pack →

// esoteric-pack

$9/mo

Esoteric Pack

164 endpoint: Tarot, số học (5 hệ thống), rune, I Ching, địa lý, chiêm tinh, tham khảo. Một khóa, $9/tháng.

Mua Esoteric Pack →

// vedic-pack

$19/mo

Vedic Pack

174 endpoint Vedic: vargas D1-D60, panchang, shadbala, yogas, doshas, dashas (8 hệ thống), KP, Lal Kitab, Jaimini.

Mua Vedic Pack →

// reports-pack

$99/mo

Reports Pack

23 endpoint PDF: natal, synastry, vedic kundli, HD, tarot và các loại khác. White-label + 21 bản địa hóa. 100 PDF/tháng.

Mua Reports Pack →

// 07 / độ tin cậy

Độ chính xác của phần mềm chiêm tinh chuyên nghiệp trên Swiss Ephemeris.

// engine

Swiss Ephemeris

Cùng Swiss Ephemeris như trong Solar Fire, Astrodienst (Astro.com), Kepler, Astro Gold và Janus - phần mềm chiêm tinh chuyên nghiệp hơn 30 năm.

// kiểm nghiệm

NASA Bộ dữ liệu nhật thực

873 bài kiểm tra snapshot so với Astrodienst swetest CGI + NASA 5-Millennium Eclipse Catalog cho mỗi PR.

// độ chính xác

< 0.1″

Sai số dưới arcsecond (≤0.1″) so với ephemeris NASA JPL và tham chiếu Astrodienst. Giai đoạn 1-5 đã hoàn tất.

// đang hỗ trợ

100K+ người đọc

Tử vi hàng ngày trên astroway.info và app.astroway.info.

// 08 / questions

Frequently asked questions about the API.

What is the AstroWay astrology API?

A REST API for astrology calculations on the Swiss Ephemeris engine - natal charts, synastry, transits, Human Design, Vedic and AI interpretations across 748 endpoints, all from one API key.

How many endpoints does AstroWay have?

748 endpoints spanning Western astrology, Vedic, Human Design, numerology, tarot and AI interpretation. New endpoints ship continuously and appear in the OpenAPI 3.1 spec.

Is there a free tier?

Yes - 10,000 credits every month, no credit card required. That covers roughly 500 full natal charts per month on the free plan.

Which SDKs are available?

Official TypeScript, Python and PHP SDKs, plus an MCP server so AI agents like Claude can call the API directly as tools.

How accurate are the calculations?

Planetary positions are accurate to under 0.1 arcsecond using the Swiss Ephemeris, verified against Astrodienst swetest, Kerykeion and the NASA eclipse catalog.

API tính toán chiêm tinh · Swiss Ephemeris · Human Design · AstroWay