POSTalphaIntelligence

Timing Windows

Generate practical timing windows for launches, love, career, money, content, and spiritual work using owned transit substrate.

POST /v1/timing/windowsQuickstart OpenAPI JSON

Credits

3 credits per run

Minimum Plan

Basic+

Billing Lane

Light AI

SDK Helper

timingWindows / timing_windows

Inputs

+topic
+date range
+objective
+optional birth data
+max windows

Outputs

+ranked windows
+astrology signal
+best use
+caution
+strategy

Tool Functions

Capabilities behind this endpoint

3 functions

timing.windows.generate

Generates date-bounded timing windows.

transit.window.seed

Uses owned transit context at the start of the range.

strategy.timing.apply

Converts astrology into operational strategy.

Launch Windows request

{
  "topic": "launch",
  "start_date": "2026-06-17",
  "end_date": "2026-07-17",
  "objective": "Find the best window to announce a paid API beta",
  "max_windows": 3
}

Launch Windows response

{
  "request_id": "req_...",
  "data": {
    "topic": "launch",
    "windows": [
      { "start": "2026-06-21", "end": "2026-06-24", "title": "Visibility push", "confidence": 0.74 }
    ],
    "strategy": "Lead with the strongest proof and keep the offer narrow."
  },
  "usage": { "lane": "ai", "credits": 3, "billableUnits": 1 }
}

curl

curl https://theleokingai.com/api/v1/timing/windows \
  -X POST \
  -H "Accept: application/json" \
  -H "x-api-key: $LEOKING_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: timing-windows-subject-123-v1" \
  -d '{
  "topic": "launch",
  "start_date": "2026-06-17",
  "end_date": "2026-07-17",
  "objective": "Find the best window to announce a paid API beta",
  "max_windows": 3
}'

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.timingWindows(
  {
  "topic": "launch",
  "start_date": "2026-06-17",
  "end_date": "2026-07-17",
  "objective": "Find the best window to announce a paid API beta",
  "max_windows": 3
},
  "timing-windows-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.timing_windows(
    {
        "topic": "launch",
        "start_date": "2026-06-17",
        "end_date": "2026-07-17",
        "objective": "Find the best window to announce a paid API beta",
        "max_windows": 3,
    },
    idempotency_key="timing-windows-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.