API de cálculos astrológicos · 714 endpoints · Swiss Ephemeris

v2.77.14 714 endpoints 818 CI tests sub-arcsecond Swiss Ephemeris

714 endpoints. <0.1″ de precisão. 99.97% de uptime. Mapas natais, previsões, sinastria, Human Design — com uma única requisição HTTP.

Gerar chave API Ler docs 10 000 créditos gratuitos · sem cartão necessário

// 01 / playground · astrology api

Faça uma requisição. Aqui mesmo.

● 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ódulos

8 principais + 8 módulos especializados. 714 endpoints do Astrology API.

// 01

Natal & ocidental

Mapa, aspectos, casas, disposições, midpoints, estrelas fixas, calendário de ciclos.

// 02

Prognósticos

Trânsitos, progressões, solar-arc, profecções, retornos em tempo real.

// 03

Human Design

Bodygraph, Penta, Dream Rave, Hologenetic Profile, Incarnation Cross.

// 04

169

Védica

16 Vargas, Panchang, Shadbala, 4 sistemas de dasha (Vimshottari/Yogini/Ashtottari/Kalachakra), Yogas, Doshas, Muhurat.

// 05

Tarô

Rider-Waite-Smith, Marseille, Lenormand. Disposições + guias para qualquer baralho.

// 06

Numerologia

5 sistemas (Pitagórica, Caldeia, Cabalística ×2, Védica) + Destiny Matrix.

// 07

Horária & geoastrologia

Horária, eleitoral, Lua fora de curso + astrocartografia, sinastria, mapas compostos.

// 08

Horóscopo AI

Diários/semanários + interpretações AI, ligadas a efemérides reais — sem alucinações LLM.

// 02b / extras

Mais 8 módulos especializados. Cenários e funções especializadas para desenvolvedores.

Além dos 8 módulos hero principais, cobrimos cerca de 311 endpoints em 8 categorias especializadas. Detalhes sobre cada endpoint — na página /credits/.

// 09

Escolas Ocidentais

4 escolas helenísticas (Brennan, Greenbaum, Hand, Schmidt) × 10 + psicológica moderna, evolutiva, cosmobiologia.

// 10

Divinação & guia

Geomancia (16 figuras), Runas do Futhark, Quiromancia, I Ching, Símbolos Sabianos, Cristais, Números de Anjos, Sonhos, Glifos de referência.

// 11

Chinesa & maia

BaZi (Quatro pilares), Zi Wei Dou Shu (12 palácios), Zodíaco Chinês, Tzolkin / Haab / Long Count.

// 12

Cenários de nicho

Bem-estar (médico / dieta / yoga), Pet, Negócios / Fundador, Financeiro, astrologia familiar — com isenções.

// 13

Relatórios PDF

12 tipos de PDF (natal / sinastria / kundli védico / lal kitab / human-design / tarot…) + 5 narrativas AI. Puppeteer + Handlebars, 21 localizações.

// 14

Infra para desenvolvedores

Webhooks (10 eventos), requisições de estado em tempo real (10), widgets iframe para embed (10), MCP avançado (multi-agente / RAG), configuração white-label PDF.

// 15

Visualização

Renderizações SVG de mapas, bodygraph, kundli, linha do tempo de trânsitos — para embed e frontend.

// 16

Sistémicos

Health, status, especificação OpenAPI 3.1, documentação no aplicativo.

// 03 / design humano

Cobertura HD que não existe em mais nenhum lugar.

12 endpoints do Human Design API. Todos em uma única API.

HumanDesign.ai tem bodygraph + 4 endpoints básicos. AstrologyAPI.io — apenas profile. Somos os únicos que têm Penta, Dream Rave, Hologenetic Profile e Incarnation Cross no mesmo Swiss Ephemeris que a astrologia ocidental.

// também disponível $9 pacote apenas HD

AstroWay

HumanDesign.ai

RoxyAPI

AstrologyAPI.io

Prokerala

VedicAstroAPI

// 04 / mcp & ai

Agente de IA que não inventa efemérides.

@astroway/mcp — servidor MCP nativo

Conecta ao Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) ou qualquer cliente MCP com um único comando. Funciona sobre GPT-4, Claude, Llama 3.3, DeepSeek, Gemini — a IA tem acesso a 714 ferramentas e garante chamar a API real em vez de inventar datas.

$ npm install -g @astroway/mcp

https://mcp.astroway.info/mcp

Um LLM genérico dirá «em algum lugar em julho Saturno faz trígono...» — sem data exata. Nosso agente faz tool_use POST /v1/transits e retorna um timestamp UTC até o segundo.

// funciona localmente · chaves no seu próprio config · sem telemetria do lado do AstroWay

// funciona em mcp.astroway.info · Streamable HTTP · Autenticação Bearer · multi-tenant

claude · @astroway/mcp · 714+ tools loaded

user

Quando é o próximo trânsito de Saturno trígono ao Júpiter natal?

claude

Executando cálculo de efemérides…

POST /v1/transits ✓

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

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

gpt-4 (sem MCP)

hallucinated«Por volta de julho de 2026 Saturno fará trígono…»

sem chamada de ferramenta · ±15 dias de desvio · alucinação textual

// 04b / sdks

SDKs oficiais para a sua pilha. TypeScript · Python · PHP.

Não quer chamar 714 endpoints manualmente? Três clientes oficiais com tipagem completa, retry em 429/5xx, idempotência e uma hierarquia de erros unificada. Um padrão em todos os três.

// @astroway/sdk

TypeScript / Node

Wrapper em torno do `openapi-fetch`, ~6 KB de tempo de execução. Autocompletar de caminho + tipos de solicitação/resposta para cada endpoint. ESM + CJS, Node 18+, Cloudflare Workers / Deno / Bun.

$ npm install @astroway/sdk

import { Astroway } from '@astroway/sdk'; Abrir no registro →

// astroway

Python

Clientes síncronos e assíncronos. Stubs PEP 561, modelos Pydantic v2, transporte httpx, retry automático. Python 3.10+. Editor de confiança do PyPI.

$ pip install astroway

from astroway import Astroway Abrir no registro →

// astroway/sdk

PHP

Cliente HTTP PSR-18, registrador PSR-3, fábricas PSR-17. Amigável ao Symfony / Laravel. PHP 8.1+. Autocarregamento do Packagist.

$ composer require astroway/sdk

use Astroway\Astroway; Abrir no registro →

// precisando de outras linguagens? Todos os SDKs

// 05 / versus

Profundidade como no Solar Fire. Preço como em side-project.

Provider	Entry	Credits	Western	HD	MCP	Unique	OpenAPI
AstroWay	$5	50K	✓ 175	✓ 12	✓	✓ 16	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	—

// números dos concorrentes — avaliações manuais de páginas de preços públicas · maio de 2026 · verificamos trimestralmente

// 06 / preços

Pague apenas pelas chamadas.

grátis

$0/mo

10 000 créditos

Todos os 714 endpoints
HD completo
1 chave API
Sem cartão

Começar

indie

$5/mo

50 000 créditos

Tudo do Free
3 chaves API
Webhooks
Suporte por email

Comprar Indie

inicial · popular

$19/mo

200 000 créditos

Tudo do Indie
10 chaves API
Servidor MCP
Técnicas Pro
Suporte prioritário

Comprar Starter

pro

$59/mo

800 000 créditos

Tudo do Starter
Chaves ilimitadas
IP dedicado
SLA

Comprar Pro

negócio

$199/mo

3M créditos

Tudo do Pro
White-label
Contrato personalizado
Suporte Slack

Fale conosco

// precisa de mais? Enterprise · Pacote HD $9 para aplicações apenas com bodygraph

99.9% SLA · planos pagos · 30d status →

// 06b / add-ons

Pacotes temáticos. Pague apenas pelo que você usa em produção.

Assinaturas de add-on horizontais para aplicativos com foco estreito — em vez de comprar um plano completo. HD Pack descrito em uma seção separada acima; os outros três — abaixo.

// hd-pack

$9/mo

HD Pack

12 endpoints de Human Design: bodygraph, Penta, Dream Rave, Hologenetic Profile, Incarnation Cross. O mesmo Swiss Ephemeris que a astrologia ocidental.

Comprar HD Pack →

// esoteric-pack

$9/mo

Esoteric Pack

164 endpoints: Tarot, numerologia (5 sistemas), runas, I Ching, geomancia, quiromancia, referência. Uma chave, $9/mês.

Comprar Esoteric Pack →

// vedic-pack

$19/mo

Vedic Pack

169 endpoints védicos: vargas D1-D60, panchang, shadbala, yogas, doshas, dashas (8 sistemas), KP, Lal Kitab, Jaimini.

Comprar Vedic Pack →

// reports-pack

$99/mo

Reports Pack

18 endpoints de PDF: natal, sinastria, kundli védico, HD, tarot e outros. White-label + 21 localizações. 100 PDFs/mês.

Comprar Reports Pack →

// 07 / confiança

Precisão de um astrólogo profissional no Swiss Ephemeris.

// motor

Swiss Ephemeris

O mesmo Swiss Ephemeris que no Solar Fire, Astrodienst (Astro.com), Kepler, Astro Gold e Janus — software de astrologia profissional há mais de 30 anos.

// validação

NASA Catálogo de Eclipse

818 testes de snapshot contra Astrodienst swetest CGI + Catálogo de Eclipse de 5 Milênios da NASA em cada PR.

// precisão

< 0.1″

Desvio sub-arco-segundo (≤0.1″) vs efemérides da NASA JPL e referência da Astrodienst. Fase 1-5 encerrada.

// alimentando

100K+ leitores

Horóscopos diários em astroway.info e 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 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.

API de cálculos astrológicos · Swiss Ephemeris · Human Design · AstroWay