Quickstart
Your first calculation in under five minutes — no card required.
1. Get a trial key
Sign up — every new account immediately receives a trial API key (prefix ak_), good for 5,000 requests or 14 days, whichever comes first. No card required. The raw key is shown exactly once; store it somewhere safe.
2. Make your first call
All nine planetary positions for someone born in New Delhi on 15 January 1990 at 10:30 local time:
curl -X POST https://api.astroask.app/v1/planets \
-H "X-API-Key: ak_your_key_here" \
-H "Content-Type: application/json" \
-d '{ "date": "1990-01-15T10:30:00", "lat": 28.6139, "lng": 77.2090 }'The date is local time at the given coordinates — the API resolves the timezone from lat/lng and converts to UT internally. No timezone math on your side.
3. Read the response
{
"success": true,
"data": {
"planets": [
{
"planet": "Sun",
"sign": 9,
"signName": "Capricorn",
"degreeInSign": 1.0633192175531576,
"longitude": 271.06331921755316,
"nakshatra": "Uttarashadha",
"nakshatraPada": 2,
"house": 11,
"speed": 1.0182561000279526,
"isRetrograde": false,
"dignity": "Enemy Sign"
},
"… 8 more grahas …"
]
}
}Numbers are real JSON numbers at full double precision. If you need less precision, round on your side — the API never throws information away.
4. Compose a full chart with /batch
Every endpoint computes exactly one thing, and every call costs exactly one request — that's the whole pricing model. When you want a complete birth chart, assemble the pieces in one HTTP request with /batch:
curl -X POST https://api.astroask.app/v1/batch \
-H "X-API-Key: ak_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"requests": [
{ "path": "/ascendant", "body": { "date": "1990-01-15T10:30:00", "lat": 28.6139, "lng": 77.2090 } },
{ "path": "/planets", "body": { "date": "1990-01-15T10:30:00", "lat": 28.6139, "lng": 77.2090 } },
{ "path": "/houses/vedic", "body": { "date": "1990-01-15T10:30:00", "lat": 28.6139, "lng": 77.2090 } },
{ "path": "/panchanga", "body": { "date": "1990-01-15T10:30:00", "lat": 28.6139, "lng": 77.2090 } }
]
}'Up to 50 calls fit in one batch; results come back in order, one envelope per item, and each item costs one request.
5. Where next
- API reference — all endpoint families with schemas and live examples.
- Rate limits & quotas — how metering works and the headers to watch.
- Chart rendering — SVG and PNG chart images.