Logo
Sign in
Astrological background

Your Stars API

The easiest way to integrate advanced astrology into your app.

Start a Free TrialView Docs

    How it works

  1. Step 1Create your developer accountSign up and start with a free trial. Get immediate access to your API key and developer dashboard.
  2. Step 2Integrate the APIUse our REST endpoints to calculate natal charts, transits, and synastry data. We use Swiss Ephemeris for high-precision results.
  3. Step 3Generate astrology reportsGet structured JSON data you can plug directly into your app, chatbot, or custom report — we provide the insights, you design the experience.
  4. Step 4Launch your productWhether you're building an app, chatbot, or report generator — your astrology backend is now covered. Scale with confidence.

Launch Special!

Access powerful chart calculations and insights via a developer-friendly API.

$50$25

per month*

*50% off for the first 50 customers. Lifetime discount — $25/month forever (normally $50/month).

  • Natal Chart Calculation
  • Sign Positions
  • House Cusps
  • Ascendant and Midheaven (MC)
  • Moon Phase
  • Transits Analysis
  • Synastry Analysis
Start a Free Trial

Core Features

Core Astrological Calculations

  • Swiss Ephemeris-based planetary positions
  • Includes Sun, Moon, planets, Chiron, and Nodes
  • Text interpretations for all calculated points

Transits

  • Precise timing for major planetary transits
  • Aspect detection with customizable orbs
  • Filter by specific planets and aspect types

Synastry

  • Compare two natal charts for compatibility
  • Identifies key synastry aspects
  • Use for relationships, family, or teams

House System

  • Placidus house system support
  • Returns cusp degree, sign, and decan
  • Maps planets to their house placements

Multi-Planet Support

  • Batch calculations for multiple celestial points
  • Optimized for full chart generation
  • Available across all major endpoints

Sign + Decan Details

  • Zodiac sign, degree, and decan breakdown
  • Includes decan name and planetary ruler
  • Ideal for layered, in-depth readings

Why Choose Your Stars API?

Human-Written Interpretations

Every interpretation is crafted by a real astrologer with accredited expertise.

Real Calculations, Not Lookup Tables

Powered by Swiss Ephemeris for high-precision planetary and house positions — down to the arcsecond.

Generous Quotas & Rate Limits

Built for scale — ideal for both indie developers and production apps.

Developer-Centric Error Handling

Get detailed 400-series error responses with debugging hints. No vague “something went wrong.

Astrological Accuracy Guaranteed

Trusted math, professional interpretations, and continuous validation — we stand by the integrity of your data.

Here When You Need Us

Fast, friendly help from real devs and astrologers who get both the code and the cosmos.