API v1 · developers and assistants
The API v1 tools: Vega’s calculations, in JSON
The same tools as Vega, the site’s chat: each calculates one thing, to the place and the minute, and returns it as JSON. No account, no key, read-only; one page per tool says what it takes, its options and what it returns.
How it works
- One address per tool:
https://montheme.fr/api/v1/<tool>, with GET (parameters in the address) or POST (a JSON body).GET https://montheme.fr/api/v1returns the catalogue. - A birth is given as on the site’s pages:
date,heure,ville(orlat,lon,tz),pays,prenom; two people:date1,date2… with GET,personne1andpersonne2in JSON. - The response:
{ outil, version, partage, resultat }.resultatnever contains the birth details;partage.lienis the chart’s page on the site, to give to the person. - Open CORS, no authentication; 60 calls a minute and 2,000 a day per IP address.
lang=enfor English (keys stay in French). - The same calculation as the site: positions, dates and periods come from the calculation, never from an estimate. Please credit the source.
The tools
Each tool has its page: what it takes, its options, a call with GET, with POST and through the MCP server, and the real response of the example.
- Compute a chart
calculer_themeComputes a chart with the site, to the minute: Western (the default), Vedic, or both in one call to cross them. - Vimshottari dashas
dashasThe Vimshottari periods (Vedic astrology) of a chart, calculated by the site from the Moon's nakshatra: the current major and sub-period, the next one, then the dated major periods and their sub-periods over a range. - A chart's transits
transitsTransits on a chart, the same calculation as the "My transits" page: a day, a week, a month or a date range; slow planets or all. - The solar return
revolution_solaireA chart's solar return for a year, calculated by the site: the instant the Sun returns to its birth degree, the year's rising sign, Sun and Moon houses, positions, aspects and the rule-based reading of the year. - Two charts' compatibility
compatibiliteTwo charts' compatibility, calculated by the site: cross aspects with orbs, star scores 1 to 5 (love, communication, longevity, passion, overall), strengths, levers and the reading of the bond; in Vedic, both people's charts side by side (D1 and D9 by default, or those asked) and each Moon's nakshatra, to cross. - The sky of a date
cielThe sky of a day, the same for everyone, calculated by the site (Paris, at noon; "": now): planets in signs, their degrees and retrogrades, the sky's aspects, the Moon's phase. - The sky calendar
calendrierThe 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. - A sign's horoscope
horoscopeA 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. - The site's texts
textes_du_siteWhat montheme.fr's written texts say about an astrology topic: title, hook, paragraphs, strengths, challenges and advice of the pages covering it (two at most). - Search the site
chercher_sur_le_sitemontheme.fr's search (the same as its magnifier): the matching pages (five at most), with title, address and excerpt.
With the MCP server
The same tools, under the same names, are in the site’s MCP server (https://montheme.fr/api/mcp): a birth is given as birth (or person1 and person2), and the response comes as structured JSON.
The specification
The OpenAPI 3.1, generated from the same list of tools: https://montheme.fr/api/openapi.json