FreeAstroAPIBuild Astrology apps in minutes

High-precision natal charts, transits, and synastry calculations for your next astrology app. Built for developers who demand accuracy and speed.

Read Documentation

Secure checkout via Stripe

99.9% uptime target

No credit card required · Free tier includes 80 requests/day

Trusted by builders

2,306 developers ship with FreeAstroAPI

74 paid subscribers·Actively maintained·Developer-first support

Global Accuracy

Calculations for any location on Earth with precise timezone handling.

Lightning Fast

Optimized calculation engine for millisecond response times.

Developer First

Clean REST API, comprehensive documentation, and 99.9% uptime SLA.

Vedic Mastery

Complete Sidereal system with 16 Varga charts, Dasha systems, and Panchang.

Built for Modern Developers

Pure JSON responses, typed schemas, and easy integration with any stack.

Native JSON API

Get clean, predictable JSON responses ready for your frontend. No parsing complex text or legacy formats.

Zero Config Integration

Works with React, Vue, Node.js, Python, or any HTTP-capable language. Just fetch and display.

Type-Safe Responses

Consistent data structures for planets, houses, and aspects make TypeScript integration a breeze.

response.json

{
  "subject": {
    "name": "Gabriel",
    "city": "Paris"
  },
  "planets": [
    {
      "name": "Sun",
      "sign": "Vir",
      "pos": 12.7,
      "house": 11
    }
  ],
  "aspects_summary": {
    "total": 28,
    "major": 28,
    "by_type": {
      "Conjunction": 12,
      "Opposition": 5
    }
  }
}

Planetary Positions

Precise calculations for all major bodies: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, and Pluto.

• Tropical Zodiac
• Retrograde status
• Precise Geocentric Positions

House Systems

Standardized calculations using the most popular house system for Western Astrology.

• Placidus System (Default)
• 12 Houses Calculation
• Ascendant & Midheaven (via Cusps)

Aspects & Geometry

Detailed geometric relationships between planets for in-depth interpretation.

• Major Aspects (Conjunction, Trine, Square, etc.)
• Orbs calculation
• Precise Angular Separation

Themeable Natal Charts with Fine-Grained Controls

This preview uses the French Clean preset on /api/v1/natal/chart/.

• Output formats: SVG and high-resolution PNG
• Theme modes: light, dark, mono, plus custom_theme overrides
• Full chart_config control: rings, line widths, colors, aspect styling
• Body toggles with display_settings (planets, nodes, points)
• House systems: placidus, whole_sign, equal, koch, and more
• Retrograde markers: enable + choose marker style
• Zodiac options: tropical or sidereal (with ayanamsa)

View Chart SVG Docs

French Clean natal chart preset rendered as SVG

Switch theme

Kundli API for Indian Astrology Apps

Build AstroSage-like Vedic astrology products with Lahiri sidereal calculations, Rasi/D1 charts, Nakshatra and Pada, Vimshottari Dasha, Panchang, Yogas, Ashtakavarga, and Kundli matching.

Includes Indian city and timezone lookup so users can enter birth places correctly before chart calculation.

Kundli ChartNakshatra/PadaVimshottari DashaPanchangKundli MatchingIndian Geo Search

Explore Kundli API

What the Vedic API supports

Indian astrology coverage by endpoint

/api/v2/vedic/chart

Kundli / Rasi chart

Ascendant, planets, houses, signs, Nakshatra, Pada

/api/v2/vedic/vargas

Divisional charts

D1, D2, D3, D7, D9, D10, D12, D30, D60

/api/v2/vedic/dasha

Vimshottari Dasha

Birth balance, active periods, nested timing stack

/api/v2/vedic/panchang

Panchang

Tithi, Nakshatra, Yoga, Karana, Rahu Kalam

/api/v2/vedic/match

Kundli matching

Ashtakoota score and dosha checks

/api/v2/geo/search

Indian birth places

City, locality, district, timezone, latitude, longitude

Rashi Noir Kundli chart preset rendered as SVG

Switch Vedic preset

Customizable SVG and PNG Vedic astrology chart API

Professional Chinese BaZi

Advanced Four Pillars analysis featuring 12 Life Stages, automated Day Master strength scoring, and precise solar time standards. Perfect for building Feng Shui or Destiny analysis tools.

Four PillarsDay Master StrengthShen Sha Stars12 Life StagesLuck Pillars

Explore BaZi Features

{
  "day_master": {
    "element": "Metal",
    "strength": "Weak"
  },
  "pillars": {
    "year": "Jia Chen",
    "month": "Bing Yin"
  },
  "shen_sha": ["Nobleman", "Travel Horse"]
}

Check Our Api playground

API Playground

Analysis Type

House System

Zodiac Type

Extra Bodies

Interpretation

Aspects & Data

Speed

Minor

cURL Command

curl -X POST "https://api.freeastroapi.com/api/v1/natal/calculate" \
 -H "x-api-key: ***" \
 -H "Content-Type: application/json" \
 -d '{
  "name": "Albert Einstein",
  "year": 1879,
  "month": 3,
  "day": 14,
  "hour": 11,
  "minute": 30,
  "city": "Ulm, Germany",
  "lat": 48.4011,
  "lng": 9.9876,
  "tz_str": "AUTO"
}'

Request Body

{
  "name": "Albert Einstein",
  "year": 1879,
  "month": 3,
  "day": 14,
  "hour": 11,
  "minute": 30,
  "city": "Ulm, Germany",
  "lat": 48.4011,
  "lng": 9.9876,
  "tz_str": "AUTO"
}

Reference the response header to execute

Response

Execute a request to see the response.

Is this API free to use?

Yes. We offer a generous Free Tier that allows up to 80 requests per day forever. It's perfect for hobbyists, students, and testing.

Do you provide a free MCP server and LLM files?

Yes. The hosted MCP server is available on every tier, including Free, and uses your normal API key and plan limits. We also publish /llms.txt and document the AI agent files in Utilities.

What astrology system do you use?

We specialize in precise Western Astrology calculations. We also support Vedic Astrology and Chinese Metaphysics.

How accurate is the timezone data?

Extremely accurate. We use the IANA Time Zone Database combined with historical location data to handle daylight saving shifts and historical time changes automatically.

Do you support other House Systems?

Yes. While Placidus is the default, we support all major house systems including Whole Sign, Koch, Regiomontanus, Equal, and Porphyry.

Can I use this for commercial apps?

Absolutely. Our Entry and High tiers are designed for commercial production use with high rate limits and priority support.

Can I cancel my subscription anytime?

Yes, there are no long-term contracts. You can cancel your subscription at any time from your dashboard.

Do you have a Moon Phase API?

Yes. We offer a dedicated Free Moon API for detailed phases, eclipses, and real-time SVG visuals.

Ready to Build Your Astrology App?

Start building your astrology application today. No credit card required.