API v1 · live in production

The spiritual API
for your projects.

Astrology, tarot, numerology, rituals, crystals, playlists — twelve grounded modules, one clean REST API, designed for developers who care about how their product feels.

Get started — it's free View documentation

✦ Free forever for hobby projects✦ 100 requests/day, no card✦ 12 modules

terminal — daily horoscope

$ curl https://www.astralapi.dev/api/v1/zodiac/horoscope/leo \
    -H "Authorization: Bearer <token>"

{
  "data": {
    "sign": "leo",
    "date": "2026-05-16",
    "mood": "Luminous",
    "lucky_color": "gold",
    "lucky_numbers": [3, 17, 22],
    "love": 4, "work": 3, "health": 5,
    "horoscope": "The sun anchors your chart..."
  }
}

Modules

Twelve doorways into the practice.

Each module is a small, careful surface. Pick one or compose them — the same auth, the same shape of response.

Daily horoscopes by sign, traits, and elemental affinities.

Draw single cards or full spreads with rich interpretation.

Life path, destiny, soul urge from name and birth date.

Astrological birth charts with houses and planetary positions.

Synastry scoring between two charts or signs.

Real-time moon phase, planetary transits, retrogrades.

Step-by-step rituals tagged by focus, energy, and duration.

Catalog of crystals with elements, properties and aliases.

Curated playlists for meditation, focus, and shadow work.

Meaning, origin, and vibrational notes for given names.

Archetypes derived from astrological + numerological inputs.

Daily affirmations and intentional quotes by theme.

How it works

Three steps. No ceremony.

i. Sign up for free

Create an account in seconds

Email and password. No card, no onboarding wizard, no calendar invites.

ii. Create an app

Get your API token

One name, one token. Save it somewhere safe — we'll only show it once.

iii. Build

Consume the API in your project

A Bearer header, a JSON response. Use AstralAPI wherever your stack lives.

Pricing

Simple, transparent pricing.

Three plans. No seat math, no "contact us." Upgrade when you outgrow the free tier — not before.

Full pricing details →

Build something quietly mystical.

The free tier is enough for a side project, a Discord bot, or a weekend experiment. Start there.

Create my account