Planetary hours calculations in <200ms.
Ancient wisdom for modern apps. 26% more engagement with intelligent timing.
The Planetary Hours API works best combined with our other tools. Add
Built for scale, optimized for speed
From basic calculations to advanced planetary timing systems
Start free, scale as you grow. No hidden fees, no surprises.
For small apps and personal projects
For growing apps and medium traffic
For enterprise-scale applications
All plans include comprehensive documentation and SDKs
Questions? Talk to our team
Ancient timing wisdom for modern applications
Planetary hours are an ancient timing system that divides each day and night into periods governed by different planets, helping people choose the optimal time for specific activities. Our Planetary Hours API brings this powerful timing intelligence into modern apps, allowing users to discover the best moments for important decisions, meetings, launches, and personal activities. Each planetary hour carries specific energies - Venus hours are perfect for love and creativity, Mercury hours for communication and learning, Mars hours for competition and courage. Apps that integrate our planetary hours feature see 26% more engagement because users love practical timing guidance they can use daily. From scheduling business meetings during Jupiter hours for success to planning romantic dates during Venus hours, planetary hours make astrology actionable and immediately useful in everyday life.
Planetary hours divide the time from sunrise to sunset into 12 day hours and from sunset to sunrise into 12 night hours, each ruled by a different planet in traditional order: Sun, Venus, Mercury, Moon, Saturn, Jupiter, Mars.
Our API calculates these periods automatically for any location and date, taking into account local sunrise/sunset times.
Unlike fixed clock hours, planetary hours vary by season and location - summer day hours are longer, winter hours shorter.
The API returns the current planetary ruler, duration, and recommended activities for each hour.
Modern users love this practical timing system - knowing that Mercury hours (9-10am today) are perfect for important emails or that Venus hours (2-3pm) are ideal for creative work or relationship conversations.
Our API uses precise astronomical calculations for sunrise/sunset times at any global location, ensuring accurate planetary hour divisions.
While competitors use fixed timezones or approximate calculations, we account for geographic coordinates, elevation, atmospheric refraction, and seasonal variations for exact timing.
The API includes both classical planetary hours (7-planet system) and modern variations that include Uranus, Neptune, and Pluto.
We provide detailed activity recommendations for each planetary hour - Mars hours for workouts and competition, Mercury hours for study and communication, Venus hours for beauty and relationships.
Our AI-enhanced interpretations explain why certain activities work better during specific planetary periods and give users practical wisdom they can apply immediately.
Integration is straightforward - send a GET request with date and location coordinates, receive the full daily planetary hours schedule with timings, ruling planets, and activity recommendations.
The API returns current hour information, next hour preview, and full 24-hour schedule in JSON format.
The response includes activity categories (business, love, health, creativity, communication) with specific suggestions for each planetary period.
You can offer premium timing features like personalized daily timing reports, activity optimization suggestions, or notification alerts for favorable planetary hours.
Many customers create 'perfect timing' features where users set goals and receive notifications during optimal planetary periods.
Manual calculation of planetary hours requires complex astronomical knowledge - determining precise sunrise/sunset times, accounting for geographic variations, calculating hour divisions that change daily.
Our API handles these complexities automatically, delivering precise timing for any location worldwide.
We account for daylight saving time transitions, leap years, and geographic edge cases that manual calculations often miss.
The system updates automatically for seasonal changes - winter planetary hours at northern locations differ dramatically from summer hours.
This precision is crucial because even 15 minutes deviation could mean recommending the wrong planetary energy for important activities.
Professional astrologers typically charge $25-50 for personalized timing consultations - our API delivers this knowledge instantly.
Help users optimize daily activities with perfect timing - workouts during Mars hours, creative work during Venus hours
Optimize meeting scheduling, product launches, and important decisions with planetary timing intelligence
Guide meditation, self-care, and personal growth activities during the most supportive planetary periods
Help users choose optimal timing for weddings, launches, important conversations with ancient wisdom
| API Response Time | <200ms for full day schedule |
| Planetary Systems | Traditional 7 planets + modern 10-planet options |
| Location Accuracy | GPS coordinates with elevation compensation |
| Astronomical Data | Swiss Ephemeris precision sunrise/sunset |
| Timezone Support | All global timezones with DST handling |
| Activity Categories | 8 main categories with 50+ specific activities |
| Hour Duration | Variable length based on seasonal daylight |
| Current Hour Detection | Real-time identification of planetary ruler |
| Notification Support | Webhook alerts for optimal timing windows |
| Historical Data | Calculate planetary hours for any past/future date |
| Batch Processing | Generate weekly/monthly timing schedules |
| Output Format | JSON with human-readable recommendations |
| Feature | Astrology API | Others |
|---|---|---|
| Response Time | <200ms | 1-3 seconds |
| Location Precision | GPS coordinates + elevation | City-level approximation |
| Astronomical Accuracy | Swiss Ephemeris precision | Basic calculations |
| Seasonal Adjustment | Automatic daily recalculation | Fixed or manual |
| Activity Recommendations | 50+ specific activities | 10-15 general |
| Timezone Handling | Full DST support | Basic UTC conversion |
| Planetary Systems | Traditional + modern options | Traditional only |
| Historical Range | 4000 years past/future | Current year only |
| API Reliability | 99.9% uptime SLA | No guarantees |
| Cost Per Request | $0.002 at scale | $0.01-0.05 |
Find optimal timing for major events and important decisions using traditional electional rules
Track moon phases and lunar-based timing for enhanced planning and decision-making
Monitor planetary transits for long-term timing and astrological event planning
Complete classical astrology calculations including dignities and reception analysis
Answer specific questions with precise timing using traditional horary methods
Everything you need to know about planetary timing