Skip to main content
For developers

Bring astrology calculations into your own product

Skip the ephemeris tables. Send birth data and receive calculated charts, aspects and timing data as JSON. One key, one integration.

curl
curl -X POST https://www.astrowise.io/api/v1/chart/natal \
  -H "Authorization: Bearer ab_live_..." \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-04-12","time":"08:35","lat":41.0082,"lon":28.9784,"tz":"Europe/Istanbul"}'
37+ Ready endpoints
JSON Response format
Precision Calculation engine
MCP AI integration

Service catalogue

Every endpoint works independently and has its own credit cost. You only pay for what you call.

Charts

All calculation endpoints including natal, traditional, transit, progressed and two-person charts.

22

Natal Chart

1 credits

Produces planet, house and aspect data from a birth date, time and location.

POST /api/v1/chart/natal Cacheable

Traditional Chart

1 credits

Calculated with classical rules: seven traditional planets, bounds and dignity scores.

POST /api/v1/chart/traditional Cacheable

Transit Chart

1 credits

Returns the aspects the sky forms with the natal chart on a chosen date.

POST /api/v1/chart/transits Cacheable

Sky at a Moment

1 credits

Gives a snapshot of the sky for any given moment and location.

POST /api/v1/chart/moment-sky Cacheable

Solar Return

1 credits

Calculates the annual chart for the moment the Sun returns to its natal degree.

POST /api/v1/chart/solar-return Cacheable

Progressed Chart

1 credits

Produces a secondary progressed chart reflecting the current life cycle.

POST /api/v1/chart/progressed Cacheable

Solar Arc

1 credits

Calculates directed planetary positions using solar arc directions.

POST /api/v1/chart/solar-arc Cacheable

Draconic Chart

1 credits

Returns the draconic chart realigned to the lunar node axis.

POST /api/v1/chart/draconic Cacheable

Profection

1 credits

Calculates the annual profection house and the ruler of the period.

POST /api/v1/chart/profection Cacheable

Firdaria

1 credits

Lists major and minor periods according to the Persian time-lord system.

POST /api/v1/chart/firdaria Cacheable

Horary Chart

1 credits

Returns the horary chart for the moment of the question plus validity checks.

POST /api/v1/chart/horary Cacheable

Heliocentric Chart

1 credits

Calculates planetary positions in a Sun-centred coordinate system.

POST /api/v1/chart/heliocentric Cacheable

Local Space Chart

1 credits

Maps planetary directions onto compass azimuth values.

POST /api/v1/chart/local-space Cacheable

Equatorial Chart

1 credits

Gives planetary positions in equatorial coordinates (RA / declination).

POST /api/v1/chart/equatorial Cacheable

Uranian Chart

2 credits

Produces Uranian analysis data with the 90° dial, midpoints and trans-Neptunian points.

POST /api/v1/chart/uranian Cacheable

Harmonic Chart

1 credits

Produces the transformed chart for a chosen harmonic number (H5, H7, H9…).

POST /api/v1/chart/harmonic Cacheable

Sidereal Chart

2 credits

Calculates a chart in the sidereal zodiac with a selectable ayanamsa.

POST /api/v1/chart/sidereal Cacheable

Combined Chart

2 credits

Combines natal, transit and progression layers in a single request.

POST /api/v1/chart/combo Cacheable

Synastry

2 credits

Extracts inter-chart aspects and house overlays between two charts.

POST /api/v1/chart/synastry Cacheable

Composite Chart

2 credits

Builds a relationship chart from the midpoints of two charts.

POST /api/v1/chart/composite Cacheable

Davison Chart

2 credits

Calculates a real chart from the time and space midpoint of two births.

POST /api/v1/chart/davison Cacheable

Relationship Bundle

4 credits

Returns synastry, composite and Davison charts together in one call.

POST /api/v1/chart/relationship-bundle Cacheable

Drawings

Endpoints that turn chart data into publication-ready SVG graphics.

1

Chart Drawing (SVG)

2 credits

Renders a scalable SVG wheel from chart data with configurable theme and labels.

POST /api/v1/chart/drawing Cacheable

Predictive

Advanced calculations such as timing, period analysis and birth time rectification.

4

Electional Timing

3 credits

Scores and ranks the most favourable moments for a purpose within a date range.

POST /api/v1/predictive/electional Cacheable

Lunar Phases

3 credits

Produces a lunar cycle calendar including new moons, full moons and eclipses.

POST /api/v1/predictive/lunar-phases Cacheable

Zodiacal Releasing

3 credits

Derives period and sub-period timelines from the lots of spirit and fortune.

POST /api/v1/predictive/zodiacal-releasing Cacheable

Birth Time Rectification

10 credits

Scores and ranks candidate birth times based on supplied life events.

POST /api/v1/predictive/rectification

AI Interpretation

Endpoints that turn calculated chart data into readable, sectioned interpretation texts.

3

Natal Interpretation (AI)

20 credits

Turns natal chart data into a sectioned, natural-language interpretation.

POST /api/v1/interpretation/natal

Relationship Interpretation (AI)

30 credits

Converts synastry and composite data into a comparative relationship reading.

POST /api/v1/interpretation/relationship

Annual Interpretation (AI)

30 credits

Combines solar return, profection and transits into an annual forecast text.

POST /api/v1/interpretation/annual

Free & Reference

Helper endpoints such as health check, city lookup and account info that consume no credits.

6

Health Check

Free

Verifies that the API is up and your key is valid. Consumes no credits.

GET /api/v1/ping

City Lookup

Free

Returns latitude, longitude and time zone for a city name.

GET /api/v1/reference/cities

Extra Points Catalogue

Free

Lists the supported asteroids, lots and hypothetical points.

GET /api/v1/reference/extra-points-catalog

Account Info

Free

Returns your active plan, remaining monthly quota and credit balance.

GET /api/v1/account

Usage Report

Free

Provides a breakdown of requests and credit consumption by date range.

GET /api/v1/usage

Interpretation Report Status

Free

Returns the status (processing/ready) and, once ready, the content of a report by the report_id returned from POST /interpretation. Generation can take minutes, so clients can still fetch the result here after a timeout. Consumes no credits.

GET /api/v1/interpretation/{type}/{report_id}

Precise ephemeris

Planetary positions are computed with Swiss Ephemeris and NASA JPL data, consistent down to the arcsecond.

Predictable cost

Each endpoint has a published credit cost. Repeated requests to cacheable endpoints do not consume additional credits.

Secure access

Key-based authentication, per-minute rate limits and request-level usage logging come as standard.

Get started with the Astro Bilge API

Create your account in the API panel, choose a plan or an endpoint package and send your first request within minutes.