POSTalphaIntelligence

Daily Horoscope

Generate personalized daily horoscope output from owned transit substrate, zodiac knowledge, and optional birth profile context.

POST /v1/horoscope/dailyQuickstart OpenAPI JSON

Credits

1 credit per sign or subject

Minimum Plan

Basic+

Billing Lane

Light AI

SDK Helper

dailyHoroscope / daily_horoscope

Inputs

+zodiac sign or birth data
+date
+tone
+delivery channel

Outputs

+daily theme
+transit drivers
+love/career/money notes
+action guidance
+metadata

Tool Functions

Capabilities behind this endpoint

3 functions

horoscope.daily.generate

Generates a daily horoscope without calling external horoscope APIs.

transit.daily.seed

Uses owned transits as the calculation substrate.

zodiac.knowledge.apply

Applies local zodiac knowledge without generic filler.

Daily Horoscope request

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

Daily Horoscope response

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

curl

curl https://theleokingai.com/api/v1/horoscope/daily \
  -X POST \
  -H "Accept: application/json" \
  -H "x-api-key: $LEOKING_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: daily-horoscope-subject-123-v1" \
  -d '{
  "sign": "leo",
  "date": "2026-06-17",
  "tone": "premium concise",
  "sections": ["theme", "love", "work", "action"]
}'

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.dailyHoroscope(
  {
  "sign": "leo",
  "date": "2026-06-17",
  "tone": "premium concise",
  "sections": ["theme", "love", "work", "action"]
},
  "daily-horoscope-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.daily_horoscope(
    {
        "sign": "leo",
        "date": "2026-06-17",
        "tone": "premium concise",
        "sections": [
            "theme",
            "love",
            "work",
            "action",
        ],
    },
    idempotency_key="daily-horoscope-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.