Saltar al contenido
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.astrosabio.com/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
Alta Precisión Hesaplama motoru
MCP Yapay zekâ entegrasyonu

Service catalogue

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

Haritalar

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

22

Natal Carta Astral

1 kredi

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

POST /api/v1/chart/natal Cacheable

Geleneksel Carta Astral

1 kredi

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

POST /api/v1/chart/traditional Cacheable

Carta de Tránsitos

1 kredi

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 kredi

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

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

Solar Return

1 kredi

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

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

Progresiones Secundarias

1 kredi

Produces a secondary progressed chart reflecting the current life cycle.

POST /api/v1/chart/progressed Cacheable

Solar Arc

1 kredi

Calculates directed planetary positions using solar arc directions.

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

Carta Dracónica

1 kredi

Returns the draconic chart realigned to the lunar node axis.

POST /api/v1/chart/draconic Cacheable

Profeksiyon

1 kredi

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

POST /api/v1/chart/profection Cacheable

Firdaria

1 kredi

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

POST /api/v1/chart/firdaria Cacheable

Horary Carta Astral

1 kredi

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

POST /api/v1/chart/horary Cacheable

Helyosentrik Carta Astral

1 kredi

Calculates planetary positions in a Sun-centred coordinate system.

POST /api/v1/chart/heliocentric Cacheable

Lokal Uzay Carta

1 kredi

Maps planetary directions onto compass azimuth values.

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

Ekvatoral Carta Astral

1 kredi

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

POST /api/v1/chart/equatorial Cacheable

Uranyen Carta Astral

2 kredi

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

POST /api/v1/chart/uranian Cacheable

Harmonik Carta Astral

1 kredi

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

POST /api/v1/chart/harmonic Cacheable

Sideral Carta Astral

2 kredi

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

POST /api/v1/chart/sidereal Cacheable

Kombine Carta Astral

2 kredi

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

POST /api/v1/chart/combo Cacheable

Sinastría de Pareja

2 kredi

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

POST /api/v1/chart/synastry Cacheable

Carta Compuesta

2 kredi

Builds a relationship chart from the midpoints of two charts.

POST /api/v1/chart/composite Cacheable

Davison Carta

2 kredi

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

POST /api/v1/chart/davison Cacheable

Relationship Bundle

4 kredi

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 kredi

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

Elektional Zamanlama

3 kredi

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

POST /api/v1/predictive/electional Cacheable

Lunar Phases

3 kredi

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

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

Zodiacal Releasing

3 kredi

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

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

Birth Time Rectification

10 kredi

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 kredi

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

POST /api/v1/interpretation/natal

Relationship Interpretation (AI)

30 kredi

Converts synastry and composite data into a comparative relationship reading.

POST /api/v1/interpretation/relationship

Annual Interpretation (AI)

30 kredi

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

Servis Durumu

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

Cuenta Bilgisi

Free

Devuelve tu plan activo, cuota mensual restante y saldo de créditos.

GET /api/v1/account

Usage Report

Free

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

GET /api/v1/usage

Estado del Informe de Interpretación

Free

Devuelve el estado (processing/ready) y el contenido una vez listo según el report_id devuelto por POST /interpretation. Como la generación de informes puede tardar minutos, el cliente puede consultar el resultado aquí tras un tiempo de espera; no consume créditos.

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

Hassas efemeris

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.

Comienza con la API de Astro Sabio

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