Morphemeris DocsBeta

Introduction

Morphemeris is a REST API for astronomical ephemeris data — planetary positions, house cusps, fixed stars, and more.

Morphemeris API

Morphemeris is a metered REST API that provides sub-arcsecond astronomical ephemeris data. It's built on the Swiss Ephemeris, compiled to WebAssembly and deployed to Cloudflare's global edge network.

What you can compute

  • Planetary positions for Sun through Pluto, lunar nodes, and six asteroids (Ceres, Pallas, Juno, Vesta, Chiron, Pholus)
  • House cusps for all 22 house systems (Placidus, Koch, Whole Sign, Equal, and more)
  • Fixed star positions from the full Swiss Ephemeris catalog
  • Ayanamsha values for all 47 predefined sidereal systems
  • Delta T and sidereal time values
  • Combined chart data (positions + houses) in a single request

Quick example

curl "https://api.morphemeris.com/v1/positions?datetime=2024-03-20T12:00:00Z&bodies=sun,moon,mars" \
  -H "Authorization: Bearer morphemeris_live_your_key"
{
  "data": [
    {
      "body": "sun",
      "longitude": 0.0042,
      "latitude": 0.0001,
      "distance": 0.9960,
      "speed": 1.0096,
      "sign": "Aries",
      "sign_degree": 0.0042,
      "retrograde": false
    }
  ],
  "meta": {
    "version": "1.0-beta",
    "request_id": "a1b2c3d4-...",
    "credits_used": 1,
    "credits_remaining": 999,
    "computation_ms": 0.42
  }
}

Pricing

  • Free tier: 1,000 requests per month, no credit card required
  • Paid credits: $0.01 per request, purchased in advance, never expire

Get started →

On this page