POSTalphaChart Calculation

Lunar Phase

Return first-party Sun-Moon lunar phase context for a supplied moment and location without horoscope prose or third-party fallback.

POST /v1/lunar/phaseQuickstartOpenAPI JSON
Credits

1 credit per lookup

Minimum Plan

Core Compute+

Billing Lane

No AI core

SDK Helper

lunarPhase / lunar_phase

Inputs
  • +datetime
  • +location or coordinates
  • +house system
Outputs
  • +lunar phase
  • +Sun position
  • +Moon position
  • +calculation basis
Tool Functions

Capabilities behind this endpoint

3 functions
lunar.phase.calculate

Calculates lunar phase from owned Sun and Moon positions.

planet.positions.list

Returns the Sun and Moon positions that produced the phase.

calculation.basis.report

Reports the owned western calculation basis and unsupported lanes.

Lunar Phase request
{
  "datetime": "2026-06-17T12:00:00.000Z",
  "location": "Greenwich, GB"
}
Lunar Phase response
{
  "request_id": "req_...",
  "data": {
    "datetime": "2026-06-17T12:00:00.000Z",
    "calculation_basis": {
      "provider": "owned_western",
      "frame": "geocentric",
      "zodiac": "tropical"
    },
    "lunar_phase": {},
    "chart": { "sun": {}, "moon": {} }
  },
  "usage": { "lane": "core", "credits": 1, "billableUnits": 1 }
}
curl
curl https://theleokingai.com/api/v1/lunar/phase \
  -X POST \
  -H "Accept: application/json" \
  -H "x-api-key: $LEOKING_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: lunar-phase-subject-123-v1" \
  -d '{
  "datetime": "2026-06-17T12:00:00.000Z",
  "location": "Greenwich, GB"
}'
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.lunarPhase(
  {
  "datetime": "2026-06-17T12:00:00.000Z",
  "location": "Greenwich, GB"
},
  "lunar-phase-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.lunar_phase(
    {
        "datetime": "2026-06-17T12:00:00.000Z",
        "location": "Greenwich, GB",
    },
    idempotency_key="lunar-phase-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
Transit Chart Calculation
/v1/charts/transits
POSTalpha
Current Sky
/v1/charts/current-sky