By topic / Astrology Chat API
Reports and media
Astrology Chat API: an AI astrologer in your app, streamed
Send the birth details and a question, and the answer streams back as it is written, so your users read it at once. Earlier turns are kept as history, so a follow-up such as "and what about next year?" is understood. Every answer comes from the chart the service computes first, never from the model's guesswork, and couples and Western charts have their own chat.
Ideas
What people build with it
An "Ask the astrologer" chat screen
A WhatsApp or Telegram astrology bot
Couple questions on a matchmaking profile
Reference
The endpoints
- AI Reading: Chat answerAn AI answer to a question about a birth chart, with earlier turns as history; grounded in chart data the service computes from the birth (or in one report named in `context`).POST/v1/ai/ai-chat Metered, from 15 credits
- AI Chat for a CoupleAn AI answer about two people, with earlier turns as history; grounded in their computed matching report.POST/v1/ai/ai-match-chat Metered, from 15 credits
- AI Chat, WesternAn AI answer about a birth chart in the tropical tradition, with earlier turns as history; grounded in the computed Western report.POST/v1/ai/ai-western-chat Metered, from 15 credits
- AI Reading: General questionAn AI answer to a general astrology question, grounded in chart data the service computes from the birth (or in one report named in `context`); choose persona, tier and language.POST/v1/ai/ai-general Metered, from 15 credits
- AI Reading: Structured readingAn AI-written reading of a birth chart, grounded in chart data the service computes from the birth (or in one report named in `context`); choose persona, tier and language. Optional JSON output.POST/v1/ai/ai-insight Metered, from 15 credits
See a conversation
A real two-question conversation from the API for a sample chart (18 Oct 1990, 14:30, New Delhi), shown as a chat screen would show it.
Ask the astrologer
When is a good time to change jobs?
Direct Answer: The most favorable and active timing window to change your job or transition in your career is between now and January 5, 2027, while you are running the Jupiter Mahadasha and Mars Antardasha. Astrological Reasoning: • Career House and Karakas: Your 10th house of career (Libra) is occupied by a debilitated Sun that forms a Neecha Bhanga Raj Yoga, and its lord Venus sits in the 9th house. Furthermore, the Sun in the 10th creates a strong Karmajiva Yoga relating to authority and public status. • Active Dasha Period: You are currently running the Jupiter Mahadasha (2013 to 2029) combined with the Mars Antardasha (running from January 29, 2026, to January 5, 2027). Mars rules your 4th house (Aries) and 11th house (Scorpio) and is placed in the 5th house (Taurus). This period bridges your foundational stability, income gains, and speculative or creative output, making it an energetic window for professional movement. • Next Career Shifts: If you miss this current window, the subsequent shifts align with major planetary changes, such as the onset of the Saturn Mahadasha starting May 30, 2029. Grounded Remedy: To strengthen your professional standing and smooth out career transitions, offer water to the Sun daily at sunrise and practice charitable giving or support to educational causes on Thursdays to honor your 9th house Mercury and exalted Jupiter in the 7th house. (Note: Vedic astrology offers spiritual insights for timing and reflection; please consult a qualified professional for major financial, legal, or career decisions.)
And what should I do until then?
Direct Answer: Until the end of your active job change window on January 5, 2027, you should focus on stabilizing your current professional footing, leveraging your networking skills for income, and practicing disciplined patience as you prepare for your next step. Astrological Reasoning: • Current Dasha Support: You are running the Jupiter Mahadasha paired with the Mars Antardasha (active until January 5, 2027). Mars rules your 4th house of home/foundations and 11th house of gains, while sitting in your 5th house. This makes the present period ideal for channelling your energy into productive planning, securing financial gains, and managing your current responsibilities rather than rushing into impulsive moves. • Career House Dynamics: Your 10th house of career (Libra) holds a debilitated Sun that forms a Neecha Bhanga Raj Yoga, and its lord Venus sits in the 9th house alongside Mercury and a combust Moon. Because your 10th lord Venus is tightly conjunct combust planets in the 9th house, your workplace may experience temporary communication snags or hidden friction. Maintaining a steady, methodical approach will protect your reputation. • Upcoming Transition: Your current antardasha shifts on January 5, 2027, to the Jupiter–Rahu period, which will introduce a new wave of ambition and unconventional career opportunities. Therefore, the months leading up to then are best used for laying the groundwork. Grounded Remedy: To steady your mind and clear professional obstacles during this transitional phase, offer water to the Sun daily at sunrise to honor your 10th-house Sun, and engage in charitable acts or support educational causes on Thursdays to honor your strong 7th-house exalted Jupiter. (Note: Vedic astrology offers spiritual insights for timing and reflection; please consult a qualified professional for major financial, legal, or career decisions.)
streaming the answer

- 1. The chart is computed firstBirth details become a full chart with the same engine as the chart APIs.
- 2. The model explains that chartIt answers only from the computed placements and periods, never from guesswork.
- 3. The answer streamsWords arrive as they are written, so your user starts reading at once.
- 4. History keeps the threadFollow-up questions are understood in the context of the earlier turns.
FAQ
Common questions
How does streaming work?
Send "stream": true and the response is a text/event-stream: the answer arrives in small pieces as it is written, then a final event with the full answer and the credits used.
Does it remember the conversation?
Yes. Pass the earlier turns as history, or let a saved conversation keep them for you.
How is it priced?
By the length of each answer, with a minimum per call, and never for a failed answer. See the prices per endpoint.
Guides
Read next
Start building with the Astrology Chat API
5,000 free trial credits. No card required.

