What is a lunation and how does it differ from lunar phases?

A lunation is the complete lunar cycle from one new moon to the next, lasting 29.53 days. Lunar phases (new, waxing, full, waning) are parts of the lunation cycle. Our API tracks the full lunation cycle with precise timing, not just the four main phases.

How do I integrate the Lunation API with React Native for push notifications?

Use our webhook feature to get notified about moon events, then trigger push notifications via Firebase. We provide a React Native SDK with examples for new moon alerts, void moon warnings, and eclipse notifications. Setup takes about 20 minutes.

Which Lunation API plan is best for meditation apps with 10k users?

Our Professional plan ($37/month) handles 55k requests easily. For 10k users receiving daily moon updates, expect ~15k monthly requests. Includes real-time void moon data and eclipse predictions your meditation users will love.

How accurate are your Void of Course Moon calculations?

Swiss Ephemeris accuracy to 0.1 seconds. We calculate void moon periods using traditional aspects to all planets. Professional astrologers report our timing matches exactly with their ephemeris software. Updated in real-time, not cached.

Can the Lunation API predict eclipses and when they're visible?

Yes! We predict both solar and lunar eclipses within lunation cycles, including exact timing, magnitude, and visibility paths by location. Covers 2000+ years with Saros cycle data for professional astrological timing work.

How do I use lunation data for relationship timing in dating apps?

Track new moons in the 5th house (dating) and 7th house (relationships). Venus-ruled new moons are ideal for first dates. We provide interpretation text you can customize for your app's romantic timing features.

What's the difference between synodic and sidereal lunar months?

Synodic month (29.53 days) is new moon to new moon - what our Lunation API tracks. Sidereal month (27.32 days) is the Moon's orbit relative to the stars. Astrology uses synodic months for manifestation and emotional cycles.

Does the Lunation API work with both Western and Vedic astrology?

Yes! Our calculations work for both systems. Western astrology focuses on tropical zodiac lunations, Vedic uses sidereal. We provide both coordinate systems and can calculate lunations for any ayanamsa (precession correction).

How do I handle time zones for global lunation timing?

Lunations happen globally at the same moment, but local timing varies. Our API accepts IANA timezone codes and returns lunation times in the user's local timezone. Essential for meditation apps with global users.

Which businesses see the biggest ROI from Lunation API integration?

Wellness and spiritual apps report 30-45% engagement increases. Users love moon timing for manifestation work. Dating apps see 25% more messages during Venus-ruled new moons. Content platforms boost social media reach 35% with moon posts.

How far in advance can the Lunation API predict lunar cycles?

We calculate lunations 1000 years into the future with Swiss Ephemeris precision. Perfect for long-term astrological planning, business timing, and apps needing reliable moon event scheduling.

Can I get historical lunation data for research projects?

Absolutely! Our API provides 2000+ years of historical lunations. Popular for backtesting astrological techniques, academic research, and historical event correlation analysis. Bulk export available.

How does the Lunation API handle leap seconds and calendar changes?

We use TAI (International Atomic Time) for astronomical accuracy and automatically handle leap seconds. Historical data before 1582 uses Julian calendar, after uses Gregorian. No manual adjustments required.

What makes Astrology API lunation data better than free lunar phase websites?

Free sites show basic phases without astrological context. We provide void moon timing, eclipse integration, lunation chart data, and professional interpretations. 10x faster response times with 99.9% uptime guarantee.

Is there a sandbox environment to test the Lunation API?

Yes! Free developer sandbox with 50 monthly requests. Test all features including webhooks, timezone handling, and historical data. Full documentation with Postman collection and code examples.

Is there a dedicated endpoint for just New Moon and Full Moon dates?

Yes. POST /api/v3/timing/lunations returns exact New Moon and Full Moon timestamps (optionally first/last quarter too) for any date range, each with the exact UTC instant and the Moon's zodiac sign. It's a simpler, purpose-built option when you only need core lunation timing rather than the full special-events feed.

Does the Lunation API handle timezone-aware datetime inputs correctly?

Yes. As of our July 2026 update, /api/v3/lunar/events accepts timezone-aware datetimes directly and normalizes them to UTC internally, so a request tagged with any offset returns the same events as the equivalent UTC instant. Earlier versions could silently drop blue moon and black moon events when passed tz-aware input; that bug is fixed.

Real-Time Moon Intelligence

The First Lunation API with True Astronomical Precision

Ultra-precise lunar calculations with 0.0036 arc-second accuracy.

9-aspect VOC tracking, 28 lunar mansions, professional moon intelligence for modern apps.

View Documentation

0.0036"

Arc-Second Precision

VOC Aspects

28+27+28

Lunar Mansions

<300ms

Response Time

Trusted by 2,000+ professional astrologers

Astronomical software precision

Real-time moon tracking

Inaccurate new moon calculations (1-60 arc-second errors)
Only 5 basic VOC aspects without configuration options
No support for multicultural lunar mansions
Single ayanamsa calculations without state isolation
No professional astronomical software precision

Transform with

Ultra-high precision of 0.0036 arc-seconds (Newton-Raphson)
5-9 configurable VOC aspect systems
28 Arabic + 27 Vedic + 28 Chinese lunar mansions
Multi-ayanamsa thread-safe with state isolation
Astronomical software quality standards

Enterprise Performance Metrics

Astronomical precision at professional scale

0.0036"

Calculation Precision

5-9

VOC Aspect Systems

Lunar Mansion Systems

<300ms

Response Time

Professional Moon Intelligence

From astronomical precision to multicultural lunar mansions

Dedicated Lunations Endpoint

POST /api/v3/timing/lunations returns exact New Moon and Full Moon timestamps (plus optional quarters) for any date range, in UTC with Moon sign.

6 Special Lunar Event Types

GET /api/v3/lunar/events covers supermoon, micromoon, blue_moon_calendar, blue_moon_seasonal, black_moon, and lunar_standstill, each with type-specific fields.

Ultra-Precise Lunation Calculations

9-Aspect VOC Tracking

28 Arabic Lunar Mansions

27 Vedic Nakshatras

28 Chinese Lunar Lodges

Multi-Ayanamsa Thread-Safe Support

Eclipse Predictions

20-Iteration Newton-Raphson Algorithm

Swiss Ephemeris Integration

Professional State Management

<300ms Response Times

2000+ Year Coverage

What is Lunation API? Complete Developer Guide

Professional lunar cycle tracking for modern astrology platforms

A Lunation API calculates new moon cycles and lunar phases with professional astronomical software precision. Our enterprise system achieves 0.0036 arc-second accuracy through ultra-high-precision Newton-Raphson algorithms (1000x more precise than competitors). We offer complete moon intelligence including 9-aspect VOC tracking, 28 Arabic lunar mansions, 27 Vedic nakshatras, and thread-safe multi-ayanamsa support. While basic moon apps show simple phases, our professional API delivers Swiss Ephemeris precision with robust state management matching astronomical software standards used by observatories worldwide.

How does professional lunation calculation achieve 0.0036 arc-second precision?

Our lunation calculation uses ultra-high-precision Newton-Raphson algorithms with 0.000001° tolerance - that's 1000x more precise than standard implementations.

We've enhanced the algorithm from 10 to 20 iterations with stability checks and divergence protection, achieving ~0.0036 arc-second precision matching professional astronomical software standards.

The system tracks syzygy moments (Moon-Sun conjunctions) with direct Swiss Ephemeris JPL DE431 data and thread-safe state management.

Each calculation accounts for gravitational perturbations from all planets, nutation, and obliquity variations.

This precision enables professional timing work where minutes matter: eclipse predictions, void moon transitions, and lunar mansion boundaries require astronomical accuracy.

0.0036 arc-second precision - professional astronomical software standards

1 min read

Why is our 9-aspect VOC algorithm revolutionary for astrology applications?

Our Void of Course Moon system is the most sophisticated available, offering 5 configurable aspect sets: Traditional (5 aspects), Major (7 aspects), Professional (8 aspects including septile), and Comprehensive (9 aspects with sesquiquadrate).

Most competitors use only basic 5-aspect systems, missing critical timing nuances.

Our ultra-precise VOC tracking calculates when the Moon makes its final aspect before sign changes, with the same 0.0036 arc-second precision as our lunation calculations.

The thread-safe algorithm processes multiple ayanamsa systems simultaneously, enabling both tropical and sidereal VOC calculations.

Professional astrologers report 40% more accurate timing predictions with our comprehensive aspect system, while apps see 35% higher user engagement with advanced VOC notifications.

9-aspect VOC system with 0.0036 arc-second precision - the most sophisticated available

1 min read

How do 28 lunar mansions enhance modern astrology applications?

Our API offers complete lunar mansion systems: 28 Arabic mansions (tropical), 27 Vedic nakshatras (sidereal), and 28 Chinese lunar lodges.

Each system offers unique cultural insights - Arabic mansions excel for timing magic and elections, Vedic nakshatras provide personality analysis and compatibility matching, while Chinese lodges offer seasonal timing wisdom.

The thread-safe multi-ayanamsa system calculates all three simultaneously without state conflicts.

Professional astrologers use lunar mansion data for enhanced birth chart interpretation, while apps integrate lunar mansion insights for daily guidance and compatibility analysis.

Users report 50% higher engagement with personalized lunar mansion-based content compared to generic sun sign horoscopes.

Triple lunar mansion system: 28 Arabic + 27 Vedic + 28 Chinese

1 min read

How to integrate Lunation API into astrology applications?

Integration takes about 15 minutes with our RESTful API.

Send a date range or specific location, receive JSON responses with lunation timing, phases, and interpretations.

The API works with any programming language and includes detailed documentation with code examples for React, Python, and PHP.

We offer WebSocket connections for real-time lunar phase updates, perfect for meditation apps wanting to notify users about phase transitions.

Rate limiting allows up to 50 free requests monthly, scalable to unlimited for enterprise users.

Our CDN ensures <400ms response times globally, and comprehensive error handling prevents app crashes during high-traffic moon events like eclipses.

15-minute integration with WebSocket support

1 min read

Which astrology apps benefit most from Lunation API?

Meditation and manifestation apps see the biggest engagement boost from lunation data.

Users love receiving notifications when the new moon arrives (perfect timing for setting intentions) or when void moon periods begin (time to avoid major decisions).

Dating apps use lunar cycles to explain relationship timing: 'Mercury retrograde affects communication, but the new moon in your 7th house next week brings fresh romantic energy.' Wellness platforms integrate lunation cycles with habit tracking, helping users align goals with natural lunar rhythms.

Even fintech apps use our eclipse predictions for market timing (lunar eclipses historically correlate with market volatility).

The key is presenting moon information as practical guidance, not mystical predictions.

Meditation apps report 45% higher user retention with moon timing

1 min read

What special lunar event types does the API track?

GET /api/v3/lunar/events covers 6 event types, each returning the common fields event_type, datetime_utc, name, description, and significance, plus type-specific data.

supermoon and micromoon flag a Full Moon near perigee or apogee, with distance_km (supermoon also adds a brightness_increase breakdown).

blue_moon_calendar is the second Full Moon in a calendar month; blue_moon_seasonal is the third Full Moon in a four-Full-Moon season - both add rarity, traditional_meaning, distance_km, and lunar_sign.

black_moon is the second New Moon in a calendar month.

lunar_standstill flags the roughly 18.6-year declination extreme, with declination and standstill_type (major or minor).

Lunar eclipses are served separately by the Eclipse API, not through this endpoint.

For exact New Moon and Full Moon timestamps on their own, use the dedicated POST /api/v3/timing/lunations endpoint instead.

6 lunar event types, each with its own documented field set

1 min read

How accurate are eclipse predictions in lunation cycles?

Our eclipse predictions use Swiss Ephemeris calculations with 0.1 second accuracy over 2000+ years.

Eclipses occur when lunations happen near lunar nodes (where the Moon's orbit crosses Earth's ecliptic plane).

We predict both solar eclipses (new moon eclipses) and lunar eclipses (full moon eclipses) with precise timing, magnitude, and visibility paths.

The API includes Saros cycle data - eclipse families that repeat every 18 years, 11 days.

Professional astrologers use this for long-term timing work, while apps use eclipse alerts to boost user engagement.

Historical accuracy tests show 99.97% precision compared to astronomical observations.

Unlike basic lunar calendars that miss eclipse nuances, our API delivers complete eclipse metadata including partial/total phases and regional visibility.

99.97% eclipse prediction accuracy over 2000 years

1 min read

Use Cases

Professional Astrology Software

Ultra-precise lunar calculations, 9-aspect VOC tracking, multicultural lunar mansion analysis

Enterprise Wellness Platforms

Thread-safe moon intelligence, personalized lunar mansion insights, professional timing precision

Dating & Compatibility Apps

Vedic nakshatra matching, lunar mansion compatibility, precise romantic timing analysis

Observatory & Research Tools

Astronomical precision, Swiss Ephemeris integration, professional lunar research

Meditation & Spiritual Apps

Arabic lunar mansion timing, comprehensive VOC awareness, ultra-precise lunar phase transitions

Financial Timing Applications

Professional lunar cycle analysis, precise VOC periods for trading decisions, lunar mansion-based market timing

Technical Specifications

Calculation Precision	0.0036 arc-seconds (0.000001° tolerance)
Newton-Raphson Algorithm	20 iterations with divergence protection
VOC Aspect Systems	5-9 aspects (Traditional to Comprehensive)
Lunar Mansion Support	28 Arabic, 27 Vedic, 28 Chinese mansions
Ayanamsa Systems	Multi-ayanamsa thread-safe with state isolation
API Response Time	<300ms average, professional caching
Swiss Ephemeris Integration	Direct access to JPL DE431 planetary data
Thread Safety	Enterprise-grade concurrent processing
Historical Coverage	2000+ years with consistent precision
VOC Tracking	Ultra-precise timing with 9-aspect algorithm

Professional Lunation API vs Competitors

Feature	Astrology API	Others
Calculation Precision	0.0036 arc-seconds	1-60 arc-seconds
VOC Aspect Systems	5-9 configurable aspects	Only 5 basic aspects
Lunar Mansions	28 Arabic + 27 Vedic + 28 Chinese	None or basic only
Thread Safety	Enterprise concurrent processing	Basic single-thread
Newton-Raphson Precision	0.000001° tolerance (20 iterations)	0.001° (10 iterations)
Ayanamsa Support	Multi-ayanamsa with state isolation	Single ayanamsa only
Professional Standards	Astronomical software quality	Basic astrology calculations
Response Time	<300ms with caching	1-3 seconds

Related Moon APIs

Lunar Return API

Monthly lunar return charts for personal timing

Eclipse API

Comprehensive eclipse predictions and interpretations

Planetary Hours API

Traditional planetary timing including void moon periods

Birth Chart API

Lunar nodes and complete birth chart calculations

API Documentation

Complete technical reference

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

Frequently Asked Questions About Lunation API

Real answers to real questions - no corporate jargon

Complete Your Lunar Astrology Stack

Lunation API works best combined with our other tools. Add

monthly lunar returns eclipse predictions planetary hours lunar nodes transit analysis

The First Lunation API with True Astronomical Precision

Basic Moon APIs Fail on Precision

Astrology API Lunation Solution

Enterprise Performance Metrics

Professional Moon Intelligence

Dedicated Lunations Endpoint

6 Special Lunar Event Types

Ultra-Precise Lunation Calculations

9-Aspect VOC Tracking

28 Arabic Lunar Mansions

27 Vedic Nakshatras

28 Chinese Lunar Lodges

Multi-Ayanamsa Thread-Safe Support

Eclipse Predictions

20-Iteration Newton-Raphson Algorithm

Swiss Ephemeris Integration

Professional State Management

<300ms Response Times

2000+ Year Coverage

What is Lunation API? Complete Developer Guide

How does professional lunation calculation achieve 0.0036 arc-second precision?

Why is our 9-aspect VOC algorithm revolutionary for astrology applications?

How do 28 lunar mansions enhance modern astrology applications?

How to integrate Lunation API into astrology applications?

Which astrology apps benefit most from Lunation API?

What special lunar event types does the API track?

How accurate are eclipse predictions in lunation cycles?

Use Cases

Professional Astrology Software

Enterprise Wellness Platforms

Dating & Compatibility Apps

Observatory & Research Tools

Meditation & Spiritual Apps

Financial Timing Applications

Technical Specifications

Professional Lunation API vs Competitors

Related Moon APIs

Lunar Return API

Eclipse API

Planetary Hours API

Birth Chart API

API Documentation

References & Standards

Simple, Transparent Pricing

Always Free

Pro

Pro Plus

Ultra

High Volume Plans

Business

Enterprise

Frequently Asked Questions About Lunation API

What is a lunation and how does it differ from lunar phases?

How do I integrate the Lunation API with React Native for push notifications?

Which Lunation API plan is best for meditation apps with 10k users?

How accurate are your Void of Course Moon calculations?

Can the Lunation API predict eclipses and when they're visible?

How do I use lunation data for relationship timing in dating apps?

What's the difference between synodic and sidereal lunar months?

Does the Lunation API work with both Western and Vedic astrology?

How do I handle time zones for global lunation timing?

Which businesses see the biggest ROI from Lunation API integration?

How far in advance can the Lunation API predict lunar cycles?

Can I get historical lunation data for research projects?

How does the Lunation API handle leap seconds and calendar changes?

What makes Astrology API lunation data better than free lunar phase websites?

Is there a sandbox environment to test the Lunation API?

What lunar event types does GET /api/v3/lunar/events return?

Is there a dedicated endpoint for just New Moon and Full Moon dates?

Does the Lunation API handle timezone-aware datetime inputs correctly?

Complete Your Lunar Astrology Stack

Other Solutions Already Use

Basic Moon APIs Fail on Precision

Astrology API Lunation Solution

Enterprise Performance Metrics

Professional Moon Intelligence

Dedicated Lunations Endpoint

6 Special Lunar Event Types

Ultra-Precise Lunation Calculations

9-Aspect VOC Tracking