FreeAstroAPI LogoFreeAstroAPI

FreeAstroAPI changelog

Complete KP Astrology API and renderer

A new V2 Krishnamurti Paddhati endpoint returns 12 sidereal Placidus cusps, sign/star/sub/sub-sub lords, planet and house significators, cuspal sub-lord tables, ruling planets, and KP-compatible Vimshottari dasha context, with matching SVG and PNG reports.

Complete KP Astrology API and renderer preview

Traditional and modern decan rings for SVG charts

Western SVG and PNG charts can now render an opt-in 36-face decan ring in standard and French layouts. Choose traditional Chaldean rulers or modern triplicity rulers with Uranus, Neptune, and Pluto, then independently style ruler glyphs, circular borders, radial separators, band thickness, and backgrounds.

Retrograde markers in precise SVG chart labels

Western SVG and PNG charts now preserve opt-in R or ℞ retrograde markers when degree_label_format is set to minutes. The marker stays on the whole-degree row while the zodiac glyph and arcminutes retain their dedicated rows in both standard and French layouts.

Angle aspect line controls for SVG charts

SVG chart requests and the Chart Designer can now hide every aspect involving ASC, DSC, MC, or IC while preserving planet-to-planet aspects, angle axes, labels, and calculated chart data.

Angle aspect line controls for SVG charts: all aspects compared with planet-only aspects

Solar Return uncertainty for unknown birth times

Solar Return calculations now offer an opt-in uncertainty range for unknown birth times. The API evaluates the full local birth date, reports a possible return window and planetary position ranges, and suppresses time-dependent houses, angles, angularity, and natal house overlays while preserving the existing default response.

Location-aware solar eclipse data

The Moon Phase and Moon Phase Timeline APIs now detect solar as well as lunar eclipses. Solar responses include global type and contact data, plus observer-specific visibility, local eclipse type, contact times, magnitude, and obscuration when a location is provided.

Historical dates and astronomical year zero

Western natal, Vedic, Moon, and synastry requests now support astronomical years 0–2399, including dates before 1800. Year 0 represents 1 BCE, and dates outside the shipped ephemeris range now return a clear HTTP 400 response.

Graceful Chiron fallback for historical charts

Western SVG and PNG natal chart requests now keep rendering when Chiron is unavailable for the requested date. Chiron is omitted, the remaining chart is returned, and clients receive X-FreeAstro-Warnings: chiron_unavailable_for_date instead of a 5xx response.

Per-house SVG chart highlights

The Western SVG renderer can now highlight any set of primary houses with individual colors and adjustable opacity. An opt-in planet-zone extension continues each color through the corresponding primary planet lane and keeps planet backings visually seamless.

Per-house SVG chart highlights preview

More precise chart layout controls

The Western SVG renderer and Chart Designer now include glyph-aware collision spacing that keeps isolated connectors straighter, movable angle labels, searchable settings, body- or sign-based planet colors, manual sign palettes, optional dashed synastry guides, Chiron PI/PV points, corrected inner-wheel angle axes, and halo-backed house numbers.

More precise chart layout controls preview

French and Italian daily sign horoscopes

The V1 and V2 Daily Sign Horoscope endpoints now accept lang=en, fr, or it, including regional forms such as fr-FR and it-IT. Interpretation text and display labels are localized while response keys remain stable; locale remains available as a deprecated alias.

Improved Chart editor UI

The Chart Designer now has a task-focused inspector, clearer render-failure recovery, dependency-aware controls, and more accessible drag handles while keeping advanced chart configuration available.

Improved Chart editor UI preview

Hosted Vedic AI Chat API

Vedic AI Chat is now available for applications that need grounded conversational answers from a birth profile, recent conversation context, and Vedic chart tools. Hosted messages are metered separately from standard API requests.

Numerology Profile API

A new V1 endpoint returns deterministic Pythagorean, Chaldean/Cheiro, Kabbalah/Gematria, and Ank Jyotish profiles with versioned method policies, auditable calculation traces, optional interpretations where available, and timezone-aware Pythagorean personal cycles.

Western Chart Similarity API

A new V2 Western endpoint compares a natal chart against about 15,000 famous-person chart signatures, returning ranked matches with scores, shared placements, shared aspects, angle confidence, and human-readable why-this-match explanations.

Expanded Vedic vargas and Bhava Chalit

V2 Vedic charting now supports D4, D5, D16, D20, D24, D27, D40, and D45 divisional charts plus opt-in Bhava Chalit houses for chart, vargas, calculate, and North Indian visual chart workflows.

Daily Vedic Horoscope API

A Free-plan V2 endpoint now returns a deterministic daily Vedic forecast with one-day gochar insights, active Vimshottari dasha, Panchang, practical timing windows, explainable scores, and evidence.

Simple MCP Astro Bot starter

A reusable Next.js astrology chatbot starter is now available with Western and Vedic bot contacts, MCP-backed chart tools, server-side API keys, and a live demo page for fast customization.

Transit timeline endpoint demo

A print-style monthly Transit Timeline demo now shows endpoint data as grouped planet rows, exact-hit dots, continuation tails, moon phases, and retrograde summaries.

Transit timeline endpoint demo preview

Weekly Personal Horoscope API

New V2 weekly personal horoscope endpoint with exact hits, active transit windows, dominant topics, daily slices, and interpretation coverage for app and email experiences.

Astrocartography API

New line, paran, relocation, recommendation, and city-check docs for teams building location-aware astrology products.

Astrocartography API preview

Report Builder editor

A browser-based Western report workspace for configuring sections, evidence topics, tone, presets, output format, and report jobs.

Report Builder editor preview

Report credits and async reports

A dedicated report-credit checkout flow and updated psychological report docs for long-form astrology report generation.

Sun
Moon
Asc
Generation job
Queued
Synthesizing
Ready
Report credits
25

Hosted MCP and AI agent files

Published hosted MCP setup docs, llms.txt guidance, and endpoint maps so AI assistants can choose the right astrology API faster.

agent context

base_url: https://api.freeastroapi.com

auth: x-api-key

mcp: /mcp

llms: /llms.txt

Western natalready
Vedic chartready
Geo searchready
Moon phaseready

Vedic v2 documentation expansion

Expanded Vedic API coverage for chart, compatibility, dasha, yogas, strength, vargas, panchang, and Muhurat workflows.

Vedic v2 documentation expansion preview

Visual chart rendering themes

Expanded SVG chart rendering documentation with natal, transit, synastry, and composite endpoints plus theme examples.

Visual chart rendering themes preview

Fixed stars support

Added fixed-star documentation for natal data and SVG chart rendering, including star packs, individual stars, labels, and aspect overlays.

Fixed stars support preview

include_dominants

Added dominant distribution output for element, modality, polarity, and chart-level summaries when requests enable include_dominants.

include_dominants preview

Visual Chart editor

An interactive chart designer for tuning SVG chart themes, colors, labels, line weights, and production-ready API configuration.

Visual Chart editor preview

Progressions API suite

Published the Western progressions docs for secondary, converse secondary, tertiary, quotidian, quaternary, exact events, calendar, and table-mode workflows.

Progressions API suite preview

Synastry cards for mobile apps

Added mobile-friendly synastry response examples for relationship apps that need compact compatibility cards and summaries.

Synastry cards for mobile apps preview