Which VoC methods does the API support?

Three: modern, lilly, and bonatti. Set voc_method in the request to pick one. Modern is the standard 20th-century definition: Moon makes no Ptolemaic aspect before leaving its sign. Lilly adds the four exception signs (Taurus, Cancer, Sagittarius, Pisces) where VoC is mitigated, not negated. Bonatti is the strictest medieval reading and returns a mild/standard severity flag. The legacy use_modern_planets boolean still works for back-compat.

In how many languages can I get VoC interpretations?

22. The list: en, ru, es, de, fr, it, pt, zh, uk, ja, ko, hi, ar, tr, nl, pl, en-GB, plus regional variants. Set the language code in the request and you get the interpretation in that language. The fallback is language-first: request event-oriented + ar and you get Arabic, not English with an Arabic header.

Does the API include antiscia?

Yes. Antiscia (mirror points around the 0 Cancer / 0 Capricorn axis) and contra-antiscia points are returned with the natal data. Traditional astrologers used antiscia for hidden aspects in horary and prediction. Modern APIs typically skip this entirely. Available in the standard natal response, no separate endpoint required.

What are Bonatti's 13 lots?

13 lots from Bonatti's Liber Astronomiae: Lot of Fortune, Lot of Spirit, Lot of Eros, Lot of Necessity, Lot of Courage, Lot of Victory, Lot of Nemesis, plus 6 more. Each is calculated with the correct day/night formula switch based on chart sect. Use them alongside the 97+ Arabic parts already in the API for full traditional lot coverage.

What is Local Space astrology?

Local Space plots azimuth lines from your birth location - directional vectors for each planet as seen from your standpoint on Earth. Astrologers use it for relocation work, choosing where to live or travel based on which planetary direction dominates that path. The API returns Local Space azimuth data alongside standard chart positions. Shipped in the astro.com parity Sprint 1.

Does the API match astro.com features?

Sprint 1 and Sprint 2 of the astro.com parity push delivered 7 core features plus Local Space and Heliocentric charts. Cazimi/Combust detection, planetary hours endpoint, antiscia, Bonatti lots, and the multi-method VoC system all land in the same release cycle. Six polish fixes from an astrologer review went into production right after.

How much does the traditional astrology API cost?

Free tier: 50 requests/month. Starter: $11/month for 1,000 requests. Professional: $37/month for 55,000 requests with full VoC, dignities, antiscia, and Bonatti lots. Business: $99/month for 220,000 requests across all endpoints. Enterprise: $399+/month unlimited with dedicated servers. Same pricing whether you use 1 VoC method or all 3.

What is the difference between Modern, Lilly, and Bonatti VoC?

Modern: Moon makes no Ptolemaic aspect before changing signs. Conservative, easy to teach. Lilly: same base rule but mitigates VoC in Taurus, Cancer, Sagittarius, Pisces via voc_exception_sign and voc_effective_strength. Bonatti: stricter medieval reading that flags more periods void and tags each one mild or standard severity. Pick by client type - modern for consumer apps, Lilly for horary, Bonatti for electional.

How fast are the calculations?

Under 400ms for a full traditional analysis: VoC with method and severity, antiscia, 13 lots, dignities at all 5 levels, sect, planetary hours, cazimi/combust check. Sequential endpoint calls add up but each call is sub-400ms. No queueing, no 1-3 second waits that competitor APIs hit during peak.

Are the planetary hours interpretations multilingual?

Yes. The /timing/planetary-hours endpoint ships with 15 interpretation keys per planet across the same 22 languages as VoC. Request the endpoint with lang=ja and you get Japanese hour interpretations. Total: 7 planets x 15 keys x 22 languages on this surface alone.

What back-compat exists for old VoC requests?

The use_modern_planets boolean still works. Pass use_modern_planets: true and the API treats it as voc_method: modern. New integrations should use voc_method directly because it accepts three values instead of two. Existing integrations don't need to change.

Can I use this for horary readings?

Yes - Lilly is the dominant horary tradition and the API supports it natively. Set voc_method: lilly to get exception sign handling. Combine with the 97+ Arabic parts, 5-level dignities, antiscia, and cazimi/combust detection for a full Lilly-style horary stack. See the [Horary Astrology API](/p/horary) page for the focused feature set.

What about electional astrology?

Use voc_method: bonatti for electional. The severity flag (mild vs standard) lets you skip genuinely dead periods when recommending launch dates or contract timing. Combine with planetary hours (hour ruler favorability) and dignities (planetary strength at the elected moment). See the [Electional Astrology API](/p/electional) page for full timing tools.

How do I cite the source tradition in my UI?

Every VoC response includes the tradition key alongside the method. 19 traditions are exposed: Hellenistic, medieval Arabic, Renaissance European, modern Western, plus 15 more granular variants. Display 'VoC via Lilly (Christian Astrology, 1647)' or 'VoC via Bonatti (Liber Astronomiae, c. 1277)' directly from the response payload. No hardcoding required.

Does the API support cazimi and combust?

Yes. The Cazimi/Combust calculator returns the condition for each planet against the Sun's position: cazimi within 17 arcminutes (strengthened), combust within 8 degrees (weakened), under the beams within 17 degrees (affected but less severely). See the [Cazimi & Combust API](/p/cazimi-combust) for the focused page on this calculator.

Lilly + Bonatti + Modern VoC

Traditional Astrology With Real Depth

Three Void of Course methods, 22 languages, 19 traditions, 13 Bonatti lots, antiscia, and planetary hours.

Built for astrologers who care which tradition they cite.

View Documentation

VoC Languages

Traditions

Bonatti Lots

831

Interpretation Keys

Used by working horary and electional astrologers

Tested against Lilly, Bonatti, and Hellenistic sources

voc_method parameter: modern, lilly, or bonatti

One Void of Course method only, usually a vague modern blend
No severity flag - mild VoC and severe VoC look identical
Lilly's exception signs ignored, so Moon in Taurus or Cancer gets flagged as VoC
English-only interpretations - no Russian, Arabic, Chinese, or 19 other languages
No antiscia, no Bonatti lots, no planetary hours, no Local Space

Built for

Three VoC methods: modern, lilly, bonatti - pick by request
Bonatti severity flag: mild or standard with each VoC result
Lilly exception signs mitigated, not negated, with voc_effective_strength returned
VoC interpretations in 22 languages across 19 traditions
Antiscia, 13 Bonatti lots, planetary hours, Local Space, Heliocentric - all in scope

What You Get

Real numbers, not marketing fluff

VoC Methods

Languages

Traditions

Bonatti Lots

What's In The Box

Real features, not bullet-point filler

3 VoC methods

voc_method: modern, lilly, or bonatti

Bonatti severity flag

mild or standard per period

Lilly exception signs

Mitigated with voc_effective_strength

22 VoC languages

en, ru, es, ar, zh, ja, ko, hi, plus 14 more

19 traditions

Hellenistic, medieval Arabic, Renaissance, modern

831 interpretation keys

Across VoC, planetary hours, antiscia

Antiscia

Mirror points around 0 Cancer / 0 Capricorn

13 Bonatti lots

Fortune, Spirit, Eros, Necessity, plus 9 more

Planetary hours endpoint

/timing/planetary-hours with 15 keys per planet

Local Space charts

Azimuth lines for relocation work

Heliocentric charts

Sun-centered planetary positions

Cazimi / Combust

17 arcmin cazimi, 8 degree combust

5-level dignity system

Domicile, exaltation, triplicity, terms, faces

97+ Arabic parts

Day/night formula switch

Language-first fallback

Arabic stays Arabic, no English bleed

Traditional Astrology API: Multi-Method VoC, 22 Languages, Antiscia, Bonatti Lots

Lilly, Bonatti, Modern - pick the tradition that fits your client

Traditional astrology stopped being one thing somewhere around the 13th century. Lilly worked differently from Bonatti, Bonatti worked differently from the Hellenistic writers, and modern Western astrology cherry-picked from all of them. Most APIs pretend this never happened and ship one Void of Course algorithm in English. This API doesn't. The voc_method parameter accepts modern, lilly, or bonatti. VoC interpretations ship in 22 languages across 19 traditions. Bonatti severity returns mild or standard with each result. Lilly's exception signs (Taurus, Cancer, Sagittarius, Pisces) mitigate VoC instead of negating it, and the response includes voc_effective_strength so you can render the nuance. Add antiscia, Bonatti's 13 lots, 831 interpretation keys, planetary hours, Local Space charts, and Heliocentric charts. Same API, $11/month at the Starter tier.

Which VoC method should you use: Modern, Lilly, or Bonatti?

Three methods, three different answers.

Modern VoC: Moon makes no Ptolemaic aspect to any planet before leaving its current sign.

Standard in 20th-century textbooks, easy to teach, conservative.

Lilly's method: same base rule but Moon in Taurus, Cancer, Sagittarius, or Pisces is mitigated rather than fully void - the API marks voc_exception_sign true and reduces voc_effective_strength instead of returning a flat VoC.

Bonatti's method: a stricter medieval reading that flags more periods as void and tags each one as mild or standard severity.

Use modern for general consumer apps, Lilly for horary, Bonatti for electional work where you need to avoid genuinely dead periods.

Set voc_method in the request.

The legacy use_modern_planets boolean still works for back-compat.

voc_method: modern | lilly | bonatti - one parameter, three traditions

1 min read

What is Bonatti severity and why does it matter?

Bonatti didn't treat all VoC periods the same.

Some are mild - the Moon is technically void but the chart still cooperates for routine matters.

Others are standard - genuinely dead time where electing a venture is asking for trouble.

The API returns severity: mild or standard on every Bonatti VoC result.

Mild VoC: schedule meetings, sign routine paperwork, keep moving.

Standard VoC: don't launch products, don't file paperwork that matters, don't elect a wedding.

For electional astrology apps, this single flag prevents a whole class of bad recommendations.

Modern VoC and Lilly VoC don't carry severity - it's specifically a Bonatti construct that the API now exposes natively.

mild vs standard severity - returned per VoC period

1 min read

How does the API handle Lilly's VoC exception signs?

Lilly carved out four signs where the Moon, even when technically void, still produces effect: Taurus, Cancer, Sagittarius, and Pisces.

The API doesn't ignore VoC in those signs and it doesn't fully flag it either.

The LunarSequence response includes voc_exception_sign (boolean) and voc_effective_strength (numeric, reduced from baseline).

Render the exception in your UI: 'Moon void in Cancer - Lilly exception, mitigated.' This matches how working horary astrologers actually read the chart instead of dumping a binary void/not-void flag on the user.

The exception logic only applies when voc_method is set to lilly.

voc_exception_sign + voc_effective_strength fields on every Lilly VoC response

1 min read

Antiscia, Bonatti's 13 lots, planetary hours, Local Space, Heliocentric

Antiscia: the mirror reflections of planets around the 0 Cancer / 0 Capricorn axis - hidden aspects that traditional astrologers used for prediction and horary.

The API returns antiscia and contra-antiscia points with the natal data.

Bonatti's 13 lots: Lot of Fortune, Lot of Spirit, Lot of Eros, Lot of Necessity, Lot of Courage, Lot of Victory, Lot of Nemesis, plus six more from Liber Astronomiae - calculated with correct day/night formulas.

Planetary hours: the /timing/planetary-hours endpoint returns the current ruler plus interpretation in 22 languages, 15 interpretation keys per planet.

Local Space: azimuth lines for relocation work.

Heliocentric: Sun-centered positions for siderealists and astro-cartography.

All shipped in Sprint 1 and Sprint 2 of the astro.com parity push.

Antiscia + 13 lots + planetary hours + Local Space + Heliocentric - all live

1 min read

22 languages, 19 traditions, 831 interpretation keys

VoC interpretations ship in en, ru, es, de, fr, it, pt, zh, uk, ja, ko, hi, ar, tr, nl, pl, plus en-GB and regional variants - 22 in total.

Language-first fallback: request event-oriented + ar and the response returns Arabic, not English with an Arabic header.

The previous fallback chain dropped to English when a specific tradition lacked a translation; the new chain checks the language first, then walks the tradition tree.

19 traditions are supported, from Hellenistic to medieval Arabic to Renaissance European, with 831 interpretation keys total across the VoC + planetary hours + antiscia surface.

For non-English markets this is the difference between a usable product and a translation ticket.

22 languages, 19 traditions, language-first fallback

1 min read

Cazimi, Combust, and Under the Beams - the planetary condition toolkit

A planet within 17 arcminutes of the Sun is cazimi - in the heart of the Sun, exalted in strength.

Within 8 degrees and not cazimi: combust, burned and weakened.

Within 17 degrees: under the beams, still affected but less severely.

The Cazimi/Combust calculator returns the exact condition for every planet against the Sun's position.

See the dedicated [Cazimi & Combust API page](/p/cazimi-combust) for the full feature breakdown.

Combine it with the VoC endpoint and you have the two most-cited Moon and planet-strength signals from medieval horary in one request.

Cazimi within 17 arcminutes, combust within 8 degrees, under beams within 17 degrees

1 min read

Use Cases

Horary Astrologers

Lilly VoC with exception signs, Bonatti severity, antiscia, and 13 lots in one API call

Electional Apps

Bonatti severity flag prevents recommending genuinely dead periods for product launches and weddings

Non-English Astrology Platforms

VoC interpretations in Russian, Arabic, Chinese, Japanese, Korean, Hindi, and 16 other languages

Relocation Services

Local Space azimuth lines plus Heliocentric positions for astro-cartography and relocation work

Academic Tools

Switch between 3 VoC methods and 19 traditions to teach historical differences between Lilly, Bonatti, and modern

Traditional Practice Apps

Planetary hours endpoint with 22 languages, plus cazimi/combust detection for medieval-style daily guidance

Technical Specifications

voc_method parameter	modern \| lilly \| bonatti (back-compat: use_modern_planets boolean)
VoC severity (Bonatti)	mild \| standard - returned per VoC period
Lilly exception signs	voc_exception_sign + voc_effective_strength fields in LunarSequence
Supported VoC languages	en, ru, es, de, fr, it, pt, zh, uk, ja, ko, hi, ar, tr, nl, pl, en-GB, plus regional variants (22 total)
Supported traditions	19 traditions across Hellenistic, medieval Arabic, Renaissance European, and modern
Interpretation keys	831 keys across VoC, planetary hours, antiscia surfaces
Bonatti's 13 lots	Fortune, Spirit, Eros, Necessity, Courage, Victory, Nemesis, plus 6 more from Liber Astronomiae
Antiscia	antiscia + contra-antiscia points returned with natal data
Planetary hours	/timing/planetary-hours endpoint with 15 interpretation keys per planet
Local Space	Azimuth lines for relocation and astro-cartography
Heliocentric charts	Sun-centered planetary positions
Cazimi / Combust	Cazimi within 17 arcminutes, combust within 8 degrees, under beams within 17 degrees
Essential Dignities	Domicile, Exaltation, Triplicity, Terms, Faces - all 5 levels
Arabic Parts	97+ traditional lots with day/night formulas
Response Time	<400ms for full traditional analysis

Multi-Method, Multi-Language vs. The Rest

Feature	Astrology API	Others
VoC Methods	3 (Modern, Lilly, Bonatti)	1, unspecified
Bonatti severity flag	mild \| standard returned	Not supported
Lilly exception signs	Mitigated with voc_effective_strength	Ignored or hard-flagged
VoC interpretation languages	22	1 (English)
Traditions covered	19	1-2
Interpretation keys	831	Generic strings
Antiscia	Antiscia + contra-antiscia returned	Not supported
Bonatti lots	13 lots with day/night formulas	Fortune only or none
Planetary hours	Dedicated endpoint, 22 languages	Manual calculation only
Local Space	Azimuth lines included	Not supported
Heliocentric	Sun-centered positions	Geocentric only
Cazimi / Combust	Cazimi 17 arcmin, combust 8 deg	Combust only or none
Language-first fallback	Yes - Arabic stays Arabic	Falls back to English
Back-compat	use_modern_planets still works	Breaking changes per release
Response Time	<400ms	1-3 seconds

Traditional Toolkit

Cazimi & Combust API

Sun-burned and Sun-exalted planets: cazimi, combust, under the beams

Horary Astrology API

Question-based readings with Lilly VoC and exception signs

Electional Astrology API

Find timing with Bonatti severity to skip dead periods

Planetary Hours API

Hour rulers with interpretations in 22 languages

Lunation API

Lunar phases with VoC and exception sign handling

Dignities API

5-level essential dignity system: domicile to face

Lot of Spirit API

Bonatti and Hellenistic lots with day/night formulas

Timing API Hub

All /timing/* endpoints: VoC, planetary hours, electional windows

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

Simple, Transparent Pricing

Start free, scale as you grow. No hidden fees, no surprises.

Always Free

Start Free

Perfect for learning, testing, and small personal projects

50 API calls/month

Basic natal charts

5 house systems

Community support

Pro

$11/month

For small apps and personal projects

All basic endpoints
12 house systems
Email support

Best Value

Pro Plus

$21/month

For growing apps and medium traffic

All enhanced endpoints
18 house systems
AI interpretations
Priority email support

Ultra

$37/month

For professional astrology applications

Credit math ↓

All premium endpoints
23 house systems
Advanced AI interpretations
Priority support

High Volume Plans

For enterprise-scale applications

Business

$99/month

For high-volume applications

Credit math ↓

ALL endpoints
White-label ready
Custom AI fine-tuning
Phone support

UNLIMITED

Enterprise

$399+per month

Unlimited requests with dedicated infrastructure

Dedicated server infrastructure
Sub-300ms guaranteed
24/7 dedicated support
99.99% uptime SLA

All plans include comprehensive documentation and SDKs

Questions? Talk to our team

Traditional Astrology API FAQ

VoC methods, languages, lots, planetary hours, and more

Build A Complete Traditional Stack

The Traditional Astrology API pairs with specialized endpoints for horary, electional, timing, and lot calculations. Add

Cazimi & Combust calculator Horary Astrology API Electional Astrology API Planetary Hours API Lunation API Dignities API Lot of Spirit API Timing API hub

Stop Shipping One-Method VoC In English Only

Three VoC methods, 22 languages, 19 traditions, 13 Bonatti lots, antiscia, planetary hours, Local Space, Heliocentric. One API, $11/month at Starter.

Start Free View Documentation

30-day money-back

No setup fees

Back-compat with use_modern_planets

Traditional Astrology With Real Depth

Most APIs Treat Traditional Astrology As An Afterthought

What This API Actually Does

What You Get

What's In The Box

3 VoC methods

Bonatti severity flag

Lilly exception signs

22 VoC languages

19 traditions

831 interpretation keys

Antiscia

13 Bonatti lots

Planetary hours endpoint

Local Space charts

Heliocentric charts

Cazimi / Combust

5-level dignity system

97+ Arabic parts

Language-first fallback

Traditional Astrology API: Multi-Method VoC, 22 Languages, Antiscia, Bonatti Lots

Which VoC method should you use: Modern, Lilly, or Bonatti?

What is Bonatti severity and why does it matter?

How does the API handle Lilly's VoC exception signs?

Antiscia, Bonatti's 13 lots, planetary hours, Local Space, Heliocentric

22 languages, 19 traditions, 831 interpretation keys

Cazimi, Combust, and Under the Beams - the planetary condition toolkit

Use Cases

Horary Astrologers

Electional Apps

Non-English Astrology Platforms

Relocation Services

Academic Tools

Traditional Practice Apps

Technical Specifications

Multi-Method, Multi-Language vs. The Rest

Traditional Toolkit

Cazimi & Combust API

Horary Astrology API

Electional Astrology API

Planetary Hours API

Lunation API

Dignities API

Lot of Spirit API

Timing API Hub

References & Standards

Simple, Transparent Pricing

Always Free

Pro

Pro Plus

Ultra

High Volume Plans

Business

Enterprise

Traditional Astrology API FAQ

Which VoC methods does the API support?

What is Bonatti severity?

How does the API handle Lilly's VoC exception signs?

In how many languages can I get VoC interpretations?

Does the API include antiscia?

What are Bonatti's 13 lots?

What is Local Space astrology?

Does the API match astro.com features?

How much does the traditional astrology API cost?

What is the difference between Modern, Lilly, and Bonatti VoC?

How fast are the calculations?

Are the planetary hours interpretations multilingual?

What back-compat exists for old VoC requests?

Can I use this for horary readings?

What about electional astrology?

How do I cite the source tradition in my UI?

Does the API support cazimi and combust?

Build A Complete Traditional Stack

Stop Shipping One-Method VoC In English Only

Most APIs Treat Traditional Astrology As An Afterthought

What This API Actually Does

What You Get

What's In The Box

3 VoC methods

Bonatti severity flag