astrology api

ASTROLOGY AS AN API

The sky, made computable.

Ephemeris-grade Western and Vedic calculations, shaped into results your product can render. One API for charts, planetary periods, panchang and compatibility.

Read the docs See the design system
  • Swiss Ephemeris
  • Western & Vedic
  • JSON over HTTPS
ONE REQUEST, ONE CHART

Send a birth moment. Receive the whole chart.

Every product follows the same contract: a JSON body in, structured sections out — ready to draw or interpret.

POST /western/v1/compose 200 OK
request 
{
  "instant": "2000-01-01T17:30:00+05:30",
  "houseObserver": {
    "latitude": 19.076,
    "longitude": 72.8777
  }
}
response
planets
sign · degree · house · speed
houses
placidus cusps · asc · mc
aspects
orb · applying / separating
balance
element · modality · dignity
WHY THIS API

From longitudes to something you can ship.

  1. 01

    Processed results

    Responses carry planets, houses, aspects, periods and scores as structure, not raw coordinates.

    positions · houses · aspects
  2. 02

    Two traditions

    Tropical Western and sidereal Vedic techniques share one request shape and one response contract.

    tropical ↔ sidereal
  3. 03

    Ephemeris precision

    Positions, boundaries and returns come from a validated Swiss Ephemeris pipeline.

    swiss ephemeris · verified
  4. 04

    Inspectable by design

    Every playground chart shows the exact request and response it was drawn from.

    request ↔ response
THE CHART LIBRARY

A chart for every question.

Start with the shape your product needs. Each calculation returns the data behind its drawing.

  • Western 01

    Natal wheel

    Tropical positions, Placidus houses and every aspect inside its orb.

    POST /western/v1/compose
  • Vedic 02

    Kundli

    Rashi and navamsa charts with lagna, graha placements and drishti.

    POST /vedic/v1/chart
  • Vedic 03

    Vimshottari dasha

    The 120-year planetary timeline, with the running period marked.

    POST /vedic/v1/chart
  • Vedic 04

    Ashtakavarga

    Benefic point tables for every planet and sign.

    POST /vedic/v1/chart
  • Vedic 05

    Panchang

    The five limbs of the Hindu day, sunrise to sunrise.

    POST /vedic/v1/panchang
  • Vedic 06

    Ashtakoota matching

    Kundli milan out of 36, with every koota and dosha explained.

    POST /vedic/v1/matching

  • 22 products, one contract

    Western and Vedic calculations that share one request shape.

    Read the docs
SPECIFICATIONS

Precise underneath. Simple at the edge.

The same foundation powers every endpoint, so results stay comparable across products.

22
API products
2
traditions
10
live playgrounds
JSON
response format
Ephemeris
Swiss Ephemeris
Traditions
Western · Vedic
Time model
UTC instants with observer
Houses
Placidus · whole sign
Response
JSON over HTTPS
Access
API key
START BUILDING

One request. A chart your product can use.

Read the developer guide, try a live calculation, or start with the design system.

Read the docs See the design system
Example request 
curl -X POST "$ASTRO_API/western/v1/compose" \
  -H "Content-Type: application/json" \
  -d '{"instant":"2000-01-01T17:30:00+05:30","houseObserver":{"latitude":19.076,"longitude":72.8777}}'

Keep credentials on your server. Browser assets never carry the API key.