POSTalphaChart Calculation

Transit Chart Calculation

Return geocentric tropical transit positions and aspects from the owned sidecar for timing, daily horoscope, and ephemeris workflows.

POST /v1/charts/transitsQuickstartOpenAPI JSON
Credits

2 credits per chart

Minimum Plan

Core Compute+

Billing Lane

No AI core

SDK Helper

transitChart / transit_chart

Inputs
  • +transit datetime
  • +transit location
  • +max aspects
Outputs
  • +transit chart
  • +ranked aspects
  • +calculation basis
  • +sidecar metadata
Tool Functions

Capabilities behind this endpoint

5 functions
chart.transits.calculate

Computes the current or requested transit chart.

transit.positions.list

Returns planet positions when provided by the sidecar.

transit.aspects.rank

Returns sidecar aspect data up to the requested cap.

mundane.signal.seed

Supplies verified ephemeris context for world signal forecasts.

daily.horoscope.seed

Supplies owned transit substrate for daily horoscope products.

Current Transits request
{
  "transit_datetime": "2026-06-17T12:00:00.000Z",
  "transit_location": "Greenwich, GB",
  "max_aspects": 30
}
Current Transits response
{
  "request_id": "req_...",
  "data": {
    "transit_datetime": "2026-06-17T12:00:00.000Z",
    "transit_location": "Greenwich, GB",
    "calculation_basis": {
      "frame": "geocentric",
      "zodiac": "tropical",
      "system": "Kerykeion sidecar"
    },
    "chart": { "planets": [], "aspects": [] },
    "aspects": []
  },
  "usage": { "lane": "core", "credits": 2, "billableUnits": 1 }
}
curl
curl https://theleokingai.com/api/v1/charts/transits \
  -X POST \
  -H "Accept: application/json" \
  -H "x-api-key: $LEOKING_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: transit-chart-subject-123-v1" \
  -d '{
  "transit_datetime": "2026-06-17T12:00:00.000Z",
  "transit_location": "Greenwich, GB",
  "max_aspects": 30
}'
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.transitChart(
  {
  "transit_datetime": "2026-06-17T12:00:00.000Z",
  "transit_location": "Greenwich, GB",
  "max_aspects": 30
},
  "transit-chart-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.transit_chart(
    {
        "transit_datetime": "2026-06-17T12:00:00.000Z",
        "transit_location": "Greenwich, GB",
        "max_aspects": 30,
    },
    idempotency_key="transit-chart-subject-123-v1",
)

print(result["request_id"])
print(result["usage"]["credits"])
Error Behavior
HTTPCodePartner Action
400INVALID_REQUESTFix the payload shape, enum value, required field, or request body before retrying.
401AUTH_REQUIREDSend x-api-key from a trusted server environment. Do not expose keys in browser code.
401AUTH_INVALIDCheck the key prefix, rotate compromised keys, and verify the target environment.
402CREDITS_EXHAUSTEDUpgrade the plan, add credits, or switch to a lower-cost Core Compute route.
403AUTH_FORBIDDENUse a key scoped for this endpoint or upgrade to the required plan.
404NOT_FOUNDVerify the job id, environment, API key, and whether the job belongs to the same workspace.
409IDEMPOTENCY_CONFLICTReuse idempotency keys only for the same logical operation and identical request payload.
429RATE_LIMITEDBack off, retry later, reduce concurrency, or request enterprise limits.
Related Endpoints
POSTalpha
Natal Chart Calculation
/v1/charts/natal
POSTalpha
Current Sky
/v1/charts/current-sky
POSTalpha
Lunar Phase
/v1/lunar/phase