The astrology engine for builders

Astrology, as an API.

130 endpoints. Seven traditions. One key. Drop birth charts, compatibility, dashas, horary, and forecasts into your matrimony, horoscope, or D2C app — without becoming an astrologer.

Get free API keyTry in playground
  • GST-compliant invoices
  • Razorpay-billed
  • Up in 2 minutes
  • Sub-arcminute accuracy
Sample requestPOST /v1/charts/birth
bash
curl -X POST https://api.astronode.dev/v1/charts/birth \
  -H "Authorization: Bearer aie_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1973-04-24",
    "time": "17:25:00",
    "tz_offset_minutes": 330,
    "lat": 19.076,
    "lng": 72.8777
  }'

Seven traditions, one consistent JSON shape

Capabilities

Seven traditions, one unified surface.

Each tradition ships as a coherent cluster of endpoints with the same JSON envelope and the same auth. Click into any one to browse its full surface — sample requests, the tier each endpoint sits behind, and everything you need for your integration.

🪐

Vedic

43 endpoints

Birth charts, varga, dasha, varshphal, panchang, balas, doshas.

Explore Vedic →

🔮

Nadi

4 endpoints

Nadiamsa (D150) — meaning (Dhruva) + timing (Chandra Kala).

Explore Nadi →

🪷

KP

7 endpoints

Cuspal sub-lord theory + horary 1–249.

Explore KP →

🪔

Lal Kitab

5 endpoints

Fixed-house kundli, 7 rins, and remedies.

Explore Lal Kitab →

🔢

Numerology

7 endpoints

Pythagorean and Chaldean reductions, ank milan, personal cycles.

Explore Numerology →

⭐

Western

25 endpoints

Tropical natal, transits, synastry, solar return, sun-sign forecasts.

Explore Western →

🃏

Tarot

4 endpoints

Rider-Waite-Smith spreads, yes/no, biorhythm.

Explore Tarot →

💎

Remedies

4 endpoints

Gemstones, rudraksha, pujas — tradition-sourced, pending astrologer pass.

Explore Remedies →

💞

Compatibility

11 endpoints

Cross-tradition match: Ashtakoot, Dashakoot, Porutham, synastry, ank milan.

Explore Compatibility →

📜

Reports

7 endpoints

Async PDF reports for compatibility, multi-year varshphal, full numerology.

Explore Reports →

💬

AI Astrologer

4 endpoints

Bounded conversational reasoning, grounded in the chart.

Explore AI Astrologer →

How it works

Three steps, fifteen minutes.

1

Sign up & get a key

Free tier covers 100 calls/day. Email-verify, generate a test key in one click.

export ASTRONODE_KEY="aie_test_..."
2

POST a birth input

Same JSON envelope across every tradition. Lat/lng/tz_offset_minutes — no place-name geocoding needed.

curl -X POST $ASTRONODE_API/v1/charts/birth -d '{...birth}'
3

Render the response

Use our SDK or your own. Every response carries request_id, engine_version, and an interpretation envelope.

{ data: { planets, houses, ... }, meta }

AI Astrologer

A conversational astrologer that reasons from the chart.

Most “AI astrologers” are a generic LLM in a costume. Ours is the Structured Emotional Intelligence layer sitting on the deterministic AstroNode engine — bounded reasoning, structured output, streamed token-by-token, and safety-gated for a consumer-facing surface. Same Bearer token and quota as the rest of the API.

Grounded in the chart, not vibes

The engine computes the deterministic chart, dashas and transits first. The model reasons against those structured signals by name — explainable and reproducible, never hallucinated.

Streaming + multi-turn memory

Token-by-token streaming for an instant feel. A caller-owned conversation_id replays recent exchanges into the prompt, so follow-ups stay continuous without you tracking state.

Structured on every reply

Tone, confidence, and a list of supportive Vedic practices (mantra / weekday / donation / lifestyle) come back as machine-readable fields — render them as UI, not just prose.

Compatibility from plain language

Name a partner's date, time and city right in the message — it resolves the place offline, computes the partner chart + Ashtakoot Gun Milan, and answers as a couple read.

Defense-in-depth safety

Medical, financial, death-prediction, self-harm and dependency-creating prompts are intercepted before the model runs and answered with a calm, grounded redirect.

One API, one ledger

Same Bearer token, same plan + rate limits, same usage_events billing as every other endpoint. Ship the astrologer and the raw chart APIs from a single key.

POST /v1/chat/respondconversation_id: demo-conv-01

User

I keep second-guessing my career decisions. What's that about?

Responsetone: reflectiveconfidence: moderate

With Mercury in your 10th house ruling both communication and your career axis, the second-guessing pattern has a name in your chart — it's the tension between an analytic mind and a 10th-house stage that wants commitment. The doubt isn't a flaw; it's the input check before you ship.

Practices

  • mercury·Write the decision down before discussing it — externalize the analytic loop.
  • saturn·Set a 48-hour container on the decision. Saturn answers to deadlines, not to debate.
POST /v1/chat/respondSSE streamingtone + confidencestructured remediesmulti-turnAshtakoot from textsafety-gated
Try the AI Astrologer live →Read the capability brief

Love Compatibility

Match two kundlis in seconds — and understand every score.

The classic Ashtakoot Gun Milan— out of 36 gunas — for any two people. Enter each partner's date, time, and city, and get an instant match score with a Mangal Dosha check. Unlike most matchers, every one of the eight koots comes with a plain-English explanation of what it measures and what your score means — not just a number.

Varna

1 pt

Ego & work harmony

Vashya

2 pts

Mutual attraction

Tara

3 pts

Health & fortune

Yoni

4 pts

Physical intimacy

Graha Maitri

5 pts

Mental bond

Gana

6 pts

Temperament

Bhakoot

7 pts

Emotional bond & family

Nadi

8 pts

Health & progeny

Two charts, one score

Add the male and female birth details — the engine computes both charts and the full 36-guna Ashtakoot match, BPHS-canonical with the half-marks cancellation rule.

Meaning behind every koot

Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot and Nadi — each with what it governs and a clear read of your score, strong or weak.

Mangal Dosha check

Both charts are screened for Mangal (Manglik) dosha and the result is reconciled into one clear status — compatible, needs attention, or mutually cancelled.

Check your love compatibility →Free to try in the Astroniq app.

For developers

Integration in 15 minutes.

One bearer token. One request envelope. Same response shape across every endpoint: { request_id, data, interpretation, meta }. Sign up, paste your key into curl, get a chart back. No SDK required, no XML, no surprise auth dance.

  • · Bearer-token auth (test + live keys)
  • · Per-key rate limiting + monthly quotas
  • · Idempotency keys on every write-equivalent endpoint
  • · OpenAPI 3.1 spec auto-published at /v1/openapi.json
  • · Deterministic: same input + engine version → byte-identical output
curl
curl -X POST https://api.aie.example.com/v1/charts/birth \
  -H "Authorization: Bearer aie_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1995-08-14",
    "time": "14:32:00",
    "tz_offset_minutes": 330,
    "lat": 18.5204,
    "lng": 73.8567
  }'

For individuals

Reports a non-technical reader can actually understand.

Raw planet positions are a commodity. Meaning is the moat. Every response carries an optional interpretation block — short, plain-English narrative, deterministically composed from versioned content. No LLM hallucinations, no fortune-teller theatrics, no medical or financial claims.

  • · Three report types today: chart summary, compatibility, Mangal Dosha
  • · English at launch, Hindi as 30-day fast-follow
  • · Content-lint enforced in CI — no accidental medical or financial language ships
  • · Versioned: every report carries the engine + interpretation version
  • · Public share links: opt-in, revocable, no PII leaked unless explicitly chosen
View live sample report
“Moderate compatibility (22 / 36). The match has structural stability through friendly planetary lords, but emotional patterns differ — partners may approach decisions from different starting points. Long-term success depends on conscious communication around temperament and timing rather than instinctive alignment.”
Sample compatibility narrative · v1.0.0

Pricing

Pay for the volume you need. Nothing else.

Free

₹0

No card required

  • ·1,000 requests / month
  • ·Test keys only
  • ·Community support
  • ·No credit card
Start free

HobbyMost popular

₹399 / mo

or $4.99 / mo

  • ·10,000 requests / month
  • ·Live + test keys
  • ·All endpoints (incl. compatibility)
  • ·Community + email support
Choose Hobby

Starter

₹999 / mo

or $12 / mo

  • ·50,000 requests / month
  • ·Live + test keys
  • ·Batch compatibility + KP + Lal Kitab
  • ·Email support · 99.5% SLO
Choose Starter

Pro

₹4,999 / mo

or $59 / mo

  • ·250,000 requests / month
  • ·Webhooks + audit log (30 days)
  • ·Async PDF + multi-year reports
  • ·Priority support · 99.9% SLO
Choose Pro

Custom

Custom

  • ·Volume pricing
  • ·SLA + dedicated support
  • ·Custom contract terms
Talk to us

All prices are exclusive of GST. Annual billing not yet available — see our refund policy.

Questions

Things people ask before they integrate.

How accurate are the planetary positions?+
Sub-arcminute. We use Swiss Ephemeris with the Lahiri ayanamsa as default, and our published charts match AstroSage and DrikPanchang within ±0.05° on every reference fixture. Determinism is guaranteed: same input + engine version = byte-identical output.
What ayanamsa and house system do you use?+
Lahiri ayanamsa and whole-sign houses by default — the most-cited Vedic convention in India. KP-Newcomb + Placidus support is on the roadmap (Phase 11). The output meta block always names the convention used so consumers can disambiguate.
Where is birth data stored?+
It isn't. By default we don't persist birth inputs beyond the request lifecycle — only request hashes for debugging. Reports the user explicitly saves are stored for 30 days, then purged. DPDP-aligned and GDPR-aligned.
Can I run this on-prem / self-host?+
Not yet. The engine is a workspace package today; we may publish it as a standalone binary in the future. Talk to us on the Custom plan if your compliance posture requires on-prem.
Do you support refunds?+
Yes — see the refund policy. Short version: pro-rata refund within 14 days of paid subscription if you haven't exceeded the free-tier quota.
Why "BPHS canonical" — and what does that mean for compatibility?+
Brihat Parashara Hora Shastra is the source text most modern Vedic software pins to. Our compatibility scoring follows BPHS verses 5–7 for the Ashtakoot tables and applies the canonical half-marks cancellation rule. Every koot exposes both the raw initial_score and the post-cancellation score so callers can render either.