The Astrocartography
Calculation Engine
Production-ready astrocartography REST API powered by Swiss Ephemeris. Returns planetary line GeoJSON vectors for any birth chart — ready to drop into Mapbox, Leaflet, or Google Maps in minutes.
Quick Start
POST /v1/calculate-linescurl -X POST "https://api.maphrodite.com/v1/calculate-lines" \ -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 }'
import requests url = "https://api.maphrodite.com/v1/calculate-lines" headers = { "X-API-KEY": "YOUR_API_KEY", "Content-Type": "application/json" } payload = { "date": "1990-05-20", "time": "14:30", # 24-hour UTC "lat": 51.5074, "lon": -0.1278 } response = requests.post(url, json=payload, headers=headers) lines = response.json() # list of PlanetLine objects for line in lines: print(line["planet"], line["mc_lon"])
const response = await fetch( "https://api.maphrodite.com/v1/calculate-lines", { method: "POST", headers: { "Content-Type": "application/json", "X-API-KEY": "YOUR_API_KEY" }, body: JSON.stringify({ date: "1990-05-20", time: "14:30", // 24-hour UTC lat: 51.5074, lon: -0.1278 }) } ); const lines = await response.json(); // lines: Array of PlanetLine objects
// Fetch lines then add to a Mapbox map const lines = await fetchPlanetaryLines(birthData); lines.forEach((line) => { // ASC curve — array of {lat, lon} coordinate objects map.addSource(`${line.planet}-asc`, { type: "geojson", data: { type: "Feature", geometry: { type: "LineString", coordinates: line.asc_line.map(p => [p.lon, p.lat]) } } }); map.addLayer({ id: `${line.planet}-asc-layer`, type: "line", source: `${line.planet}-asc`, paint: { "line-width": 2, "line-color": "#d4b4fc" } }); });
API Reference
Endpoints
/
No auth required
Health check. Returns {"status":"online","service":"Maphrodite Calculation Engine"}
/v1/calculate-lines
Core astrocartography endpoint. Provide a birth chart and receive MC/IC longitude lines and curved ASC/DSC coordinate arrays for all major planets — ready to render on any mapping library.
Request Body application/json · all fields required
date
"YYYY-MM-DD" — e.g. "1990-05-20"
time
"HH:MM" — e.g. "14:30"
lat
-90 to 90
lon
-180 to 180
Response 200 · Array of PlanetLine
planet
string
Planet name — e.g. "Sun", "Venus", "Mars"
mc_lon
float
Midheaven longitude — the vertical career/public life line
ic_lon
float
Imum Coeli longitude — the vertical home/roots line (mc_lon ± 180°)
asc_line
array of {lat, lon}
Coordinate path of the Ascendant curve across the globe
dsc_line
array of {lat, lon}
Coordinate path of the Descendant curve across the globe
Error Responses
401
Missing or invalid X-API-KEY header
422
Validation error — malformed or missing request fields
X-API-KEY header. Contact api@maphrodite.com to request API access.
Technical Specifications
Built for Scale
Swiss Ephemeris
Sub-arcsecond precision (0.001") using the same astronomical data source as NASA's JPL HORIZONS system.
- ±13,000 year date range
- Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto
Zero PII Storage
Fully stateless architecture. All calculations are processed in memory and immediately discarded — no personal data is ever written to disk.
- No database persistence
- GDPR & CCPA compliant
Map-Ready Vectors
ASC/DSC responses return {lat, lon} coordinate arrays that map directly to GeoJSON LineString geometries for Mapbox, Leaflet, and Google Maps.
- No post-processing required
- OpenAPI 3.1.0 spec available
Use Cases
Who Uses This API?
Travel Agencies & Platforms
Overlay planetary lines on destination maps. Show travellers which locations align with their Venus line for romance, Jupiter line for luck, or Sun line for vitality — adding a deeply personalised layer to trip planning.
Astrology App Developers
Add Swiss Ephemeris-grade astrocartography without building or maintaining the calculation engine. We handle the math — you focus on your UX and product.
Mapping & Visualisation Tools
Coordinate arrays drop straight into Mapbox, Leaflet, or Google Maps as GeoJSON LineString geometries. Plot a full chart's planetary lines in milliseconds with no additional data transformation.
Research & Education
Teaching tools, research platforms, and educational apps that need programmatic access to high-precision planetary calculations at scale.
Built for Serious Integrations
The Maphrodite Engine is used by travel platforms, consumer astrology apps, and location intelligence services worldwide. We work directly with teams to ensure the integration fits your architecture and scale.
Tell us about your use case — volume requirements, tech stack, and what you're building. We'll put together a proposal that fits.
api@maphrodite.com