Celtic Cross Spread

Full 10-card Celtic Cross spread — traditional ten-position tarot spread. Positions: present, challenge, root, past, possible outcome, near future, self, external influences, hopes and fears, final outcome. Returns each card with its spread position, position meaning, and active interpretation for the drawn orientation.

Endpoint

POST /v1/tarot/spread/celtic-cross

Request parameters

Field	Type	Required	Description
allow_reversed	boolean	No	If true, each card has a 50% chance of appearing reversed.
question	string | null	No	Optional question or intention for the reading.

Example request

curl

curl -X POST "https://api.asterwise.com/v1/tarot/spread/celtic-cross" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"allow_reversed":true,"question":"What is unfolding in my career?"}'

Python

import asterwise
from asterwise.api.tarot_api import TarotApi
from asterwise.models.spread_request import SpreadRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = SpreadRequest(
    allow_reversed=True,
    question="What is unfolding in my career?",
)

with asterwise.ApiClient(configuration) as client:
    api = TarotApi(client)
    result = api.tarot_celtic_cross(spread_request=request)
    print(result)

TypeScript

import { createClient, createConfig, tarotCelticCross } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await tarotCelticCross({
  client,
  body: {
      "allow_reversed": true,
      "question": "What is unfolding in my career?"
  },
});

console.log(result.data);

Example response

{
  "success": true,
  "message": "success",
  "data": {
    "spread_type": "celtic_cross",
    "positions": [
      {
        "card": {
          "id": "nine-of-cups",
          "name": "Nine of Cups",
          "arcana_type": "minor",
          "suit": "cups",
          "number": 9,
          "element": "water",
          "astrology_correspondence": "Jupiter in Pisces",
          "keywords_upright": [
            "contentment",
            "satisfaction",
            "... and 3 more items"
          ],
          "keywords_reversed": [
            "inner happiness",
            "materialism",
            "... and 2 more items"
          ],
          "upright_meaning": "The Nine of Cups — the Wish Card — signals emotional contentment and the fulfilment of desires. Satisfaction and pleasur…",
          "reversed_meaning": "Reversed, the Nine of Cups warns that outer satisfaction masks inner emptiness. True contentment comes from within, not…",
          "yes_no": "yes",
          "description": "A self-satisfied man sits before a curved display of nine cups on a cloth-covered table. His arms are crossed, his expre…"
        },
        "is_reversed": true,
        "position": "present",
        "position_meaning": "The present — the central issue or situation",
        "active_meaning": "Reversed, the Nine of Cups warns that outer satisfaction masks inner emptiness. True contentment comes from within, not…",
        "active_keywords": [
          "inner happiness",
          "materialism",
          "... and 2 more items"
        ]
      },
      {
        "card": {
          "id": "five-of-wands",
          "name": "Five of Wands",
          "arcana_type": "minor",
          "suit": "wands",
          "number": 5,
          "element": "fire",
          "astrology_correspondence": "Saturn in Leo",
          "keywords_upright": [
            "conflict",
            "competition",
            "... and 3 more items"
          ],
          "keywords_reversed": [
            "avoiding conflict",
            "respecting differences",
            "... and 1 more item"
          ],
          "upright_meaning": "The Five of Wands represents conflict, competition, and differing viewpoints creating friction. The challenge may be ext…",
          "reversed_meaning": "Reversed, the Five of Wands suggests tension releasing, conflict being avoided, or finally finding common ground after a…",
          "yes_no": "maybe",
          "description": "Five young men brandish wands at one another in apparent conflict. Their expressions and postures vary. The scene looks…"
        },
        "is_reversed": true,
        "position": "challenge",
        "position_meaning": "The challenge — what crosses or complicates the situation",
        "active_meaning": "Reversed, the Five of Wands suggests tension releasing, conflict being avoided, or finally finding common ground after a…",
        "active_keywords": [
          "avoiding conflict",
          "respecting differences",
          "... and 1 more item"
        ]
      },
      "... and 8 more items"
    ],
    "question": "What is unfolding in my career?"
  }
}

Response fields

Field	Type	Description
success	boolean	True if the request succeeded
message	string	Human-readable status message
data	object
data.spread_type	string	Spread type: 'three_card' or 'celtic_cross'
data.positions	array[object]
data.positions[].card	object
data.positions[].card.id	string	Unique slug identifier e.g. 'the-fool'
data.positions[].card.name	string	Full card name e.g. 'The Fool'
data.positions[].card.arcana_type	string	'major' or 'minor'
data.positions[].card.suit	string | null	Suit for minor arcana: wands, cups, swords, pentacles. Null for major arcana.
data.positions[].card.number	integer	Card number. Major arcana: 0-21. Minor arcana: 1=Ace, 11=Page, 12=Knight, 13=Queen, 14=King.
data.positions[].card.element	string	Elemental correspondence: fire, water, air, earth, spirit
data.positions[].card.astrology_correspondence	string	Astrological planet or sign correspondence
data.positions[].card.keywords_upright	array[string]	Upright keywords
data.positions[].card.keywords_reversed	array[string]	Reversed keywords
data.positions[].card.upright_meaning	string	Full upright interpretation
data.positions[].card.reversed_meaning	string	Full reversed interpretation
data.positions[].card.yes_no	string	Yes/No polarity: 'yes', 'no', or 'maybe'
data.positions[].card.description	string	Visual description of the card imagery
data.positions[].is_reversed	boolean	True if the card was drawn in reversed orientation
data.positions[].position	string | null	Spread position name e.g. 'past', 'present', 'outcome'
data.positions[].position_meaning	string | null	What this spread position represents
data.positions[].active_meaning	string	The meaning to apply — upright_meaning when is_reversed=False, reversed_meaning when True
data.positions[].active_keywords	array[string]	Active keywords for this orientation
data.question	string | null	The question posed, if provided

Errors

Code	Description	Reference
authentication_failed	Missing or invalid API key.	authentication_failed
ephemeris_unavailable	Upstream ephemeris service error.	ephemeris_unavailable
insufficient_tier	API key tier does not include this endpoint.	insufficient_tier
internal_error	Unexpected server error.	internal_error
ip_rate_limit_exceeded	Too many requests in a short window.	ip_rate_limit_exceeded
payload_too_large	Request body exceeds the size limit.	payload_too_large
resource_not_found	Referenced resource was not found.	resource_not_found
validation_error	Request body failed schema validation.	validation_error

Related endpoints

• Three-Card Spread
• Yes/No Tarot Reading