Hosted proprietary astrology APIs, with a public API contract and open-source starter kits for commercial apps, websites, and client tools.
Website · Documentation · Guides · Status · Contact
FreeAstroAPI provides a proprietary hosted astrology calculation service, visual chart rendering for Vedic and Western charts, and deployable starter projects for teams building astrology products.
Use the API to add natal charts, compatibility, transits, horoscopes, Vedic Kundli tools, Chinese astrology, moon data, city search, and SVG chart generation without maintaining your own ephemeris infrastructure.
- Western natal chart apps, reports, and visual wheels
- SVG chart renderers for natal, transit, synastry, and composite charts
- Vedic Kundli calculators with divisional charts, dasha, yogas, panchang, and matching
- WordPress astrology blocks and site integrations
- Daily horoscope, transit timeline, moon phase, and city autocomplete tools
- Commercial astrology apps that keep API keys server-side
| Repository | What it is | Stack |
|---|---|---|
| freeastro-api-spec | Official public OpenAPI 3.1 contract, JSON Schemas, and synthetic examples | OpenAPI, JSON Schema |
| open-chart | Production-ready natal chart and interpretation app powered by FreeAstroAPI | Next.js, TypeScript, Tailwind |
| Kundli-birth-chart-free | Free AstroSage-style Vedic Kundli chart calculator and client tool | Next.js, TypeScript, Tailwind |
| wordpress-Astrology-plugin | WordPress plugin with astrology blocks, settings, and FreeAstroAPI proxy routes | PHP, WordPress |
The hosted FreeAstro API service, backend, calculation engine, frontend, infrastructure, algorithms, datasets, and interpretation content are proprietary and are not open source. Materials already published in public repositories remain available under the licenses stated in those repositories. The public API contract is licensed under Apache License 2.0; starter kits retain their own repository licenses.
Base URL:
https://api.freeastroapi.com
Example request:
curl -X POST "https://api.freeastroapi.com/api/v1/natal/calculate" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_KEY" \
-d '{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"city":"New York"}'Get started in the docs:
| Area | Examples |
|---|---|
| Western astrology | Natal charts, insights, transits, solar returns, synastry, astrocartography, horoscopes |
| Western visual charts | Natal SVG, transit bi-wheel, synastry bi-wheel, composite chart rendering |
| Vedic astrology | Basic chart, full calculate, Vimshottari dasha, yogas, planetary strength, panchang, match by birth |
| Chinese astrology | BaZi, BaZi synastry, current pillars, flow timing, dictionary endpoints |
| Utilities | City search, timezone handling, moon phase, moon timeline, hosted MCP, AstroFont |
- Keep API keys on the server, never in browser bundles.
- Use starter kits as production foundations, not just demos.
- Validate request and response contracts in your app.
- Respect rate limits and add retry/backoff behavior for production traffic.
- Keep visitor birth data handling explicit and privacy-aware.
- Website: freeastroapi.com
- Documentation: freeastroapi.com/docs
- Pricing: freeastroapi.com/pricing
- Contact: contact@freeastroapi.com