The solar return

What it takes

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

Options

Calling it

With GET

https://montheme.fr/api/v1/revolution_solaire?date=1990-05-12&heure=14:30&ville=Lyon&pays=FR&prenom=Camille&annee=2027&lang=en

With POST and a JSON body

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

{
  "naissance": {
    "date": "1990-05-12",
    "heure": "14:30",
    "ville": "Lyon",
    "pays": "FR",
    "prenom": "Camille"
  },
  "annee": 2027,
  "lang": "en"
}

With the MCP server (tool revolution_solaire)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "revolution_solaire",
    "arguments": {
      "birth": {
        "date": "1990-05-12",
        "time": "14:30",
        "city": "Lyon",
        "country": "FR",
        "name": "Camille"
      },
      "annee": 2027,
      "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:

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

{
  "outil": "revolution_solaire",
  "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": {
    "annee": 2027,
    "periode": {
      "debut": 2027,
      "fin": 2028
    },
    "retour": {
      "utc": "2027-05-12T11:10:00.000Z",
      "date": "2027-05-12"
    },
    "heureNaissanceInconnue": false,
    "carteDeLAnnee": {
      "ascendant": "Leo",
      "ascendantIndicatif": false,
      "soleil": {
        "signe": "Taurus",
        "maison": 10
      },
      "lune": {
        "signe": "Leo",
        "maison": 12
      }
    },
    "lecture": [
      "The tone of the year: Leo rising. Radiance, creativity, generosity: this is the colour you bring to the next twelve months, the way you step into situations.",
      "The central domain: the Sun of the year is in house 10 (career, vocation and social achievement). That is where the year asks you to invest your energy and where results show most.",
      "The emotional climate: Moon in Leo, in house 12 (the unconscious, retreat and spirituality). Radiance, creativity: what you will need to feel at home, and the area that moves emotionally.",
      "In your natal chart, the year’s Ascendant falls in your house 12 (the unconscious, retreat and spirituality): that is the ground of your life where the year settles."
    ],
    "planetes": [
…

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 solar return calculator.