Astro ChatBot API
Introducing the Astro ChatBot API, a simple and reliable way to let users ask any astrology question in plain language and get one grounded, chart-based answer back. You send a question and the person's birth details; DivineAPI fetches and compresses their chart, and streams back an answer written for a reader, not a developer. This API is designed for websites, mobile apps, chatbots, CRM dashboards, or astrology portals that want a conversational astrology experience instead of static reports.
It supports seven endpoints: one to ask a question inside a stored conversation, four to manage and inspect those conversations and your account, and one liveness check.
API Endpoint
POST https://ask.divineapi.com/balanceGuide: Wallet balance and lifetime usage. No question is asked and nothing is charged. Returns your account name, remaining balance in rupees, total requests, total charged, and how many were blocked by a guardrail and therefore free.
Authentication
Every request requires two headers:
| Header | Description |
|---|---|
Authorization | Bearer {api_acc_token} - identifies the user |
x-api-key | Use api_key |
Headers
| Name | Type | Description |
|---|---|---|
Content-Type* | String | application/json. Example: Content-Type: application/json |
Fields marked with * are mandatory.
200: OK Answered Successfully
{
"state": "active",
"credits_remaining": 91900,
"expires": "2033-08-09"
}Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location --request POST 'https://ask.divineapi.com/balance' \
--header 'Authorization: Bearer {api_acc_token}' \
--header 'x-api-key: {api-key}'