The Astrocartography
Calculation Engine
Production-ready astrocartography REST API with advanced transit timing. Returns planetary line GeoJSON vectors, city compatibility scores, and transit-based timing intelligence with retrograde detection, lunar phases, and eclipse awareness.
Advanced Transit Features
Mercury, Venus, Mars retrograde tracking with automatic potency adjustments and guidance messaging
8 moon phases with mode-specific meanings (New Moon travel starts, Full Moon avoid relocations)
Solar & lunar eclipse proximity detection with intensity ratings for transformative moments
API Reference
Endpoints
/v1/calculate-lines
Returns MC/IC and ASC/DSC GeoJSON vectors for all 10 planetary lines (Sun-Pluto) across the globe.
"time": "14:30",
"lat": 51.50,
"lon": -0.12
// Returns GeoJSON planetary lines
/v1/score-city
Calculates 0-100 compatibility score for specific coordinates with categorical breakdowns (career, love, growth, health).
"city_lon": 139.65,
"city_name": "Tokyo"
// Returns score + categories
/v1/score-city-timing
Advanced transit timing: combines natal chart with real-time planetary movements, retrograde detection, lunar phases, and eclipse awareness for optimal travel windows.
"visit_end": "2026-06-22",
"mode": "travel"
// Returns timing intelligence
API documentation requires authentication
Request API Key & Documentation AccessQuick Start
Example: Transit Timingcurl -X POST "https://api.maphrodite.com/v1/score-city-timing" \ -H "Content-Type: application/json" \ -H "X-API-KEY: YOUR_API_KEY" \ -d '{ "date": "1990-05-20", "time": "14:30", "lat": 51.5074, "lon": -0.1278, "city_lat": 48.8566, "city_lon": 2.3522, "city_name": "Paris", "visit_start": "2026-06-01", "visit_end": "2026-06-07", "mode": "travel" }'
{ "overall_score": 82.3, "birth_chart_score": 75.5, "transit_bonus": 6.8, "timing_insight": "Exceptional timing! Venus forms a harmonious trine...", "best_days": [ { "date": "2026-06-03", "score": 92.3, "insight": "Venus trine natal Sun (exact aspect)", "lunar_phase": "New Moon" } ], "active_transits": [...], "category_scores": { "career": 80.1, "love": 88.2, "growth": 79.5 } }
Technical Specifications
Built for Scale
Swiss Ephemeris
Scientific-grade precision utilizing the same JPL HORIZONS data as NASA.
Zero PII Storage
Fully stateless architecture designed for high-compliance environments.
Transit Intelligence
Dynamic timing analysis with retrograde, lunar phases, eclipse detection, and aspect precision.
Built for Serious
Integrations
The Maphrodite Engine powers travel platforms and consumer apps worldwide. We provide custom rate limits, dedicated support, and architecture consultation to ensure a seamless rollout.