✦ Astrology, programmable

Programmatic natal charts, talent profiles & compatibility — for builders.

One REST API. Western & Vedic systems. Ephemeris-grade precision. Built for production — auth, scopes, tenant isolation, audit log, predictable pricing. Free forever for makers.

Start free — 60 seconds →Try it without signing up

✓ No credit card✓ 1 000 req/day on Free✓ Real Swiss Ephemeris

What you get

Every astrology primitive you'd build from scratch — in one API.

Stop bundling Swiss Ephemeris into your container. Stop maintaining ayanamsha tables. Call the API, get JSON back.

Natal charts

Tropical or sidereal. Lahiri / Krishnamurti / Raman ayanamshas. Placidus / Whole-Sign / Equal house systems. Planets, retrograde flags, daily speeds.

Talent profiles

60+ astrological skills scored from the chart. Use for product onboarding, HR matching, gamified self-discovery.

Pair compatibility

Western synastry + Vedic Ashtakoota in one call. Aspect-by-aspect breakdown plus a single overall verdict score.

PDF reports

Generated async, delivered via signed S3 URL. Branded HTML templates so the file looks like your product, not ours.

AI interpretations

Template-grounded narratives in 4 tones (caring / pragmatic / mystical / corporate). LLM cost cap per tenant — no surprise bills.

Production-grade

OAuth-style scopes, opaque api-keys (argon2id), full audit log, per-tenant rate limit + quota, OpenAPI spec, OpenTelemetry traces.

For developers

Two-line install. Typed clients in every language we ship.

Official SDKs for Python and TypeScript with retry, typed errors, streaming, and Pydantic / Zod response models. Or call the REST API directly — the OpenAPI spec ships every endpoint.

See SDK options →API reference →

from datetime import datetime, UTC
from astrolinkers import Astrolinkers, InterpretationTier

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

# Compute a natal chart.
chart = client.charts.create(
    moment=datetime(1990, 6, 15, 9, 30, tzinfo=UTC),
    latitude=40.7128,
    longitude=-74.0060,
)

# Engine-grounded LLM reading — typed response.
reading = client.llm.chart_reading(
    chart_id=chart.id,
    tier=InterpretationTier.STANDARD,
)
print(reading.content, reading.cost_usd)

Official SDKs

Drop-in clients. Open source. Pin a version.

Every endpoint of the API is exposed as a typed method on an idiomatic client. Retry with exponential back-off, typed error hierarchy, streaming, response-model validation — included.

Python

v0.2.2 · MIT

$ pip install astrolinkers-sdk

or uv add astrolinkers-sdk

Sync (Astrolinkers) + async (AsyncAstrolinkers)
Pydantic v2 models on every response
Streaming via async iterators of typed events
Typed error hierarchy + Retry-After honoured
Python 3.12+, mypy --strict clean, py.typed

View on GitHub ↗

TypeScript

v0.1.2 · MIT

$ npm install @astrolinkers/sdk-ts

or pnpm add @astrolinkers/sdk-ts

One async Astrolinkers class — Node, Bun, browsers, Workers
Zod schemas + inferred TypeScript types
Streaming with for-await-of typed events
ESM + CJS, .d.mts + .d.cts declarations
Injectable fetch — wire your own transport / telemetry

View on GitHub ↗

Need a Go, Rust, or Ruby client? Open an issue — we prioritise by demand. Until then, the OpenAPI spec at docs.astrolinkers.com generates a usable client in any language.

Live demo

Compute a real natal chart, right here.

The form below calls the public POST /v1/demo/charts endpoint. Same engine your customers will hit. Rate-limited to 5 calls per hour per IP.

Plans

Free is genuinely usable.

1 000 requests a day on the free tier — enough to ship a real product. Upgrade only when you cross 10k req/month.

Free

Forever. No credit card.

Natal charts (Western + Vedic)
Talent profile
Pair compatibility
PDF reports
1 000 req/day · 10 k/month
1 active API key
Template interpretations (no LLM rewrite)

In development

Hobby

Coming soon

$9 / month

Everything in Free
LLM-rewritten interpretations (4 tones)
$5/hour LLM spend cap
300 req/burst · 10 req/sec sustained
5 active API keys
Email support

Notify me