The Leo King API Docs

{
  "customers": [
    {
      "id": "cust_123",
      "dob": "1990-07-23",
      "tob": "14:30",
      "pob": "New York, US"
    }
  ],
  "campaign_context": {
    "product_category": "relationship coaching membership",
    "tone": "warm direct",
    "channel": "email"
  }
}

{
  "request_id": "req_...",
  "data": {
    "results": [
      {
        "customer_id": "cust_123",
        "personality": {
          "sun_sign": "Leo",
          "buyer_archetype": "premium loyalist"
        },
        "campaign_fit": {
          "score": 0.86,
          "send": true,
          "reasoning": "High receptivity window"
        }
      }
    ]
  },
  "usage": { "lane": "ai", "credits": 2, "billableUnits": 1 },
  "meta": { "chartQuality": [{ "customer_id": "cust_123", "quality": "full_chart" }] }
}

{
  "subject": {
    "id": "user_123",
    "dob": "1990-07-23",
    "tob": "14:30",
    "pob": "New York, US"
  },
  "intent": "future long-term partner",
  "context": {
    "relationship_status": "single",
    "desired_tone": "direct, cinematic, grounded"
  }
}

{
  "request_id": "req_...",
  "data": {
    "partner_archetype": "magnetic builder with public confidence and private loyalty",
    "meeting_scene": {
      "setting": "a work-adjacent creative event",
      "signal": "conversation starts through a practical offer, then turns intimate"
    },
    "timing_windows": [
      { "start": "2026-08-04", "end": "2026-09-12", "confidence": 0.72 }
    ],
    "image_prompt": "premium cinematic future partner portrait..."
  },
  "usage": { "lane": "ai", "credits": 8, "billableUnits": 1 },
  "meta": { "status": "alpha", "requiredSystems": ["geocentric_tropical", "love_5_7_8"] }
}

{
  "question": "Is this connection coming back or should I move on?",
  "subject": { "id": "user_123", "dob": "1990-07-23" },
  "context": {
    "relationship_status": "separated",
    "desired_tone": "clear and compassionate"
  }
}

{
  "request_id": "req_...",
  "data": {
    "answer": "This connection is not fully closed, but the return depends on whether accountability replaces silence.",
    "dynamic": "strong chemistry with weak consistency",
    "next_action": "Do not chase. Ask one direct question and watch behavior, not emotion."
  },
  "usage": { "lane": "ai", "credits": 5, "billableUnits": 1 },
  "meta": { "status": "alpha", "persona": "lady-avalon" }
}

{
  "question": "What is the hidden opportunity around this career change?",
  "topic": "career",
  "style": "cinematic, concise, grounded"
}

{
  "request_id": "req_...",
  "data": {
    "vision": "A black door opens into a gold-lit room where a desk is already waiting.",
    "meaning": "The opportunity is not more searching. It is accepting a role that asks you to be seen.",
    "action": "Say yes to the serious invitation, not the familiar backup plan."
  },
  "usage": { "lane": "ai", "credits": 4, "billableUnits": 1 },
  "meta": { "status": "alpha", "knowledge": ["psychic", "symbols"] }
}

{
  "question": "What is the real opportunity in front of me right now?",
  "birth_date": "1990-07-23",
  "topic": "career",
  "context": { "desired_tone": "direct and grounded" }
}

{
  "request_id": "req_...",
  "data": {
    "answer": "The opportunity is to take the visible role instead of staying behind the buildout.",
    "insight": "The pattern is asking for leadership with cleaner boundaries.",
    "next_action": "Make the direct offer this week and remove the backup option."
  },
  "usage": { "lane": "ai", "credits": 2, "billableUnits": 1 }
}

{
  "question": "What do I need to know about this relationship?",
  "spread_type": "three_card",
  "topic": "love",
  "seed": "partner-reading-001"
}

{
  "request_id": "req_...",
  "data": {
    "spread": {
      "type": "three_card",
      "cards": [
        { "name": "The Lovers", "position": "situation", "orientation": "upright" }
      ]
    },
    "answer": "The connection is real, but the choice must become conscious."
  },
  "usage": { "lane": "ai", "credits": 2, "billableUnits": 1 }
}

{
  "subject": { "id": "user_123", "dob": "1990-07-23" },
  "focus": "soul_mission",
  "question": "What old pattern am I here to complete?"
}

{
  "request_id": "req_...",
  "data": {
    "lifetime_theme": "A life of carrying sacred knowledge while hiding your public voice.",
    "healing_action": "Choose one truth and speak it plainly this week."
  },
  "usage": { "lane": "ai", "credits": 10, "billableUnits": 1 }
}

{
  "subject": {
    "id": "person_a",
    "dob": "1990-07-23",
    "tob": "14:30",
    "pob": "New York, US"
  },
  "partner": {
    "id": "person_b",
    "dob": "1992-11-08",
    "tob": "09:15",
    "pob": "Los Angeles, US"
  },
  "max_aspects": 40
}

{
  "request_id": "req_...",
  "data": {
    "pair_id": "person_a:person_b",
    "calculation_basis": {
      "frame": "geocentric",
      "zodiac": "tropical",
      "system": "owned sidecar"
    },
    "aspects": [],
    "relationship_signals": []
  },
  "usage": { "lane": "core", "credits": 3, "billableUnits": 1 }
}

{
  "subject": { "id": "person_a", "dob": "1990-07-23", "tob": "14:30", "pob": "New York, US" },
  "partner": { "id": "person_b", "dob": "1992-11-08", "tob": "09:15", "pob": "Los Angeles, US" },
  "context": { "relationship_type": "dating" },
  "include_helio_background": false
}

{
  "request_id": "req_...",
  "data": {
    "score": 87,
    "tier": "high",
    "subscores": {
      "romance_5th": 0.82,
      "partnership_7th": 0.9,
      "intimacy_8th": 0.78
    },
    "risk_flags": ["strong attraction requires direct communication"]
  },
  "usage": { "lane": "core", "credits": 4, "billableUnits": 1 }
}

{
  "subject": {
    "id": "subject_123",
    "dob": "1990-07-23",
    "tob": "14:30",
    "pob": "New York, US"
  }
}

{
  "request_id": "req_...",
  "data": {
    "subject_id": "subject_123",
    "calculation_basis": {
      "frame": "geocentric",
      "zodiac": "tropical",
      "system": "Kerykeion sidecar"
    },
    "sun_sign": "Leo",
    "chart": { "planets": [], "houses": [], "aspects": [] }
  },
  "usage": { "lane": "core", "credits": 2, "billableUnits": 1 }
}

{
  "transit_datetime": "2026-06-17T12:00:00.000Z",
  "transit_location": "Greenwich, GB",
  "max_aspects": 30
}

{
  "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 }
}

{
  "sign": "leo",
  "date": "2026-06-17",
  "tone": "premium concise",
  "sections": ["theme", "love", "work", "action"]
}

{
  "request_id": "req_...",
  "data": {
    "sign": "leo",
    "theme": "Choose the room that lets your confidence become useful.",
    "drivers": ["Moon phase", "active Venus-Mars relationship tone"],
    "action": "Make the direct offer instead of waiting for permission."
  },
  "usage": { "lane": "ai", "credits": 1, "billableUnits": 1 }
}

{
  "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
}

{
  "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 }
}

{
  "topic": "markets",
  "window_days": 14,
  "depth": "deep"
}

{
  "request_id": "req_...",
  "data": {
    "forecasts": [
      {
        "headline": "Markets hold a volatile repricing window",
        "forecast_window": {
          "start": "2026-06-17",
          "end": "2026-07-01",
          "specificity": "two-week operational window"
        },
        "confidence": 8
      }
    ]
  },
  "usage": { "lane": "ai", "credits": 5, "billableUnits": 1 },
  "meta": { "ephemeris": { "enabled": true } }
}

{
  "topic": "markets",
  "window_days": 14,
  "depth": "deep"
}

{
  "request_id": "req_...",
  "data": {
    "job_id": "j57...",
    "status": "queued",
    "status_url": "https://api.theleokingai.com/v1/world/signals/jobs/j57...",
    "reserved_credits": 5,
    "poll_after_ms": 2000
  },
  "usage": { "lane": "ai", "credits": 0, "billableUnits": 0 },
  "meta": {
    "billing": "reserved_not_charged_until_complete",
    "worker": "scheduled"
  }
}

{
  "topic": "markets",
  "regions": ["United States", "Europe", "China", "Middle East"],
  "window_days": 30
}

{
  "request_id": "req_...",
  "data": {
    "topic": "markets",
    "hot_zones": [
      { "region": "United States", "score": 82, "signal": "Policy and liquidity stress cluster." }
    ]
  },
  "usage": { "lane": "ai", "credits": 5, "billableUnits": 1 }
}

{
  "event": "A central bank unexpectedly signals a policy reversal while markets are fragile.",
  "event_date": "2026-06-17",
  "topic": "markets",
  "window_days": 30
}

{
  "request_id": "req_...",
  "data": {
    "event_summary": "A policy signal changed market expectations before liquidity stabilized.",
    "confidence": 7,
    "action": "Watch the second reaction, not the first headline."
  },
  "usage": { "lane": "ai", "credits": 4, "billableUnits": 1 }
}

{
  "subjects": [
    { "id": "subject_123", "dob": "1990-07-23" }
  ],
  "context": {
    "use_case": "audience segmentation experiment"
  }
}

{
  "request_id": "req_...",
  "data": {
    "profiles": [
      {
        "subject_id": "subject_123",
        "calculation_basis": {
          "frame": "heliocentric",
          "zodiac": "tropical",
          "prediction_role": "background_evaluation"
        },
        "startype": {
          "pattern_code": "82",
          "pattern_signature": "8-B-TRINESQUARE/18-G-TRINE"
        }
      }
    ]
  },
  "usage": { "lane": "core", "credits": 1, "billableUnits": 1 }
}

{
  "query": "relationship vocation StarTypes pattern",
  "endpoint_target": "compatibility",
  "top_k": 5,
  "rights_bucket": "approved"
}

{
  "request_id": "req_...",
  "data": {
    "chunks": [],
    "credit_line": "Includes interpretive context from Michael Erlewine source materials.",
    "use_policy": "supporting context only"
  },
  "usage": { "lane": "core", "credits": 1, "billableUnits": 1 }
}