The Astrology API
Built for Developers

Planetary positions, natal charts, horoscopes, synastry, KP, Vedic, Chinese, and 100+ more endpoints. One API key, five astrological traditions, clean JSON.

Get Your Free API Key Explore the API

Get your API key and make your first request in under 60 seconds.

100+
endpoints
5
astrological traditions
23
house systems
40+
celestial bodies tracked
<1s
average response time

Built for Developers

Built for production, not just prototypes.

RESTful & Predictable

Clean JSON responses, consistent error formats, standard HTTP status codes. No SOAP, no XML, no surprises.

Bearer Token Auth

Simple Authorization: Bearer alm_live_... header. Get your key and start calling endpoints in 60 seconds.

Smart Caching

Server-side caching with per-route TTLs (5 min for live positions, 15 min for horoscopes, 1 hour for calculations). X-Cache header tells you if it was a HIT or MISS.

Transparent Rate Limits

30–500 req/min sliding window (scales with your plan). X-RateLimit-Remaining and X-RateLimit-Reset headers on every response. No guessing.

Meaningful Errors

Every error includes a status code, human-readable message, and a requestId for support debugging.

curl https://api.almuten.io/v1/chart/natal \
  -H "Authorization: Bearer alm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-06-15",
    "time": "14:30",
    "latitude": 40.7128,
    "longitude": -74.006,
    "houseSystem": "placidus"
  }'

Response

{
  "positions": [
    {
      "body": "Sun",
      "zodiacSign": "Gemini",
      "degreeInSign": 24.21,
      "house": 10,
      "isRetrograde": false
    },
    {
      "body": "Moon",
      "zodiacSign": "Pisces",
      "degreeInSign": 2.18,
      "house": 5,
      "isRetrograde": false
    }
  ],
  "houses": { "system": "placidus", "cusps": [185.2, "..."] },
  "aspects": [{ "body1": "Sun", "body2": "Moon", "orb": 2.03 }],
  "// ...": "40+ additional fields"
}

What You Can Build

From horoscope apps to professional astrologer tools.

Horoscope Platforms

Generate daily, weekly, monthly, and yearly horoscopes for all 12 signs. Personalize them with natal data.

Birth Chart Apps

Full natal chart generation with houses, aspects, dignities, and professional-grade interpretations.

Compatibility Apps

Synastry, composite charts, Nakshatra compatibility, and Chinese zodiac matching in one call.

Wellness Apps

Moon phases, void-of-course periods, planetary hours, and moon guidance for ritual and wellness planning.

Astrologer Tools

Solar returns, progressions, profections, zodiacal releasing, electional astrology—the techniques working astrologers actually use.

AI Chatbots

Feed structured chart data and interpretations directly into LLM context for conversational astrology experiences.

Ready to Build?

Get your free API key and start making requests in under a minute.

Get Started Free View Pricing