Rider–Waite Tarot

Current status

Rider–Waite Tarot is live. Its public HTTP consultation operation returns a final, sealed result from the tested kernel for each accepted request.

Public consultation

Send POST https://sunterminal.net/api/v1/consult with Content-Type: application/json and an Idempotency-Key header containing a lowercase UUIDv7 issued within the previous 24 hours. No authentication is required.

A minimal one-card request body is {"schema_version":"sun-terminal.consult-request@1","instrument":{"id":"tarot.rider-waite","version":1},"structural_inputs":{}}. structural_inputs.count defaults to 1 and may be from 1 through 78. structural_inputs.position_labels is optional; when present, it must contain exactly count values in the ordered generic sequence position-1 through position-N.

Retrying an identical request with the same key returns the same encounter and result and consumes no new entropy. Reusing the key with different structural input returns HTTP 409 idempotency_conflict.

Question text has no request field. It is not required, accepted, stored, logged, hashed, or sent to another provider.

Rate limit and retention

Sun Terminal applies an anonymous limit of 10 consultation attempts per 60 seconds per connecting IP at each Cloudflare location.

The active retry window is 24 hours from the key's issue time. Sun Terminal's hourly cleanup deletes expired active encounter rows. Cloudflare D1 Time Travel may retain recoverable database history after active deletion.

Draw boundary

The engine fixes a shuffled order of all 78 cards and every card's upright or reversed orientation when a draw begins. Revealed cards come from the beginning of that fixed order.

The engine returns card identities and orientations. It supplies no card meanings, keywords, or interpretations. Interpretation belongs to the caller.

About this page

This is a public description page. It does not begin a draw, contain encounter data, or display a caller's result.

Public references

The developer reference, public schemas, checked examples and complete 78-card identity catalogue document the v1 operation without adding meanings or interpretation.