Quickstart

1. Create an account

Sign up at morphemeris.com/sign-up. No credit card required — the free tier includes 500 requests per month.

2. Create an API key

Go to your dashboard and click Create API Key. Copy the key — it's only shown once.

Your key looks like: morphemeris_live_abc123def456...

3. Make your first request

curl "https://api.morphemeris.com/v1/positions?datetime=2024-03-20T12:00:00Z" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

const res = await fetch(
  "https://api.morphemeris.com/v1/positions?datetime=2024-03-20T12:00:00Z",
  { headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const data = await res.json();

import requests

res = requests.get(
    "https://api.morphemeris.com/v1/positions",
    params={"datetime": "2024-03-20T12:00:00Z"},
    headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()

This returns the ecliptic positions of all planets (Sun through Pluto) plus the Mean Node for the 2024 vernal equinox.

4. Try a chart calculation

Compute a full natal chart with positions and houses in one request:

curl "https://api.morphemeris.com/v1/chart?datetime=1990-06-15T14:30:00Z&lat=40.7128&lon=-74.0060&system=placidus" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

5. Explore the API

Getting started with an AI coding agent

If you're using an AI coding agent (Claude Code, Cursor, Codex, etc.), here's how to integrate Morphemeris:

Steps your agent can do:

1. Read the OpenAPI spec to understand the API
2. Configure the API key as an environment variable
3. Write integration code and verify with a test call

Steps you need to do:

1. Sign up for an account
2. Create an API key and copy it
3. Provide the key to your agent (e.g., as MORPHEMERIS_API_KEY in your environment)