API v1 · développeurs et assistants · calculer_theme

Calculer un thème

Calcule un thème avec le site, à la minute : en occidental (le défaut), en védique, ou les deux dans le même appel pour les croiser. Occidental : les planètes en signes et en maisons, les angles, les aspects avec leurs orbes, les dominantes. Védique : le D1 et les cartes divisionnelles choisies selon la question (une, plusieurs ou toutes), chacune avec son Ascendant, ses positions en signes entiers, ses nakshatras et padas et la précision d’heure qu’elle demande ; les karakas de Jaimini, le Karakamsha, la période de Vimshottari en cours. Jamais la naissance.

Ce qu’il reçoit

Une naissance : date (exigée), heure, ville ou lat et lon, pays, tz, prenom.

Les options

Option	Valeurs	Défaut	Ce qu’elle fait
`zodiaque`	`tropical`, `vedique`, `les_deux`	`tropical`	« tropical » (l’astrologie occidentale, le défaut), « vedique » (le zodiaque sidéral, ayanamsa Lahiri, maisons en signes entiers), ou « les_deux » (l’occidental et le védique dans le même appel, pour les croiser).
`maisons`	`defaut`, `placidus`, `egales`, `signes-entiers`	`defaut`	Le système de maisons de l’occidental : « defaut » (celui du thème, Placidus d’habitude), « placidus », « egales » ou « signes-entiers ».
`blocs`	une liste parmi `positions`, `angles`, `maisons`, `aspects`, `dominantes`, `lune`	vide	Les blocs de l’occidental à renvoyer : « positions », « angles », « maisons » (les cuspides), « aspects », « dominantes », « lune » (sa phase) ; [] : positions, angles, aspects et dominantes.
`cartes`	une liste parmi `D1`, `D2`, `D3`, `D4`, `D5`, `D6`, `D7`, `D8`, `D9`, `D10`, `D11`, `D12`, `D16`, `D20`, `D24`, `D27`, `D30`, `D40`, `D45`, `D60`, `toutes`	vide	En védique : les cartes divisionnelles à renvoyer, une (« D9 »), plusieurs (« D9 », « D10 », « D60 ») ou « toutes » (les vingt, du D1 au D60), choisies selon la question (D9 l’amour et l’âme, D10 le métier, D2 l’argent, D7 les enfants, D20 la vie spirituelle, D24 les études, D60 le karma) ; le D1 est toujours là ; [] : le D1 seul.

L’appeler

En GET

https://montheme.fr/api/v1/calculer_theme?date=1990-05-12&heure=14:30&ville=Lyon&pays=FR&prenom=Camille&zodiaque=les_deux&cartes=D9,D10

En POST, avec un corps JSON

POST https://montheme.fr/api/v1/calculer_theme
Content-Type: application/json

{
  "naissance": {
    "date": "1990-05-12",
    "heure": "14:30",
    "ville": "Lyon",
    "pays": "FR",
    "prenom": "Camille"
  },
  "zodiaque": "les_deux",
  "cartes": [
    "D9",
    "D10"
  ]
}

Avec le serveur MCP (outil `calculer_theme`)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "calculer_theme",
    "arguments": {
      "birth": {
        "date": "1990-05-12",
        "time": "14:30",
        "city": "Lyon",
        "country": "FR",
        "name": "Camille"
      },
      "zodiaque": "les_deux",
      "cartes": [
        "D9",
        "D10"
      ],
      "language": "fr"
    }
  }
}

Ce qu’il rend

La réponse contient outil, version, partage.lien (la page du thème sur le site, à donner à la personne), et resultat, dont voici les clés :

Clé	Type
`zodiaque`	string
`tropical`	object
`vedique`	object

Ce que rend cet exemple (le début), calculé par le site au moment de la page :

{
  "outil": "calculer_theme",
  "version": "1",
  "partage": {
    "lien": "https://montheme.fr/theme-astral/resultat?date=1990-05-12&heure=14%3A30&ville=Lyon&pays=FR&prenom=Camille"
  },
  "resultat": {
    "zodiaque": "les_deux",
    "tropical": {
      "systemeMaisons": "placidus",
      "heureInconnue": false,
      "bigThree": {
        "soleil": "Taureau",
        "lune": "Sagittaire",
        "ascendant": "Vierge"
      },
      "planetes": [
        {
          "id": "soleil",
          "nom": "Soleil",
          "signe": "Taureau",
          "signeId": "taureau",
          "position": "21°31' Taureau",
          "degreDansSigne": 21.52,
          "maison": 9,
          "retrograde": false
        },
        {
          "id": "lune",
          "nom": "Lune",
          "signe": "Sagittaire",
          "signeId": "sagittaire",
          "position": "21°06' Sagittaire",
          "degreDansSigne": 21.1,
          "maison": 4,
          "retrograde": false
…

CORS ouvert, aucune authentification ; 60 appels par minute et 2 000 par jour par adresse IP. lang=en pour l’anglais (les clés restent en français).

Le même calcul sur le site

Ce que cet outil calcule, le site le montre aussi à la personne : le calcul du thème astral.

Les autres outils

← Les outils de l’API v1 : le calcul de Véga, en JSON Toute la documentation pour les assistants et les développeurs OpenAPI