AstroWay/api v2.254.12 · vi
tất cả hệ thống hoạt động bình thường
🚀 Founders' Lifetime Deal - 100 khách hàng đầu tiên, $299 thanh toán một lần → cấp Indie (50K tín dụng/tháng) mãi mãi →
v2.254.12 771 endpoints 873 CI tests sub-arcsecond Swiss Ephemeris

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

771 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 Ephemeris6houses 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 (873 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 771-endpoint surface

Try it now, no signup

Live request to /v1/public/chart. 30 requests/hour from your IP, no key.

Powered by POST /v1/public/chart - IP-rate-limited, no auth required
Response will appear here
Fill in the form and click "Build chart"
// 02 / mô-đun

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

// 01
41

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
15

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
12

Human Design

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

// 04
175

Chiêm tinh Ấn Độ (Vedic)

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

// 05
67

Tarot

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

// 06
56

Chiêm tinh học số

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

// 07
34

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
11

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 340 endpoint trong 8 danh mục chuyên biệt. Chi tiết từng endpoint xem tại trang /credits/.

// 09
70

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
60

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
55

Trung Hoa & Maya

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

// 12
51

Ứ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
23

Báo cáo PDF

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

// 14
59

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
14

Hình ảnh hóa

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

// 16
8

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
12
HumanDesign.ai
4
RoxyAPI
4
AstrologyAPI.io
1
Prokerala
0
VedicAstroAPI
0
// 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 783 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 · 783 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 771 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.

ProviderEntryCreditsWesternHDMCPUniqueOpenAPI
AstroWay$550K✓ 183✓ 12✓✓ 173.1
Astrology-API.io$111K✓ 130– 1✓– 03.0
Prokerala$19100K✓ 60– 0–– 0–
RoxyAPI$395K✓ 90✓ 4✓– 23.0
HumanDesign.ai$251K–✓ 4–– 0–
VedicAstroAPI$3030K✓ 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ả 771 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

186 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

175 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

27 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.
// agents
783 công cụ MCP
Trong MCP được host tại mcp.astroway.info: cho Claude, Cursor và mọi client MCP.
// 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 771 endpoints, all from one API key.

How many endpoints does AstroWay have?

771 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.