The occult API

See it — the live console

Call the real API from this page. The Health check preset works with no key; the others expect an API key (add -H "X-API-Key: …" once you have one). Edit any request and hit Send.

What you get

A sample of the surface:

# Open — no key
curl "https://stars.madmanwithabox.org/api/stars/health"

# Everything else takes an API key
curl -H "X-API-Key: $STARS_API_KEY" \
  "https://stars.madmanwithabox.org/api/stars/esoteric/spirits?sign=Aries°ree=15"

import requests

# Open — no key
requests.get("https://stars.madmanwithabox.org/api/stars/health").json()

# Spirit lookup — with API key
r = requests.get("https://stars.madmanwithabox.org/api/stars/esoteric/spirits",
                 params={"sign": "Aries", "degree": 15},
                 headers={"X-API-Key": "sk-..."})
print(r.json()["goetic"]["name"])   # -> Marbas

// Open — no key
await fetch("https://stars.madmanwithabox.org/api/stars/health").then(r => r.json());

// Spirit lookup — with API key
const spirits = await fetch(
  "https://stars.madmanwithabox.org/api/stars/esoteric/spirits?sign=Aries°ree=15",
  { headers: { "X-API-Key": "sk-..." } }
).then(r => r.json());
console.log(spirits.goetic.name);   // -> "Marbas"

Why you can trust it

We serve the JSON. You build the thing.

Stars computes and documents; the application is yours. Founding developers get a permanent free account for telling us where the API is awkward, what's missing, and which endpoint you wish returned one more field.