What AstroAPI provides
The public endpoints accept explicit chart inputs and return JSON for supported bodies, signs, angles, houses, aspects, nodes, synastry, natal-to-transit comparisons, and selected sidereal calculations. Tropical is the default; sidereal mode is an explicit option.
Western astrology calculations
Tropical birth charts, equal and whole-sign houses, aspects, synastry, and requested-instant transits.
Hellenistic-oriented building blocks
Whole-sign houses and beta sect-related fields—not a complete Hellenistic system.
Vedic-oriented building blocks
Three sidereal ayanamsas, Moon nakshatra/pada data, and a Pro timeline—not complete Jyotish.
Product use cases
Chart rendering, comparison tools, selected-time transit views, education, and editorial systems.
Product principles
- Document the contract. Public reference pages describe required inputs, response shapes, authentication, errors, and endpoint limits.
- Name the method. Ephemeris source, coordinate frame, zodiac selection, house formulas, node behavior, and date boundaries are declared.
- Separate data from meaning. Calculation output and product-owned interpretation are different layers.
- Keep API keys server-side. The service is designed for trusted backends, not keys embedded in browser or mobile-client code.
- Publish limitations. Planned or unsupported features are not presented as current capabilities.
Who it is for
AstroAPI is intended for developers and product teams that want to build their own astrology interface on top of machine-readable calculations. It can serve web or mobile application backends, chart-rendering services, educational tools, and other systems that can send authenticated HTTPS requests and handle JSON responses.
It is not an astrology practice, a scientific prediction service, or a substitute for medical, legal, financial, or mental-health advice. A customer application remains responsible for its own content, user promises, privacy practices, and regulatory obligations.
How to evaluate AstroAPI
Start with the calculation methodology, then open the reference for the endpoint you intend to use. Compare declared inputs and definitions—not just labels—when checking output against another system. Different ephemerides, frames, ayanamsas, node definitions, house formulas, and orb policies can produce different results.
Regression tests support the documented implementation, but they do not prove independent scientific validity for every possible input or establish the validity of astrological interpretation.
Product, support, and policy resources
Developer documentation
Endpoint requests, response fields, error behavior, authentication, and technical limits.
Plans and quotas
Current plan availability and the included request or timeline quotas shown at purchase.
Privacy
How account, usage, request, and service-provider data is handled under the current notice.
Terms
The rules and conditions that apply to use of the website and service.