Vedika Developer Docs

Build spiritual-intelligence features on a single API — deterministic astrology math plus a grounded natural-language reading engine. Start here.

Vedika Developer Platform

#What Vedika gives you

Vedika is a spiritual-intelligence API: 700+ operations across 25 systems and 23 domains, from deterministic Vedic, Western and KP chart math to a grounded natural-language AI Query engine that answers questions from a computed birth chart. One API key, one base URL, predictable per-call pricing.

QuickstartYour first API call in minutes — curl, Python or Node.Model CatalogThe four delivery tiers: Eco, Standard, Swift, Pro Ultra.AI QueryNatural-language readings grounded in a real chart.PricingWallet plans and per-call rates. No free tier; free sandbox.All EndpointsEvery operation family, grouped and counted.SDKsOfficial Python and Node clients.

#Base URL & authentication

All requests go to https://api.vedika.io over HTTPS. Authenticate with your API key on either header — both are accepted:

x-api-key: vk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Authorization: Bearer vk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Key prefixUse
vk_live_Production (retail plans)
vk_ent_Enterprise
vk_test_Rejected on production — the keyless mock sandbox is used for testing instead
Tip
Test everything free, with no key, at vedika.io/sandbox/* — mock data, no wallet charge. Production keys start at the Starter plan.

#Your first call

Ask the AI Query engine a plain-language question grounded in a birth chart:

curl -s https://api.vedika.io/api/v1/astrology/query \
  -H "x-api-key: $VEDIKA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Which career field suits me best?",
    "birthDetails": {
      "datetime": "1990-05-15T10:30:00",
      "latitude": 28.6139, "longitude": 77.2090,
      "timezone": "Asia/Kolkata"
    }
  }'
import os, requests

r = requests.post(
    "https://api.vedika.io/api/v1/astrology/query",
    headers={"x-api-key": os.environ["VEDIKA_KEY"]},
    json={
        "question": "Which career field suits me best?",
        "birthDetails": {
            "datetime": "1990-05-15T10:30:00",
            "latitude": 28.6139, "longitude": 77.2090,
            "timezone": "Asia/Kolkata",
        },
    }, timeout=180,
)
data = r.json()
print(data["answer"])
print(data["metadata"]["cost"], data["metadata"]["usage"])
const r = await fetch(
  "https://api.vedika.io/api/v1/astrology/query",
  {
    method: "POST",
    headers: {
      "x-api-key": process.env.VEDIKA_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      question: "Which career field suits me best?",
      birthDetails: {
        datetime: "1990-05-15T10:30:00",
        latitude: 28.6139, longitude: 77.2090,
        timezone: "Asia/Kolkata",
      },
    }),
  },
);
const data = await r.json();
console.log(data.answer);
console.log(data.metadata.cost, data.metadata.usage);

#Where to go next

NextQuickstart