Back to blog

October 31, 2026

·

Jackson

Find a Good Date for One Person, a Couple or a Team

An electional search that reads each hour as a chart, checks it against up to 8 birth charts, rules out hours that hit anyone hard and says why. In the chat or by API.

electionaltimingweddingsapimcp

Electional astrology picks the moment to begin something. Most electional tools look at the sky alone. That works for a shop opening, but a wedding has two people in it, and a launch may have three founders. An hour can be fine in the sky and land Mars on one partner's Sun.

So the electional search now takes up to 8 birth charts as well as the sky.

Three ways to ask

  • No one: "When is a good day to launch next month?" The search reads the sky hour by hour and returns the best windows. This is the search we already had.
  • One person: add your birth, and every hour is also checked against your chart.
  • A group of up to 8: "Find a wedding date in May that works for both of us." Every hour is checked against every chart.

In Claude it is one tool, ephemeris_electional. With people in it, a timeline widget opens: the windows on a time axis with the best three starred, one row per person showing their good hours and their ruled-out hours with the reason, and a card for each window.

The search is on the Pro plan. Pro searches up to 30 days at a time, Startup 60 and Scale 120.

How an hour is scored

The sky. Each hour is cast as an election chart and read the traditional way: the Moon (waxing, its place, the next three planets it meets, or void of course), the Ascendant ruler (its place, dignity, whether it is retrograde or under the beams), Jupiter and Venus on the angles, and Mars and Saturn on the angles or near the Ascendant, harsher when contrary to sect. Hours with the Moon within 15° of the Sun are out, and hours with a weak sky are never candidates.

Each person. The planets at that hour are compared with the person's chart. Benefics help, malefics hurt, and the person's sect changes how hard. Jupiter and Saturn count at a quarter, since they sit in one place for days and would otherwise drown out the rest. The natal places where the election's rising sign and Moon fall also count.

The veto. An hour is out for everyone if Saturn or Mars is within 2° of a conjunction, square or opposition to anyone's Sun, Moon, Ascendant or Ascendant ruler, or if the election Ascendant is within 3° of anyone's natal Mars or Saturn. The widget shows which rule cut which hours.

Putting people together. For 2 or 3 people the group score is the weakest person's score, so nobody is traded away. For 4 or more it is half the weakest and half the average. Then the group and the sky count half each.

If someone doesn't know their birth time, say so: their chart is compared by planets only, and their Moon counts less and never rules out an hour.

Every weight, orb and rule is returned with the answer, so you can see why one hour beat another.

A worked example

Alex was born on 2 March 1990 at 18:30 in New York. Sam was born on 20 November 1985 at 07:15 in Los Angeles. They want a morning or evening in June 2027 in New York, between 08:00 and 21:59 local. We ran this against the live API on 31 October 2026.

The search looked at 720 hours. 261 fell outside those hours, 20 had the Moon under the beams, 76 had too weak a sky and 217 were ruled out by the veto. That left 37 candidate hours.

Most of June is bad for this couple, and the veto says why. Mars opposes Alex's Sun for 198 hours of the month and sits on Alex's Ascendant for 131. Mars opposes Sam's Moon for 194 hours and squares Sam's Ascendant for 71. A sky-only search would have offered many of those hours.

The best window is Friday 18 June, 09:00 to 11:00 New York time, best at 09:00. It scores 57:

  • The sky (68): the Moon next meets Jupiter by trine (1.4°), Jupiter is on an angle in the 1st place, the Ascendant ruler (the Sun) is in the 11th, and Venus is sextile the Ascendant. Against it, Mars overcomes the Moon from the 10th sign.
  • Alex (45): the Sun trines Alex's Mercury, the Ascendant ruler (1.7°). To watch: the election's rising sign falls in Alex's natal 12th place, and Mars is 3.4° from opposing Alex's Sun.
  • Sam (52): Venus trines Sam's Jupiter, the Ascendant ruler (1.5°), and the election Moon falls in Sam's natal 1st place. To watch: Mars opposes Sam's Moon (2.7°).

With two people the group score is the weaker one, Alex's 45. Half sky and half group gives 57. That is a moderate window, and the next two (22 and 17 June) rate poor. The answer says so plainly. For a better date, widen the range: the trouble here is Mars, and it moves on.

For developers

The route is POST /electional/group-window. Send start_date, end_date, the event latitude and longitude, and people (1 to 8, each with a label, birth_datetime and birth_location). Optional: timezone, earliest_local_hour, latest_local_hour, combine (weakest_link, balanced or average), lunar_phase, avoid_voc, max_results, include_timeline and a few more. The sky-only search stays at GET /electional/find-window. The API docs have every field.