Developer Platform · v1.1.3

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.

As featured in National Geographic & Vogue

Quick Start

POST /v1/calculate-lines
bash — cURL
curl -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

GET / No auth required

Health check. Returns {"status":"online","service":"Maphrodite Calculation Engine"}

POST

/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
string required ISO date. Format: "YYYY-MM-DD" — e.g. "1990-05-20"
time
string required 24-hour UTC. Format: "HH:MM" — e.g. "14:30"
lat
float required Birth latitude. Range: -90 to 90
lon
float required Birth longitude. Range: -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
Authentication via X-API-KEY header. Contact api@maphrodite.com to request API access.
GeoJSON Compatible asc_line & dsc_line return {lat, lon} arrays — map directly to [lon, lat] for GeoJSON LineString coordinates Swiss Ephemeris Sub-arcsecond Precision ~120ms avg response

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
~120ms
Avg Response Time
99.97%
Uptime SLA
0.001"
Calculation Precision
24/7
Support

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.

Enterprise Access

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