Divination API platform · astrology + Mayan Kin · LLM-ready

Ship divination features without becoming an astrologer.

Two divination systems, one API key: full natal charts and the Mayan Kin (Dreamspell/Tzolkin) — as clean JSON and as LLM-ready text. From zero to your first call in minutes.

  • No credit card
  • Free forever tier
  • The first Mayan Kin API
  • MCP-ready for AI agents
POST /v1/birth-chart

{
  "planets": [
    {
      "key": "sun",
      "sign": "Libra",
      "degree_in_sign": "16° 56' 06\"",
      "house": 8,
      "retrograde": false
    }
  ],
  "angles": {
    "ascendant": { "sign": "Aquarius" }
  }
}
From zero to production

Your first call in under 5 minutes

No SDK to learn, no astrology degree required. Create an account, grab a key, POST a date.

01

Create a free account

100 calls/month, no card. You get an API key on the spot.

02

POST your request

A birth date + place for a chart, or just a date for a Kin. Plain HTTPS + JSON — from any language.

03

Ship it

Get structured JSON, or ready-to-prompt text from the -context endpoints. Wire it into your app, bot, or AI agent.

curl https://talismos.com/v1/kin \
  -H "Authorization: Bearer talismos_live_..." \
  -d '{ "date": "2019-07-13", "language": "portuguese" }'

{
  "kin": 1,
  "signature_label": "Dragão Magnético Vermelho",
  "seal": { "label": "Dragão", "maya": "Imix" },
  "is_galactic_activation_portal": true
}

Real request — copy, paste, run.

Why Talismos

The parts that are actually hard, done for you

The calculation is the easy part. What you're really buying is correct, curated, AI-native content — under one key.

The first Mayan Kin API

Everyone else ships a free web calculator. We ship the Dreamspell/Tzolkin signature as a real API — seals, tones, oracle, wavespell, castle, archetype, 13-Moon date.

Built for AI, not just REST

Every system has a -context endpoint returning prompt-ready text, plus a real MCP server so Claude, n8n, and any agent can call it mid-conversation. Meet your users where they already are.

One key, growing surface

Astrology and Kin today, tarot and numerology next — same account, same quota, same clean contract. Integrate once, get every system.

Correct and multilingual

Stable English keys for matching, translated labels in 6 languages, native Maya names. No guesswork, no drift — the docs are generated from the same schemas that validate every request.

Built for people shipping divination products

Validated calculation, a clean JSON contract, and an endpoint designed for generative AI — the same foundation every future Talismos system will share.

Validated calculation

Moshier engine tested against a known reference chart — no surprises with your first customer.

Clean, consistent output

Every chart returns the same predictable shape — planets, houses, angles, and aspects, no guesswork.

LLM-ready

chart-context returns the chart already formatted as text and markdown, ready to become a prompt.

Mayan Kin — new

The first Mayan calendar API: any date's Dreamspell/Tzolkin galactic signature. Same key, same quota.

Transparent quota

See your usage in real time on the dashboard — no surprises on the invoice.

Simple pricing

Start for free. Upgrade only when you need more volume.

Free
Free
100 calls/mo
Get started
Pro
$45/mo
100,000 calls/mo
Get started

Frequently asked questions

What is Talismos?

Talismos is an API platform for divination software. Today it calculates natal charts using the Moshier engine and returns JSON with planets, houses, and aspects — the first of several systems the platform will support.

Does Talismos support tarot or numerology?

Two systems are live today: astrology and the Mayan Kin (Dreamspell/Tzolkin). Tarot and numerology are next on the roadmap — all under the same account and API key.

What is my Kin?

Your Kin is your galactic signature in the Dreamspell/Tzolkin count: a number from 1 to 260 combining one of 20 solar seals with one of 13 galactic tones, plus the oracle, wavespell, castle, archetype, and 13-Moon date. Talismos calculates it from any date — try it free at /en/playground/kin — and is the first API to return it.

Is this the Dreamspell or the historical Maya calendar?

The Kin endpoint uses the Dreamspell / Sincronário da Paz count — José Argüelles' 1987 reinterpretation of the Maya Tzolkin, the same system the Dreamspell / Sincronário da Paz community uses. It is not the historical/archaeological Maya Long Count; we state this plainly for transparency.

Do I need to know astrology to use the API?

No. You send birth date, time, and location, and get back the full natal chart already calculated as JSON.

What sign vocabulary does the API use?

Every planet and point includes both a human-readable sign name (e.g. Libra, Aquarius) and a stable machine key (sign_key) for filtering and logic.

Can I use this to power a chatbot or LLM?

Yes. The /v1/chart-context endpoint returns the natal chart already formatted as text and markdown, ready to become an LLM prompt's context.

How does billing work?

There's a free plan with 100 calls per month. Paid plans (Maker and Pro) raise your monthly call limit.

Start building today — your first 100 calls are free

No credit card, no sales call. Create an account, get your key, and ship your first chart or Kin in minutes.

Create free account