API v1 · developers and assistants · calculer_theme

Compute a chart

Computes a chart with the site, to the minute: Western (the default), Vedic, or both in one call to cross them. Western: planets in signs and houses, angles, aspects with orbs, dominants. Vedic: the D1 and the divisional charts chosen for the question (one, several or all), each with its rising sign, whole-sign positions, nakshatras and padas and the birth-time precision it needs; the Jaimini karakas, the Karakamsha, the current Vimshottari period. Never the birth data.

What it takes

A birth: date (required), heure, ville or lat and lon, pays, tz, prenom.

Options

Option	Values	Default	What it does
`zodiaque`	`tropical`, `vedique`, `les_deux`	`tropical`	"tropical" (Western astrology, the default), "vedique" (the sidereal zodiac, Lahiri ayanamsa, whole-sign houses), or "les_deux" (both in one call, to cross them).
`maisons`	`defaut`, `placidus`, `egales`, `signes-entiers`	`defaut`	The Western house system: "defaut" (the chart's own, usually Placidus), "placidus", "egales" (equal) or "signes-entiers" (whole signs).
`blocs`	a list among `positions`, `angles`, `maisons`, `aspects`, `dominantes`, `lune`	empty	The Western blocks to return: "positions", "angles", "maisons" (cusps), "aspects", "dominantes", "lune" (its phase); []: positions, angles, aspects and dominants.
`cartes`	a list among `D1`, `D2`, `D3`, `D4`, `D5`, `D6`, `D7`, `D8`, `D9`, `D10`, `D11`, `D12`, `D16`, `D20`, `D24`, `D27`, `D30`, `D40`, `D45`, `D60`, `toutes`	empty	In Vedic: the divisional charts to return, one ("D9"), several ("D9", "D10", "D60") or "toutes" (all twenty, D1 to D60), chosen for the question (D9 love and the soul, D10 career, D2 money, D7 children, D20 spiritual life, D24 studies, D60 karma); the D1 is always there; []: the D1 alone.

Calling it

With 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&lang=en

With POST and a JSON body

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"
  ],
  "lang": "en"
}

With the MCP server (tool `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": "en"
    }
  }
}

What it returns

The response holds outil, version, partage.lien (the chart’s page on the site, to give to the person), and resultat, whose keys are:

Key	Type
`zodiaque`	string
`tropical`	object
`vedique`	object

What this example returns (the start), calculated by the site when the page was built:

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

Open CORS, no authentication; 60 calls a minute and 2,000 a day per IP address. lang=en for English (keys stay in French).

The same calculation on the site

What this tool calculates, the site also shows the person: the birth chart calculator.

The other tools

← The API v1 tools: Vega’s calculations, in JSON All the documentation for assistants and developers OpenAPI