API v1 · developers and assistants · horoscope

A sign's horoscope

A Sun sign's horoscope, the one on the site's pages, composed by rules from the real transits: a day, a week, a month or a year; scores, climate, love, work, energy, advice, key dates.

What it takes

No birth: only the options below.

Options

Option	Values	Default	What it does
`signe`	`belier`, `taureau`, `gemeaux`, `cancer`, `lion`, `vierge`, `balance`, `scorpion`, `sagittaire`, `capricorne`, `verseau`, `poissons`	required	The sign (French ids): belier … poissons.
`periode`	`jour`, `semaine`, `mois`, `annee`	`jour`	"jour" (the default), "semaine" (Monday to Sunday), "mois" (calendar month) or "annee" (calendar year).
`date`	a date YYYY-MM-DD, or empty	empty	A day in the period wanted, YYYY-MM-DD; "": today.

Calling it

With GET

https://montheme.fr/api/v1/horoscope?signe=scorpion&periode=semaine&date=2026-11-02&lang=en

With POST and a JSON body

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

{
  "signe": "scorpion",
  "periode": "semaine",
  "date": "2026-11-02",
  "lang": "en"
}

With the MCP server (tool `horoscope`)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "horoscope",
    "arguments": {
      "signe": "scorpion",
      "periode": "semaine",
      "date": "2026-11-02",
      "language": "en"
    }
  }
}

What it returns

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

Key	Type
`signe`	string
`periode`	string
`debut`	string
`fin`	string
`notes`	object
`climat`	string
`amour`	string
`travail`	string
`energie`	string
`conseil`	string

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

{
  "outil": "horoscope",
  "version": "1",
  "resultat": {
    "signe": "Scorpio",
    "signeId": "scorpion",
    "periode": "semaine",
    "debut": "2026-11-02",
    "fin": "2026-11-08",
    "notes": {
      "amour": 3,
      "travail": 3,
      "energie": 3,
      "global": 3
    },
    "motCle": "Magnetism",
    "climat": "The Sun is in your sign: this is your season, when you are seen and your projects gain momentum. The Moon crosses Leo, Virgo, Libra, Scorpio: the days when it is in your sign or in trine are your best moments of the week.",
    "amour": "A calm emotional climate: perfect for a low-stakes moment together, or for taking care of yourself. Venus is retrograde: stories from the past resurface, and this is the time to reconsider what you truly expect from love, not to commit in haste.",
    "travail": "Mercury in your sign: your mind is sharp, your words carry. Write, negotiate, express yourself. Tense energy: Mars pushes you to force things. Spend yourself physically rather than arguing. Jupiter in square: beware of overconfidence or promises that are too big. Check the numbers. Mercury retrograde: reread contracts and messages, back up your files, and prefer picking up an old file to launching a new one.",
    "energie": "Moderate, stable energy: alternate effort and recovery, and do not push at the end of the day.",
    "conseil": "Keep it simple: one thing done well beats three half-done.",
    "datesCles": []
  }
}

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 horoscope of the twelve signs.

The other tools

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