The Leo King Business API

A dedicated API surface for audience intelligence, campaign timing, and Beyond The Veil world signal workflows. Built on owned routes, deterministic context, and production quality gates.

Open API ConsoleView OpenAPI JSONRead DocsRequest API Access
Pilot Status
Production-quality preview stack
Live Preview
ProviderOpenAI Responses
Modelgpt-5.4-mini
Usage LedgerConvex HTTP
Helio PatternsMichael Erlewine StarTypes lookup
EphemerisRequired for world signals
API Contract/api/v1/openapi

Business Endpoints

Three clean public names sit on top of the production API contracts.

POST/api/v1/audience/insights

Audience Insights

Turns customer birth data and campaign context into buyer archetypes, timing windows, and send/no-send campaign fit.

Inputs

  • +Customer IDs
  • +Birth dates
  • +Campaign context
  • +Tone and channel

Outputs

  • +Audience archetype
  • +Campaign fit
  • +Personalized timing
  • +Recommended message angle
2 credits per customer
Request
{
  "customers": [
    {
      "id": "customer_001",
      "dob": "1990-07-23"
    }
  ],
  "campaign_context": {
    "product_category": "premium astrology membership",
    "tone": "direct and premium",
    "channel": "email"
  }
}
Response
{
  "request_id": "req_...",
  "data": {
    "results": [
      {
        "customer_id": "customer_001",
        "campaign_fit": {
          "send": true,
          "reason": "High receptivity window"
        }
      }
    ]
  },
  "usage": { "credits": 2 },
  "meta": { "model": "gpt-5.4-mini" }
}
POST/api/v1/world/signals

World Signals

Generates Beyond The Veil style world signal intelligence with deterministic ephemeris context, local RAG, and quality gates.

Inputs

  • +Topic
  • +Forecast window
  • +Depth
  • +BTV article context

Outputs

  • +Forecast headline
  • +Timing window
  • +Signature stack
  • +Historical analog
  • +Ephemeris metadata
5 credits per forecast
Request
{
  "topic": "markets",
  "window_days": 7,
  "depth": "surface"
}
Response
{
  "request_id": "req_...",
  "data": {
    "forecasts": [
      {
        "headline": "Markets hold a volatile repricing window",
        "confidence": "moderate"
      }
    ]
  },
  "usage": { "credits": 5 },
  "meta": {
    "model": "gpt-5.4-mini",
    "ephemeris": { "enabled": true }
  }
}
POST/api/v1/helio/patterns

Helio Patterns

Runs a dedicated heliocentric tropical StarTypes lookup that credits Michael Erlewine's contributions, source work, and interpretation layer as a background signal for experiments, segmentation, and comparison.

Inputs

  • +Subject IDs
  • +Birth dates
  • +Experiment context
  • +Date-level helio lookup

Outputs

  • +StarTypes pattern code
  • +Pattern signature
  • +Helio/tropical basis
  • +Michael Erlewine source attribution
  • +Background-use guardrails
1 credit per subject
Request
{
  "subjects": [
    {
      "id": "subject_001",
      "dob": "1990-07-23"
    }
  ],
  "context": {
    "use_case": "segmentation experiment"
  }
}
Response
{
  "request_id": "req_...",
  "data": {
    "profiles": [
      {
        "subject_id": "subject_001",
        "calculation_basis": {
          "frame": "heliocentric",
          "zodiac": "tropical",
          "prediction_role": "background_evaluation"
        }
      }
    ]
  },
  "usage": { "credits": 1 },
  "meta": {
    "model": "startypes-short-helio-ephemeris-v1"
  }
}

Route Map

The web page, API index, and schema stay separate so the product can scale cleanly.

Public UI
/api-platform

Business-facing API overview, endpoint cards, sample payloads, and access CTA.

API Index
/api/v1

Machine-readable endpoint index for authenticated API clients.

OpenAPI
/api/v1/openapi

OpenAPI JSON contract for client generation, docs, and partner integration.

Developer Docs
/api-docs

Public integration guide with auth, credits, request examples, and error envelopes.

API Console
/api-console

Protected customer dashboard for Clerk login, usage tracking, key prefixes, and credits.

Built for Controlled Pilots

This API is meant to be sold and scaled carefully: scoped keys, explicit credit usage, deterministic context, post-deploy output review, and no degraded fallback content.

1

Request Pilot Access

We create a scoped API key, endpoint allowance, and credit budget for the partner use case.

2

Integrate Against OpenAPI

Use the JSON schema and sample payloads to wire a server-to-server request with idempotency.

3

Inspect Live Output

Every deploy is smoke-tested with fresh API output before pilot traffic is expanded.

Production Guardrails

Owned API routes, not AstrologyAPI

OpenAI Responses provider with gpt-5.4-mini

StarTypes is isolated in its own heliocentric tropical endpoint with Michael Erlewine attribution

Kerykeion sidecar required for world signal ephemeris context

Local Erlewine and BTV RAG files are explicit deploy requirements

Usage events are logged through Convex for pilot metering

No silent fallback model path when generation fails

Ready to build on spiritual intelligence?

Start with a pilot key, one endpoint, one measurable workflow, and live output review before scaling.

Request API PilotOpen ConsoleView SLM Platform