Western astrology
Tropical natal charts, planetary aspects, synastry, and transits at a requested instant. Equal and whole-sign houses are included, alongside beta solar-arc directions, secondary-progressed planets and solar/lunar returns.
Build Western, sidereal, and Vedic-oriented astrology applications with deterministic JPL DE421 calculations. Get tropical and sidereal birth charts, transits, synastry, houses, and nakshatra data as structured JSON from your backend.
// Run on your server; store the key in ASTROAPI_KEY
const response = await fetch("https://api.astroapi.io/api/astro/birth-chart", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": `Bearer ${process.env.ASTROAPI_KEY}`
},
signal: AbortSignal.timeout(20000),
body: JSON.stringify({
date: "2000-01-01",
time: "12:00",
lat: 0.0,
lon: 0.0,
timezone: "UTC"
})
});
if (!response.ok) throw new Error(`AstroAPI HTTP ${response.status}`);
const data = await response.json();
console.log(data.chart);
# Run on your server; store the key in ASTROAPI_KEY
import os
import requests
url = "https://api.astroapi.io/api/astro/birth-chart"
payload = {
"date": "2000-01-01",
"time": "12:00",
"lat": 0.0,
"lon": 0.0,
"timezone": "UTC"
}
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {os.environ['ASTROAPI_KEY']}"
}
response = requests.post(url, json=payload, headers=headers, timeout=20)
response.raise_for_status()
print(response.json()["chart"])
Use one calculation API for your charting website, consultation software, educational tools, or app backend. Choose the settings your practice uses.
Birth charts, equal and whole-sign houses, aspects, synastry, transits, and explicit sidereal calculations.
Free tier to get started. Predictable monthly subscriptions with included request quotas and no automatic overages.
RESTful JSON APIs with copy-paste examples for JavaScript, Python, mobile backends, and web services.
Start with the zodiac and house system you need, then review the supported features.
Tropical natal charts, planetary aspects, synastry, and transits at a requested instant. Equal and whole-sign houses are included, alongside beta solar-arc directions, secondary-progressed planets and solar/lunar returns.
Select Lahiri, Raman, or Krishnamurti ayanamsa for sidereal longitudes, signs, chart angles, houses, and Moon nakshatra data.
Build from sidereal charts and nakshatra/pada geometry, with Pro transition timelines for nine bodies. Explore beta D1/D3/D4/D7/D9/D10/D12/D16/D20/D24/D27/D30/D60, three-level Vimshottari including Pratyantardasha, Indian chart SVGs and instant Panchang with explicit conventions. Regional calendars, festivals and complete Jyotish analysis remain outside the current scope.
Chart graphics, Western and Vedic beta APIs
Pratyantardasha inputs and period conventions
Davison relationship chart conventions
Moon phases and iCalendar exports
Planetary ingresses, stations, and exact aspects
Calculation methodology · Application use cases · About AstroAPI · Build an astrology app
Clear answers to the questions developers actually ask.
Yes. The free plan includes 100 standard API requests per UTC calendar month, with no credit card required. Tropical and sidereal chart calculations are included.
Birth charts, natal-to-transit aspects, natal aspects, synastry, equal and whole-sign houses, sidereal mode, and Pro nakshatra timelines. Beta additions include Placidus, Western and Indian chart SVGs, D1/D3/D4/D7/D9/D10/D12/D16/D20/D24/D27/D30/D60, three-level Vimshottari, instant Panchang, midpoint composites, secondary-progressed planets, solar-arc directions, lunar nodes, solar/lunar returns, uncorrected Davison charts and Moon phases/calendars with optional iCalendar export.
AstroAPI supports tropical calculations for Western astrology and sidereal charts with Lahiri, Raman, or Krishnamurti ayanamsa. Moon nakshatra/pada data and beta D1/D3/D4/D7/D9/D10/D12/D16/D20/D24/D27/D30/D60, Vimshottari, Indian SVG and instant Panchang calculations support Vedic-oriented applications. Panchang uses an explicit USNO solar-event model and latitude limits; regional calendars, festivals and a complete Jyotish system are not provided.
Equal and whole-sign houses are supported, with opt-in beta Placidus that rejects undefined polar geometry without a fallback. Public calculation dates run from January 1, 1900 through December 31, 2050. Supply an IANA timezone for local birth times; omitted timezones default to UTC.
Yes. The beta solar-arc endpoint rotates natal planets and Ascendant/MC by the true tropical solar arc, with tropical or sidereal output and synthetic equal or whole-sign houses. It does not calculate physical event charts, converse directions or predictions. Each admitted calculation uses one standard request.
Yes. The beta Vimshottari endpoint returns major periods and Antardasha by default. Set depth to 3 to include Pratyantardasha: 729 third-level periods across one theoretical 120-year cycle. It uses a fixed 365.25-day year, supports Lahiri, Raman and Krishnamurti ayanamsas, and costs one standard request per admitted calculation. Other dasha systems and deeper levels are not supported.
AstroAPI currently supports Lahiri, Raman and Krishnamurti ayanamsas, not every sidereal system offered by other products. The six-star-only beta is available; asteroid and minor-body endpoints remain unavailable. Separate betas provide Moon-phase calendars, bounded global eclipse geometry and hourly electional filtering. They do not provide hosted feeds, notifications, local eclipse visibility or paths, crescent visibility, continuous electional guarantees, rankings or advice. Solar/lunar returns find natal-longitude returns, not new or full moons.
You may integrate documented results into your application subject to the Terms; reselling raw API access is not permitted.
Authorization: Bearer <YOUR_API_KEY>
Any language capable of sending HTTPS requests.
Planetary positions use the bundled JPL DE421 ephemeris. House angles and lunar-node fields use documented engine approximations; see the calculation methodology for scope.
Yes. Use Stripe's hosted billing portal to change plans or cancel. Plan changes are prorated, and cancellation takes effect at the end of the current billing period.
API keys are returned once, stored only as one-way SHA-256 hashes, and transmitted over HTTPS. Keep them on your server.
Partnered with TimeMatrix
TimeMatrix brings advanced market charting, Gann tools, and financial-astrology research into one browser-based workspace.
Related products. Separate accounts, subscriptions, and policies.