← AI Astrologer engine/AI Astrologer
POST/v1/chat/respond

Chat · Respond API

Generate an emotionally intelligent, astrology-grounded response.

Get free API keyTry in playgroundFull schema in docs ↗

About the engine

Part of the AI Astrologer engine

A conversational layer over the astrology engine. Every response is anchored in a deterministic chart context — not a generic chatbot — and gated by a defense-in-depth safety layer that intercepts medical, financial, and self-harm prompts. Multi-turn memory, tone + confidence labels, and structured remedies on every reply.

Request

Try it from the command line

curl -X POST https://api.astronode.dev/v1/chat/respond \
  -H 'Authorization: Bearer aie_test_YOUR_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
  "conversation_id": "demo-conv-01",
  "user": {
    "date": "1973-04-24",
    "time": "17:25:00",
    "tz_offset_minutes": 330,
    "lat": 19.076,
    "lng": 72.8777
  },
  "message": "I keep second-guessing my career decisions. What's that about?"
}'

All AstroNode endpoints require a bearer token from your dashboard. Test keys (`aie_test_*`) are free up to 100 calls/month.

Response

What you get back

Every AstroNode response uses the same envelope:request_id,data (the endpoint-specific payload),interpretation (optional narrative block), andmeta (engine version + computed_at timestamp). The exact data schema for POST /v1/chat/respond is published in the OpenAPI 3.1 spec under /docs.

Engine highlights

What the AI Astrologer engine ships

  • Bounded reasoning — every reply grounded in the user's deterministic chart context
  • Multi-turn memory keyed on caller-owned `conversation_id`
  • Defense-in-depth safety layer on input + output (medical / financial / self-harm)
  • Structured `practices` array on every response (planet, kind, summary)
  • Tone (supportive | reflective | grounded | calm | neutral) and confidence (low | moderate | high) labels
  • Optional `partner` block triggers compatibility-aware reasoning

Related endpoints

Other AI Astrologer endpoints

GET/v1/auth/whoami

Diagnostic — confirms the Bearer token is recognized by the chat service.

GET/v1/health

Liveness probe (public, no auth).

Ready to call POST /v1/chat/respond?

Free tier covers 100 requests / month. Razorpay-billed, GST-compliant invoices when you upgrade.

Get free API keyTry in playground

Informational, not predictive. Not medical, legal, or financial advice.