API v1 · developers and assistants · calendrier

The sky calendar

The sky calendar over a period, calculated by the site: new and full moons (date, Paris time, sign, degree, eclipse), eclipses, retrogrades (stations, shadow), planets' sign ingresses. With a chart, the natal house each lunation falls in and its aspects within three degrees.

What it takes

A birth, optional: with it, the result relates to that chart (its natal house, its aspects).

Options

Option	Values	Default	What it does
`debut`	a date YYYY-MM-DD, or empty	empty	First day, YYYY-MM-DD; "": today.
`fin`	a date YYYY-MM-DD, or empty	empty	Last day, YYYY-MM-DD, at most two years after the start; "": three months after.
`evenements`	a list among `lunaisons`, `eclipses`, `retrogrades`, `ingres`	empty	What to list: "lunaisons" (new and full moons), "eclipses", "retrogrades" (stations and shadows), "ingres" (sign ingresses); []: everything.
`planetes`	a list among `soleil`, `mercure`, `venus`, `mars`, `jupiter`, `saturne`, `uranus`, `neptune`, `pluton`	empty	For retrogrades and ingresses: the planets wanted; []: all.

Calling it

With GET

https://montheme.fr/api/v1/calendrier?debut=2027-01-01&fin=2027-03-31&evenements=lunaisons,retrogrades&lang=en

With POST and a JSON body

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

{
  "debut": "2027-01-01",
  "fin": "2027-03-31",
  "evenements": [
    "lunaisons",
    "retrogrades"
  ],
  "lang": "en"
}

With the MCP server (tool `calendrier`)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "calendrier",
    "arguments": {
      "debut": "2027-01-01",
      "fin": "2027-03-31",
      "evenements": [
        "lunaisons",
        "retrogrades"
      ],
      "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
`debut`	string
`fin`	string
`lunaisons`	array
`eclipses`	array
`retrogrades`	array
`ingres`	array

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

{
  "outil": "calendrier",
  "version": "1",
  "resultat": {
    "debut": "2027-01-01",
    "fin": "2027-03-31",
    "lunaisons": [
      {
        "type": "nouvelle",
        "date": "2027-01-07",
        "heureParis": "21:25",
        "signe": "Capricorn",
        "signeId": "capricorne",
        "degre": 17.31
      },
      {
        "type": "pleine",
        "date": "2027-01-22",
        "heureParis": "13:17",
        "signe": "Leo",
        "signeId": "lion",
        "degre": 2.24
      },
      {
        "type": "nouvelle",
        "date": "2027-02-06",
        "heureParis": "16:56",
        "signe": "Aquarius",
        "signeId": "verseau",
        "degre": 17.63,
        "eclipse": "annular"
      },
      {
        "type": "pleine",
        "date": "2027-02-21",
        "heureParis": "00:24",
…

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 lunar calendar.

The other tools

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