First API call in 60 seconds
Get a key, fire a request, read a full multi-tradition chart. That's it.
1
Create your API key
Run the operator CLI (or ask your team admin for a key):
Terminal
npx tsx scripts/manage-keys.ts create --scope b2b --name my-app --plan freeThe plaintext key prints exactly once — store it in your server env, never in client code.
2
Send your first request
cURL
curl -X POST https://astro-vibe-engine.gauravapproved.workers.dev/v1/vedic/planetary-positions \
-H 'X-API-Key: av_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{
"datetime": "1990-05-15T12:00:00Z",
"latitude": 28.6139,
"longitude": 77.209,
"timezone": "Asia/Kolkata"
}'One call returns the whole profile: Vedic (lagna, rashi, nakshatra, dasha, vargas), Western (signs, houses, aspects), Chinese (BaZi + ZiWei) and Numerology — plus every resolved rule.
3
Use the TypeScript SDK
TypeScript
import { AstroClient } from "@astrovibe/client";
const astro = new AstroClient({ apiKey: process.env.ASTRO_API_KEY });
const dasha = await astro.generateDashaTimeline({
datetime: "1990-05-15T12:00:00Z",
latitude: 28.6139,
longitude: 77.209,
timezone: "Asia/Kolkata",
system: "VIMSHOTTARI",
});
console.log(dasha.periods.currentMahadasha); // Current mahadashaTyped inputs and outputs, standardized auth and errors. See the SDK page for install and more examples.