astrom8
Endpoints

Tarot + LLM

Three production tarot endpoints — daily card, three-card spread, and ten-card Celtic Cross — Thai-style readings from our managed LLM pipeline with automatic failover when the primary model is unavailable.

What you can build

  • LINE OA tarot bot drawing daily cards for users
  • Premium tarot reading subscription — 3-card or Celtic Cross on demand
  • Twitch/livestream tarot reader companion app

Endpoints in this category

POST /api/v3/tarot/cards/daily Free 1 credits/call

Daily Tarot Card

Deterministic single-card draw per date and locale — same user gets the same card on the same day. Includes orientation (upright/reversed) and static meanings.

Show sample request
Sample request body
{
  "date": "2026-05-09",
  "locale": "th"
}
POST /api/v3/tarot/reports/three-card Starter 2 credits/call

Three-Card Spread

Past / Present / Future spread with three distinct random draws and structured JSON interpretation from our LLM pipeline. Returns 503 if no LLM key, 502 on unusable model output — no credit charged on failure.

Show sample request
Sample request body
{
  "question": "What does my next month look like?",
  "locale": "th"
}
POST /api/v3/tarot/reports/celtic-cross Business 3 credits/call

Celtic Cross

Classic ten-card Celtic Cross spread with full structured JSON interpretation from our LLM pipeline. Same fail-safe semantics as three-card — no credit charge on LLM failure.

Show sample request
Sample request body
{
  "question": "Should I take the new job offer?",
  "locale": "en"
}

Other categories