Astro Engine API
Build astrology into your app. 121 endpoints. Swiss Ephemeris precision. REST API with JSON responses.
Quick Start
Generate a natal chart with a single API call. No SDK required -- just HTTP.
curl https://astro-engine.com/api/v1/chart/natal \ -X POST \ -H "Content-Type: application/json" \ -H "X-API-Key: ae_your_api_key_here" \ -d '{ "date": "1993-01-07", "time": "07:49", "latitude": 50.45, "longitude": 30.52, "timezone": "Europe/Kyiv" }'
Response includes planetary positions, house cusps, aspects, dignities, and more.
{
"name": "Natal Chart",
"planets": {
"Sun": { "sign": "Capricorn", "degree": 16.82, "house": 4 },
"Moon": { "sign": "Taurus", "degree": 3.41, "house": 8 },
"Mercury": { "sign": "Capricorn", "degree": 28.15, "house": 4 }
},
"houses": { "1": { "sign": "Libra", "degree": 2.67 }, ... },
"aspects": [ ... ]
}
Why Astro Engine API
Swiss Ephemeris Precision
The same astronomical library used by Solar Fire, Astro.com, and research institutions. Sub-arc-second accuracy.
121 REST Endpoints
From natal charts to Hamburg School midpoints, zodiacal releasing, and elections. The most comprehensive astrology API available.
5 Language Support
Localized responses in English, Ukrainian, Spanish, Portuguese, and Hindi. Build multilingual astrology apps from day one.
Sub-100ms Responses
In-memory Swiss Ephemeris with edge caching. Typical natal chart computation completes in under 50ms.
API Key Auth
Simple key-based authentication. Generate and manage keys from your dashboard. Rate limiting per key.
JSON Responses
Clean, well-documented JSON schemas. No XML, no SOAP. Works with any language or framework.
Endpoint Categories
121 endpoints organized into 10 categories. All endpoints accept JSON and return JSON.
More Examples
Get today's transits for a birth chart
curl https://astro-engine.com/api/v1/transits/current \ -X POST \ -H "X-API-Key: ae_your_key" \ -H "Content-Type: application/json" \ -d '{"date":"1993-01-07","time":"07:49","latitude":50.45,"longitude":30.52}'
Synastry between two charts
curl https://astro-engine.com/api/v1/synastry \ -X POST \ -H "X-API-Key: ae_your_key" \ -H "Content-Type: application/json" \ -d '{ "person_a": {"date":"1993-01-07","time":"07:49","latitude":50.45,"longitude":30.52}, "person_b": {"date":"1995-06-15","time":"14:30","latitude":40.71,"longitude":-74.01} }'
Daily horoscope for Aries
curl https://astro-engine.com/api/v1/horoscope/daily/aries \ -H "X-API-Key: ae_your_key"
API Pricing
- All 121 endpoints
- JSON responses
- 1 API key
- Community support
- All 121 endpoints
- JSON responses
- 5 API keys
- Priority support
- Usage analytics
- All 121 endpoints
- Dedicated support
- Unlimited API keys
- SLA guarantee
- Custom endpoints
- Webhook support
Authentication
All API requests require an API key passed via the X-API-Key header.
X-API-Key: ae_your_api_key_here
Generate your API key from the Dashboard after creating a free account. Keys are scoped to your account and rate-limited by tier.
Rate Limits & Error Codes
Rate limits are applied per API key per day. Headers include your current usage.
X-RateLimit-Limit: 100 X-RateLimit-Remaining: 87 X-RateLimit-Reset: 2026-03-30T00:00:00Z
| 200 | Success |
| 401 | Invalid or missing API key |
| 422 | Validation error (bad date, missing field, etc.) |
| 429 | Rate limit exceeded -- upgrade or wait until reset |
| 500 | Internal server error -- contact support |
Start Building
Create a free account, get your API key, and make your first call in under 60 seconds.