AstroWay/api v2.77.14 · ko
모든 시스템 정상 작동 중
🚀 Founders' Lifetime Deal — 최초 100명 고객, $299 일회성 → Indie tier (월 50K 크레딧) 영구적 →
v2.77.14 714 endpoints 818 CI tests sub-arcsecond Swiss Ephemeris

점성술 계산 REST API · Swiss Ephemeris · Human Design · AstroWay

714개의 엔드포인트. <0.1″ 정밀도. 99.97% 가동 시간. natal 차트, 예측, 시나스트리, Human Design을 단일 HTTP 요청으로.

API 키 생성하기 문서 읽기 매달 10,000포인트 무료 · 카드 필요 없음
// 01 / playground · 점성술 API

요청을 만들어보세요. 바로 여기에서.

● 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, без ключа.

Powered by POST /v1/public/chart — IP-rate-limited, no auth required
Відповідь з'явиться тут
Заповни форму ліворуч і натисни "Побудувати карту"
// 02 / 모듈

8개의 기본 + 8개의 특화 모듈. Astrology API의 714개 엔드포인트.

// 01
40

natal & 서양 점성술

차트, 각성, 하우스, 디스포지션, 미드포인트, 고정성, 사이클 캘린더.

// 02
15

예측 점성술

트랜짓, 프로그레션, 솔라-아크, 프로페션, 실시간 회귀.

// 03
12

Human Design

바디그래프, 펜타, 드림 레이브, 홀로제네틱 프로파일, 인카네이션 크로스.

// 04
169

베다 점성술

16 Vargas, 판창, 샤드발라, 4 다샤 시스템(Vimshottari/Yogini/Ashtottari/Kalachakra), 요가, 도샤, 무후르트.

// 05
66

타로

라이더-웨이트-스미스, 마르세유, 레노르망. 모든 덱에 맞는 расклад 및 가이드.

// 06
51

Numerology

피타고라스, 칼데아, 카발라(×2), 베다 시스템 + 데스티니 매트릭스.

// 07
28

호라리 & 지구 점성술

호라리, 일렉션, 무효의 달 + AstroCartography, 시나스트리, 콤포짓 차트.

// 08
10

AI гороскоп

매일/매주 AI 해석이 포함된 гороскоп. LLM 환각 없이 실제 에페메리드 기반.

// 02b / 추가 기능

추가로 8개의 특화 모듈이 있어요. 개발자를 위한 특화 시나리오 및 기능.

8개 주요 hero 모듈 외에도 8개 전문화된 카테고리에서 약311개의 엔드포인트를 제공합니다. 각 엔드포인트의 세부 정보는 /credits/ 페이지에서 확인하세요.

// 09
70

서양 점성술 학파

4개의 헬레니즘 학파(Brennan, Greenbaum, Hand, Schmidt) × 10 + 현대 심리학적, 진화적, 우주생물학적 점성술.

// 10
59

점술 & 가이드

지오맨시(16 도형), 루나 룬, 손금, 이칭, 사비안 심볼, 크리스탈, 엔젤 넘버, 꿈, 참조 글리프.

// 11
39

중국 & 마야 점성술

BaZi(사주팔자), Zi Wei Dou Shu(12궁), 중국 황도대, Tzolkin / Haab / 롱 카운트.

// 12
50

니치 시나리오

웰니스(의료/다이어트/요가), 펫, 비즈니스/창업자, 금융, 가족 점성술 — 고지 사항 포함.

// 13
18

PDF 리포트

12가지 유형의 PDF(natal / 시나스트리 / 베다 쿤들리 / Lal Kitab / Human Design / 타로 등) + 5가지 AI 내러티브. Puppeteer + Handlebars, 21개 언어 지원.

// 14
56

개발자 인프라

Webhooks(10개 이벤트), 실시간 상태 조회(10), 임베드용 iframe 위젯(10), 확장 MCP(멀티 에이전트/RAG), 화이트레이블 PDF 설정.

// 15
14

시각화

차트, 바디그래프, 쿤들리, 트랜짓 타임라인 SVG 렌더링 — 임베드 및 프론트엔드용.

// 16
5

시스템

Health, 상태, OpenAPI 3.1 spec, 앱 내 문서.

// 03 / 휴먼 디자인

더는 없을 HD 커버리지

12개의 휴먼 디자인 API 엔드포인트. 모두 하나의 API에서.

HumanDesign.ai는 바디그래프 + 4개의 기본 엔드포인트를 제공합니다. AstrologyAPI.io는 프로파일만 제공합니다. 우리는 서양 점성술과 동일한 Swiss Ephemeris를 기반으로 Penta, Dream Rave, Hologenetic Profile 및 Incarnation Cross를 제공하는 유일한 곳입니다.

// 또한 사용 가능 $9 HD 전용 팩

AstroWay
12
HumanDesign.ai
4
RoxyAPI
4
AstrologyAPI.io
1
Prokerala
0
VedicAstroAPI
0
// 04 / MCP & AI

AI 에이전트가 날짜를 지어내지 않고 에페메리드를 계산합니다.

@astroway/mcp — 네이티브 MCP 서버

Claude Desktop, Cursor IDE, Windsurf, VS Code(llm CLI) 또는 모든 MCP 클라이언트에 한 명령으로 연결하세요. GPT-4, Claude, Llama 3.3, DeepSeek, Gemini 등 위에서 동작하며 714개의 도구를 사용해 실제 API를 호출합니다. 날짜를 지어내는 대신 정확한 API 호출을 보장합니다.

$ npm install -g @astroway/mcp
https://mcp.astroway.info/mcp

일반 LLM은 「7월쯤에 토성이 트라인을…»이라고만 말할 뿐 정확한 날짜는 없습니다. 우리 에이전트는 tool_use POST /v1/transits를 호출해 초 단위의 UTC 타임스탬프를 반환합니다.

// 로컬에서 작동 · 키는 자신의 구성 파일에 저장 · AstroWay에서 텔레메트리 없음

// mcp.astroway.info에서 작동 · Streamable HTTP · Bearer 인증 · 멀티 테넌트

claude · @astroway/mcp · 714+ tools loaded
user
다음 토성 트라인 natal 목성 언제?
claude
에페메리드 계산 중…
POST /v1/transits ✓
→ saturn_to_natal_jupiter · trine · exact: 2026-07-12T14:23:08Z
grounded · 4 credits · <100ms · sub-arcsecond
GPT-4 (MCP 미사용)
hallucinated「2026년 7월쯤 토성이 트라인을…»
도구 호출 없음 · ±15일 drift · 텍스트 환각
// 04b / sdks

自分の 스택을 위한 공식 SDK. TypeScript · Python · PHP.

714 엔드포인트를 수동으로 호출하고 싶지 않으세요? 3개의 공식 클라이언트가 있습니다. 완전한 유형 지정, 429/5xx 재시도, 멱등성 및 단일 오류 계층 구조. 모든 세 가지에서 동일한 패턴.

// @astroway/sdk

TypeScript / Node

`openapi-fetch`를 감싼 것, ~6KB 런타임. 경로 자동 완성 + 각 엔드포인트의 요청/응답 유형. ESM + CJS, Node 18+, Cloudflare Workers / Deno / Bun.

$ npm install @astroway/sdk
import { Astroway } from '@astroway/sdk'; registry에서 열기 →
// astroway

Python

동기식 + 비동기식 클라이언트. PEP 561.stub, Pydantic v2 모델, httpx 전송, 자동 재시도. Python 3.10+. PyPI Trusted Publisher.

$ pip install astroway
from astroway import Astroway registry에서 열기 →
// astroway/sdk

PHP

PSR-18 HTTP 클라이언트, PSR-3 로거, PSR-17 팩토리. Symfony / Laravel 친화적. PHP 8.1+. Packagist autoload.

$ composer require astroway/sdk
use Astroway\Astroway; registry에서 열기 →

// 다른 언어가 필요하세요? 모든 SDK

// 05 / vs

Solar Fire만큼의 깊이. 사이드프로젝트만큼의 가격.

ProviderEntryCreditsWesternHDMCPUniqueOpenAPI
AstroWay$550K✓ 175✓ 12✓✓ 163.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—

// 경쟁사 가격은 공개 페이지에서 수동 추정 · 2026년 5월 기준 · 분기별 검토

// 06 / 가격

호출 건수에만 요금을 지불하세요.

무료
$0/mo
1만 크레딧
  • 모든 714 엔드포인트
  • HD 팩 포함
  • 1 API 키
  • 카드 필요 없음
시작하기
인디
$5/mo
5만 크레딧
  • Free의 모든 기능
  • 3 API 키
  • 웹훅
  • 이메일 지원
인디 구매
스타터 · 인기
$19/mo
20만 크레딧
  • Indie의 모든 기능
  • 10 API 키
  • MCP 서버
  • Pro 기술
  • 우선 지원
스타터 구매
프로
$59/mo
80만 크레딧
  • Starter의 모든 기능
  • 무제한 키
  • 전용 IP
  • SLA
프로 구매
비즈니스
$199/mo
300만 크레딧
  • Pro의 모든 기능
  • 화이트 라벨
  • 맞춤 계약
  • 슬랙 지원
문의하기

// 더 필요하신가요? 엔터프라이즈 · HD 팩 $9 바디그래프만 필요한 앱용

99.9% SLA · 유료 플랜 · 30일 상태 →
// 06b / add-ons

테마 패키지. 필요한 것만 결제하세요.

수직적 add-on 구독을 통해 좁은 범위의 애플리케이션을 위한 기능을 제공합니다. HD Pack은 위의 별도 섹션에서 설명되며, 나머지 3개는 아래에 설명되어 있습니다.

// hd-pack
$9/mo

HD Pack

12 Human Design 엔드포인트: bodygraph, Penta, Dream Rave, Hologenetic Profile, Incarnation Cross. 서양 점성술과 동일한 Swiss Ephemeris.

HD Pack 구매 →
// esoteric-pack
$9/mo

Esoteric Pack

164 엔드포인트: 타로, 숫자론(5개 시스템), 룬, I Ching, 지오맨시, 점성술, 참조. 하나의 키, $9/월.

Esoteric Pack 구매 →
// vedic-pack
$19/mo

Vedic Pack

169 베다 엔드포인트: vargas D1-D60, panchang, shadbala, yogas, doshas, dashas(8개 시스템), KP, Lal Kitab, Jaimini.

Vedic Pack 구매 →
// reports-pack
$99/mo

Reports Pack

18 PDF 엔드포인트: 나탈, 신아스트로, 베다 쿤들리, HD, 타로 등. White-label + 21개 언어. 100 PDF/월.

Reports Pack 구매 →
// 07 / 신뢰

정확도 Swiss Ephemeris 기반 전문 점성술 소프트웨어 수준.

// 엔진
Swiss Ephemeris
Solar Fire, Astrodienst (Astro.com), Kepler, Astro Gold, Janus 등 30년 이상의 전문 점성술 소프트웨어에 사용된 Swiss Ephemeris와 동일합니다.
// 검증
NASA 일식 카탈로그
818개의 스냅샷 테스트를 Astrodienst swetest CGI + NASA 5천년 일식 카탈로그와 PR마다 비교합니다.
// 정밀도
< 0.1″
NASA JPL 에페메리드 및 Astrodienst 레퍼런스 대비 0.1″ 이하의 아크세컨드 드리프트. Phase 1-5 완료.
// 구동 중
100K+ 리더스
astroway.info 및 app.astroway.info의 일일 horoscope.
// 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 714 endpoints, all from one API key.

How many endpoints does AstroWay have?

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