Getting Started

Go from zero to your first API response in three steps.

1 Get an API Key

Request an API key to authenticate your requests. All API keys use the format alm_live_... and are passed as a Bearer token in the Authorization header.

Create a free account to get your API key instantly.

Already have an account? See the authentication guide for details on passing your key.

2 Make Your First Request

Call any endpoint with your API key in the Authorization header. Here is how to fetch today's planetary positions:

cURL
curl https://api.almuten.io/v1/positions/today \
  -H "Authorization: Bearer YOUR_API_KEY"
TypeScript (fetch)
const response = await fetch("https://api.almuten.io/v1/positions/today", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
  },
});

const positions = await response.json();
console.log(positions);

3 Explore the API

The API has 100+ endpoints across five astrological traditions. Here are a few to try next:

Get today's horoscope for Aries
curl "https://api.almuten.io/v1/horoscope/daily?sign=aries" \
  -H "Authorization: Bearer YOUR_API_KEY"
Generate a natal chart
const response = await fetch("https://api.almuten.io/v1/chart/natal", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    date: "1990-06-15",
    time: "14:30",
    latitude: 40.7128,
    longitude: -74.006,
    houseSystem: "placidus",
  }),
});

const chart = await response.json();
console.log(chart);
Check if Mercury is retrograde
curl https://api.almuten.io/v1/events/retrogrades/current \
  -H "Authorization: Bearer YOUR_API_KEY"

Next Steps