Card readings: 4 decks, spreads, card encyclopedia, yes/no, daily card, astro-tarot — Hindi + English in every response.
Get a free API key Try it in the playground
curl -X POST https://api.grahaapi.com/v1/tarot/astro-tarot \
-H "Authorization: Bearer sk-test-your-key" \
-H "Content-Type: application/json" \
-d '{"birth_chart":{"dob":"1990-06-15","lat":28.6139,"lon":77.209,"tob":"10:30","tz":5.5},"deck":"rider_waite","question":"What does my future hold?","spread":"three_card"}'Test keys (sk-test-…) are free and unlimited — the response structure is guaranteed identical to production, so you can build your whole integration before paying anything.
| Endpoint | What it returns |
|---|---|
| POST /v1/tarot/astro-tarot | Map natal planets to their corresponding Tarot Major Arcana. |
| GET /v1/tarot/card/{card_id} | Full encyclopedia entry for one card — general / more / reversed / associations tabs. |
| GET /v1/tarot/cards | Browse/filter cards — powers an encyclopedia UI. All filters combinable; `q` searches names. |
| POST /v1/tarot/celtic-cross | 10-card Celtic Cross spread — comprehensive life reading. |
| POST /v1/tarot/daily | Daily card — deterministic based on today's date (same card all day). |
| GET /v1/tarot/deck/{deck_name}/cards | List all cards in a specific tarot deck. |
| GET /v1/tarot/decks | List all supported tarot decks with metadata. |
| POST /v1/tarot/draw | Draw cards for the requested spread type. |
| GET /v1/tarot/encyclopedia | Encyclopedia index — browse categories (type, suit, number, court, element, planet, zodiac, symbol, color) with values and card counts. |
| POST /v1/tarot/full | Full tarot reading: daily card, three-card spread (past/present/future), and yes/no answer. |
| POST /v1/tarot/interpretation | Detailed interpretation of a specific card by name or ID. |
| POST /v1/tarot/single | Single card reading — focused answer to a question. |
| POST /v1/tarot/three-card | Past / Present / Future three-card spread. |
| POST /v1/tarot/yes-no | Yes/No tarot reading based on drawn card. |
Card readings: 4 decks, spreads, card encyclopedia, yes/no, daily card, astro-tarot. Every response is JSON with both Hindi and English strings, computed astronomically on the Lahiri ayanamsa (the Indian government standard). This module has 14 endpoints.
Yes — sk-test- keys are free and unlimited, and return the exact production response structure (computed from a fixed sample chart). The Free plan then gives 1,000 real API calls per month with no credit card.
Simple INR pricing: Free (1,000 calls/mo), then paid plans from ₹499/mo. One call = one call on every endpoint — no credit system. Paid plans are throttled over quota, never blocked.
Full interactive reference for all 237 endpoints: GrahaAPI Docs · Plain-language explainers: Wiki