The sky of a date

What it takes

No birth: only the options below.

Options

Calling it

With GET

https://montheme.fr/api/v1/ciel?date=2026-12-21&lang=en

With POST and a JSON body

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

{
  "date": "2026-12-21",
  "lang": "en"
}

With the MCP server (tool ciel)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ciel",
    "arguments": {
      "date": "2026-12-21",
      "language": "en"
    }
  }
}

What it returns

The response holds outil, version, and resultat, whose keys are:

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

{
  "outil": "ciel",
  "version": "1",
  "resultat": {
    "date": "2026-12-21",
    "heure": "12:00",
    "lieu": "Paris",
    "planetes": [
      {
        "id": "soleil",
        "nom": "Sun",
        "signe": "Sagittarius",
        "signeId": "sagittaire",
        "position": "29°34' Sagittarius",
        "degreDansSigne": 29.58,
        "retrograde": false
      },
      {
        "id": "lune",
        "nom": "Moon",
        "signe": "Taurus",
        "signeId": "taureau",
        "position": "22°56' Taurus",
        "degreDansSigne": 22.95,
        "retrograde": false
      },
      {
        "id": "mercure",
        "nom": "Mercury",
        "signe": "Sagittarius",
        "signeId": "sagittaire",
        "position": "23°14' Sagittarius",
        "degreDansSigne": 23.25,
        "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 sky today.