Logo
Astrological background

Your Stars API

The easiest way to integrate advanced astrology into your app.

Start a Free TrialView DocsRun in Postman

    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.After your trial, continue for just $25/month – no surprises.
  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!

Full-featured astrology API with high-precision chart calculations for devs.

$50$25

per month *

*50% off for the first 50 customers. $25/month locked in for life (normally $50/month).

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

Powerful Limits. Generous Access.

LIMITVALUEDETAILS
Rate Limit (per minute)500 requestsMaximum number of API requests allowed per minute per API key.
Monthly Usage Limit500,000 requestsTotal allowed requests per billing cycle (usually per month).
Astrology chart example

Example chart generated via the actual API

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.