AstroWay/api v2.325.2 · faq
all systems operational

// help · frequently asked

Frequently asked.

Quick answers to the questions developers ask most often before integrating. If yours isn't here: email api@astroway.info.

General

What is AstroWay API?

A professional HTTP API for astrology calculations. 865 endpoints at arc-second precision: natal charts, synastry, progressions, directions, transits, Human Design, astrocartography, rectification, AI interpretations. All calculations run server-side - no client-side dependencies.

Who is this API for?

Developers building astrology apps (web/mobile), AI companies adding astrology features, professional astrologers with custom scripts, and researchers needing programmatic access to calculations.

How accurate are the calculations?

Planet positions are accurate to ±1 arcsecond, house cusps to ±1 arcminute. Against NASA JPL Horizons the median deviation is 0.052″, with all 231 positions within tolerance; eclipses fall within a minute of the NASA 5-Millennium Eclipse Catalog.

How does AstroWay compare to Astro.com or Solar Fire?

The same arc-second precision you expect from professional desktop software. Against NASA JPL Horizons the median deviation is 0.052″; against Astrodienst’s swetest reference output the median is 0.0013″ and the maximum 0.561″ (Chiron); eclipses within 1 minute. The difference: AstroWay is a REST API starting at $5/mo, not a one-time license or desktop GUI.

Which house systems are supported?

15 systems: Placidus (default), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC, and Equal from MC. Pass the appropriate code in the houseSystem parameter.

Credits and billing

How does the credit system work?

Each endpoint has a fixed credit cost (10–500), depending on calculation complexity. Simple lookup - 10, natal chart - 20, synastry - 50, rectification - 500. Full table - on the Pricing page.

Is there a free tier?

Yes. The Free plan gives 10,000 credits/month with 10 req/min. No credit card required. Enough for product evaluation and prototyping.

What happens when credits run out?

Free - requests blocked until next month (429 CREDITS_EXHAUSTED). Starter and Pro - overage kicks in: $5 or $3 per 1,000 extra credits.

Are identical requests cached?

Yes. Identical input within 5 minutes returns from cache without consuming credits. Confirmed via X-Cache: HIT header.

Can I buy credits without a subscription?

Not yet. Subscriptions give you a predictable budget and better rate limits. Pay-as-you-go is planned.

Technical

Which SDKs are available?

  • MCP server ✅ shipped: npx -y @astroway/mcp: exposes all 865+ endpoints as tools for Claude Desktop, Cursor, GPT and other MCP-compatible AI agents
  • TypeScript SDK ✅ shipped: npm install @astroway/sdk: full types + autocomplete from OpenAPI 3.1, retry + idempotency, Stainless-style errors
  • Python SDK ✅ shipped: pip install astroway: sync Astroway + async AsyncAstroway on httpx, PEP 561 typed
  • PHP SDK ✅ shipped: composer require astroway/sdk: PHP 8.1+, Guzzle 7 + PSR-18, retry middleware
  • Go / Ruby / Rust 📋 planned: subscribe to release notifications on each SDK page (/en/sdk/<language>/)

The API contract is plain REST + JSON, so any HTTP client works without an SDK. Postman collection and OpenAPI 3.1 spec are publicly available.

Is there a sandbox mode?

Yes. Keys prefixed aw_test_* don’t consume credits and return the same results. Ideal for development and testing.

What are the rate limits?

Depends on your plan: Free - 10, Indie - 30, Starter - 120, Pro - 400, Business - 1,000 req/min. Exceeding returns 429 with a Retry-After header.

Is the sidereal zodiac supported?

Yes. Pass "zodiacType": "sidereal" and optionally "ayanamsaId" (default: Lahiri). Works with all endpoints.

What are the Human Design endpoints?

12 endpoints for calculating Human Design: type, strategy, authority, profile, definition, incarnation cross, channels, centers, Dream Rave, Hologenetic Profile, Penta (group dynamics), time sensitivity. Deepest HD coverage among commercial APIs.

Security and privacy

Do you store request data?

A JSON response leaves nothing behind: birth date, time, coordinates and name are not retained after the request. The one exception is a PDF report from /v1/reports/*, kept as a file at its link for 24 hours or the retain_days you set (up to 90), and deletable sooner. We only log metadata: key_id, endpoint, timestamp, latency, credits.

Is the API GDPR-compliant?

Yes. Data is stored and computed in Nuremberg, the request log keeps no request parameters and lives 30 days, and any paid plan comes with an Article 28 DPA you accept in the dashboard. Birth data you send is personal data, so we process it as your processor rather than pretend we don’t. Everything a security review asks, with the document behind each answer: Trust and data handling.

Are AI interpretations safe?

AI endpoints (/interpret/*, /horoscope/*) have built-in safety guardrails: no medical, legal, or financial advice. Every response includes a disclaimer. Full audit trail for enterprise compliance.

Support

How do I get help?

Depends on your plan: Free - community, Indie - email (48h), Starter - email (24h), Pro - email (4h), Business - email + Slack (1h), Enterprise - dedicated Slack manager. Contacts - on the Contact page.

Is there an SLA?

Indie: 99% uptime. Starter and Pro: 99.9% uptime. Business: 99.95% uptime. Enterprise: custom SLA with financial guarantees.

Similar names

No. astroway.info and api.astroway.info are a separate, independent company. We provide an astrology API for developers (api.astroway.info), an end-user app (app.astroway.info), and astrologer consultations. We are not affiliated with, operated by, or connected to the consumer astrology subscription marketed and billed under the name “Astroway” via astroway.life (emails from no-reply@astroway.life, the “Celeste” persona, bank-statement label “Astroway”). That subscription is operated by TrafficLeader OÜ (Estonia, also traffic-leader.com); the related biller SKYREAD.PRO is ABCMobile OÜ (Estonia). The names merely sound alike - these are different companies.

I’m being charged by “Astroway” - how do I cancel and get a refund?

If you’re being charged for an “Astroway” subscription (emails from no-reply@astroway.life, bank-statement label “Astroway”), that is a separate company, astroway.life - not us. We have no access to your account or payments with that service, so we cannot cancel them or issue a refund. What to do:

  1. Reply directly to the email from no-reply@astroway.life and use the “unsubscribe / cancel” link in its footer.
  2. If they don’t respond, contact your bank or card issuer (statement label “Astroway”; merchant of record TrafficLeader OÜ or ABCMobile OÜ / SKYREAD.PRO, Estonia) and ask them to block the recurring charge or request a chargeback.