POSTalphaChart Calculation
Current Sky
Return the owned geocentric tropical current-sky chart for a supplied moment and location without calling external astrology APIs.
Credits
1 credit per lookup
Minimum Plan
Core Compute+
Billing Lane
No AI core
SDK Helper
currentSky / current_sky
Inputs
- +datetime
- +location or coordinates
- +house system
- +active points
Outputs
- +planet positions
- +house cusps
- +aspects
- +lunar phase
- +supported and unsupported western lanes
Tool Functions
Capabilities behind this endpoint
chart.current_sky.calculateComputes the live or requested sky through the owned sidecar path.
planet.positions.listReturns selected point positions with sign, degree, house, and retrograde data.
houses.resolveReturns owned house cusps for the selected house system.
lunar.phase.extractReturns the Sun-Moon phase context from the same owned chart.
Current Sky request
{
"datetime": "2026-06-17T12:00:00.000Z",
"location": "Greenwich, GB",
"options": {
"house_system": "placidus",
"zodiac": "tropical"
}
}Current Sky response
{
"request_id": "req_...",
"data": {
"datetime": "2026-06-17T12:00:00.000Z",
"calculation_basis": {
"provider": "owned_western",
"frame": "geocentric",
"zodiac": "tropical"
},
"chart": { "planets": [], "house_cusps": [], "aspects": [] },
"lunar_phase": {}
},
"usage": { "lane": "core", "credits": 1, "billableUnits": 1 }
}curl
curl https://theleokingai.com/api/v1/charts/current-sky \
-X POST \
-H "Accept: application/json" \
-H "x-api-key: $LEOKING_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: current-sky-subject-123-v1" \
-d '{
"datetime": "2026-06-17T12:00:00.000Z",
"location": "Greenwich, GB",
"options": {
"house_system": "placidus",
"zodiac": "tropical"
}
}'Node SDK
import { TheLeoKingApi } from "@theleoking/ai-api";
const api = new TheLeoKingApi({
apiKey: process.env.LEOKING_API_KEY,
baseUrl: "https://theleokingai.com/api"
});
const result = await api.currentSky(
{
"datetime": "2026-06-17T12:00:00.000Z",
"location": "Greenwich, GB",
"options": {
"house_system": "placidus",
"zodiac": "tropical"
}
},
"current-sky-subject-123-v1"
);
console.log(result.request_id);
console.log(result.usage.credits);Python SDK
import os
from theleoking_ai_api import TheLeoKingApi
api = TheLeoKingApi(
api_key=os.environ["LEOKING_API_KEY"],
base_url="https://theleokingai.com/api",
)
result = api.current_sky(
{
"datetime": "2026-06-17T12:00:00.000Z",
"location": "Greenwich, GB",
"options": {
"house_system": "placidus",
"zodiac": "tropical",
},
},
idempotency_key="current-sky-subject-123-v1",
)
print(result["request_id"])
print(result["usage"]["credits"])Error Behavior
| HTTP | Code | Partner Action |
|---|---|---|
| 400 | INVALID_REQUEST | Fix the payload shape, enum value, required field, or request body before retrying. |
| 401 | AUTH_REQUIRED | Send x-api-key from a trusted server environment. Do not expose keys in browser code. |
| 401 | AUTH_INVALID | Check the key prefix, rotate compromised keys, and verify the target environment. |
| 402 | CREDITS_EXHAUSTED | Upgrade the plan, add credits, or switch to a lower-cost Core Compute route. |
| 403 | AUTH_FORBIDDEN | Use a key scoped for this endpoint or upgrade to the required plan. |
| 404 | NOT_FOUND | Verify the job id, environment, API key, and whether the job belongs to the same workspace. |
| 409 | IDEMPOTENCY_CONFLICT | Reuse idempotency keys only for the same logical operation and identical request payload. |
| 429 | RATE_LIMITED | Back off, retry later, reduce concurrency, or request enterprise limits. |
Related Endpoints