NewPaid plans and pay-as-you-go are live · Free plan limits change on 17 Nov 2026 →
Astrology API · Western & Vedic

The sky,as an API.

Natal charts, compatibility, dashas, panchanga and talent profiles — computed on the Swiss Ephemeris and returned as clean JSON. One key, 193 endpoints, and a free plan you can ship on.

No credit cardCommercial use on FreeHosted in the EUPython & TypeScript SDKs
♈︎♉︎♊︎♋︎♌︎♍︎♎︎♏︎♐︎♑︎♒︎♓︎ASC☉︎☽︎☿︎♀︎♂︎♃︎♄︎☊︎
"sun": gemini 24°"nakshatra": magha"dasha": saturn → mars
193documented endpoints
109Vedic routes
31Western routes
2zodiacs: tropical & sidereal
1,000free requests a day
What you get

Every astrology primitive, already built.

Stop bundling an ephemeris into your container and maintaining ayanamsha tables. Call the API, get structured JSON with the reasoning attached.

Charts

Natal charts in both zodiacs

Tropical or sidereal (Lahiri), Placidus, Whole Sign or Equal houses. Every planet with sign, degree, speed and retrograde flag — and, for Vedic charts, nakshatra, pada and navamsa.

♈︎♉︎♊︎♋︎♌︎♍︎♎︎♏︎♐︎♑︎♒︎♓︎☊︎♀︎☿︎☉︎☽︎♃︎♂︎♄︎
☉ sun☽ moon☿ mercury♀ venus♂ mars♃ jupiter♄ saturn☊ rahu☋ ketuASC
Compatibility

Two charts, one verdict

Western synastry and Vedic Ashtakoota — all eight kutas — in a single call, with dosha checks.

28 / 36
ashtakoota · sample
Vedic depth · 109 routes

Dashas, panchanga, yogas and strength

Vimshottari to four levels, the day's panchanga, yogas, Shadbala, divisional charts, Ashtakavarga, KP and muhurta search.

Ke
Venus
Su
Moon
Ma
Rahu
Jupiter
Saturn
Mercury
Vimshottari · 120 years · Saturn mahadasha highlighted
Talent profile

Ten talents, each carried by one graha

Scored from how strongly the chart carries that graha, with the rules that fired as plain-language reasons.

Drive♂
Communication☿
PresenceAsc
Endurance♄
Taste♀
Leadership☉
Interpretations

Readings with the reasons attached

Template statements for every talent on every plan; LLM-written readings on paid plans, grounded in the computed chart, under a spend cap.

“Drive is a standout strength. Mars is strong in this chart: an appetite for the effort itself…”
template · drive-strength-very-high-en
Your data, your call

Private by default, deletable by API

Hosted in the EU. Only birth moment and coordinates are stored, scoped to your account. One call deletes a chart and everything derived from it.

EU hostingDELETE /v1/charts/{id}DELETE /v1/tenant/datano LLM on Freeargon2id keys

For developers

Typed clients. Honest errors.

Official SDKs for Python and TypeScript, or plain REST from anything that speaks HTTP. The OpenAPI spec covers every route.

  • ✦
    Typed SDKsPydantic and Zod models on every response, retries with back-off, a typed error per code.
  • ✦
    Stable error contractEvery error carries a machine-readable code, an i18n key and a request id.
  • ✦
    Safe to retryIdempotency keys on writes; rate-limit headers that tell you exactly when to come back.
  • ✦
    Versioned and deprecated with noticeLegacy routes announce their successors in Deprecation and Link headers.
Read the docs →SDKs
api.astrolinkers.com
from datetime import datetime, UTC
from astrolinkers import Astrolinkers

client = Astrolinkers(api_key="ak_live_...")

# A sidereal chart for a birth moment and place.
chart = client.charts.create(
    moment=datetime(1990, 6, 15, 9, 30, tzinfo=UTC),
    latitude=40.7128,
    longitude=-74.0060,
)

# Ten talents, each carried by one graha.
profile = client.profiles.talent(chart.id)
for talent in profile.scores:
    print(talent.skill_id, round(talent.value, 2))
Start in a minute

From zero to your first chart.

Create an account

Sign up with an e-mail, verify it, accept the Terms. No card, no sales call.

Issue an API key

From the dashboard. Keys start with ak_live_ and are stored hashed — copy it once.

Make your first call

POST /v1/charts with a birth moment and coordinates — the chart comes back in milliseconds.

Live demo

Compute a real chart, right here.

This form calls the public POST /v1/demo/charts — the same engine your users will hit. Limited to 5 calls an hour per visitor.

Try the API live

Real call to POST /v1/demo/charts — no signup, no key.

Empty → auto-detected from coordinates (America/New_York = -04:00).
✦

Press Compute to see the live API response — planets, signs, houses, all from the same engine your customers will hit.

Official SDKs · MIT

Drop-in clients. Open source.

Every endpoint as a typed method, with retries, typed errors and streaming included.

Python

v0.3.0
$ pip install astrolinkers-sdk
  • Sync and async clients
  • Pydantic v2 models
  • Typed error hierarchy, Retry-After honoured
  • Python 3.12+, mypy --strict clean
View on GitHub ↗

TypeScript

v0.2.0
$ npm install @astrolinkers/sdk-ts
  • Node, Bun, browsers and Workers
  • Zod schemas with inferred types
  • ESM + CJS builds
  • Injectable fetch for your own transport
View on GitHub ↗
Plans

Start free. Pay when it grows.

Monthly or yearly — yearly is two months free. Cancel any time from the dashboard.

Available

Free

$0forever
  • Natal charts — Western & Vedic
  • Compatibility, talent profile, reports
  • All Vedic and Western routes
  • Template interpretations
  • 1,000 requests a day · 10,000 a month
  • From 17 Nov 2026: 100 a day · 3,000 a month
  • 1 active API key
  • Commercial use allowed · no SLA
Get a free API key →
Available

Pro

$49/ month · or $490 / year
  • Everything in Hobby
  • 10,000 requests a day · 300,000 a month
  • LLM budget $40 a month
  • 1,500-request bursts · 50 per second
  • Unlimited API keys
  • Priority support
Choose Pro →

Pay as you go. Over your limit, or no subscription at all? Packs of requests at $0.50 per 1,000 — 10,000 for $5, 40,000 for $20, 200,000 for $100. No expiry; used only after your plan's daily or monthly limit.

Payments by Dodo Payments, our merchant of record — sales tax and VAT included where they apply.

Questions

Asked before signing up.

Can I use the Free plan in a commercial product?

Yes — within its limits (1,000 requests a day and 10,000 a month until 17 November 2026, then 100 and 3,000; one API key) and without an uptime SLA. Need more without a subscription? Pay-as-you-go requests are $0.50 per 1,000.

Where is the data stored, and can I delete it?

In the EU: the API and database run in Germany, report files and backup copies stay in the EU. Delete one chart with DELETE /v1/charts/{id} or everything at once with DELETE /v1/tenant/data; backups roll off within 14 days.

Is an LLM used on the Free plan?

No. Free includes template interpretations; LLM-written readings belong to the paid plans, with a per-tenant hourly spend cap. On Free, place search uses a place database only.

Which systems and settings are supported?

Western (tropical) and Vedic (sidereal, Lahiri ayanamsha) charts, with Placidus, Whole Sign or Equal houses. Every response says which system it was computed in.

What data should I send?

Only the birth moment and coordinates. No names, e-mails or other identifiers — keep the mapping between your users and our chart ids on your side.

What happens when I hit a limit?

If you bought pay-as-you-go requests, the call goes through and uses one (X-Credits-Remaining tells you how many are left). Otherwise a 429 with a stable error code and Retry-After / X-RateLimit headers. Your usage is visible at GET /v1/tenant/usage.

Put the sky in your product.

A free key takes a minute. Questions about the API, plans or data — write to hello@astrolinkers.com.