Electional Astrology API V1 Launch: Automated Auspicious Timing

What shipped

Until now, electional astrology lived entirely in desktop tools (Solar Fire, Janus) or in expensive astrologer consultations. There was no programmatic way to integrate "pick a good day for this" logic into an application.

What's in V1

• 31 timing factors evaluated per candidate moment, including planetary dignities, void-of-course Moon, Mercury retrograde, malefic angularity, lunar applying aspects, and benefic-on-angle scoring
• 0-100 score per candidate moment with a category breakdown (benefic strength, malefic weakness, lunar quality, mercurial state, angular condition)
• Calendar heatmap output — give us a date range and a use case, get back every day in the range with a score, ready to render as a heatmap
• Use-case presets for weddings, surgery, business launch, contract signing, real-estate purchase, travel start, and generic "important undertaking"
• Sub-second scoring of a single moment; calendar heatmaps for a 30-day window return in roughly 800ms

Why it matters

Electional timing is the highest-value astrology use case our customers ask for after natal and transit work. Couples planning weddings want a "good" date. Founders want a launch date with Jupiter strong and Mercury moving forward. Real-estate buyers want a closing date that avoids Saturn-on-Moon malefic patterns. Until V1 these were all manual processes that required either a desktop tool or a paid consultation.

Now you can build a "pick a date" calendar widget that surfaces auspicious moments in real time. Wedding-planning apps, business-coaching platforms, surgery scheduling tools, and astrology consultation apps are the natural fits.

How to integrate

Heatmap for a month:

1const heatmap = await fetch('https://api.astrology-api.io/v1/electional/heatmap', {
2  method: 'POST',
3  headers: { 'Authorization': `Bearer ${process.env.ASTROLOGY_API_KEY}` },
4  body: JSON.stringify({
5    startDate: '2026-06-01',
6    endDate: '2026-06-30',
7    useCase: 'wedding',
8    latitude: 40.7128,
9    longitude: -74.0060,
10  }),
11}).then(r => r.json());
12
13// heatmap.days is an array of { date, score, dominantFactors[] }
14// Render each day with a color graded by score

Single-moment scoring:

1const score = await fetch('https://api.astrology-api.io/v1/electional/score', {
2  method: 'POST',
3  headers: { 'Authorization': `Bearer ${process.env.ASTROLOGY_API_KEY}` },
4  body: JSON.stringify({
5    moment: '2026-06-15T14:30:00Z',
6    useCase: 'business-launch',
7    latitude: 40.7128,
8    longitude: -74.0060,
9  }),
10}).then(r => r.json());

Where to learn more

• Product page: /p/electional
• Technical guide: Electional Astrology API: Automated Timing for Weddings, Surgery, Business
• Interactive demo: /demo

Pricing

What's next

V2 will add Vedic/Muhurta electional scoring, configurable factor weights for custom doctrines, and a webhook trigger that pings your server when an upcoming high-score window approaches. Target ship: Q3 2026.