✨ 🌟 💫

🪐 Cute Swiss Ephemeris API

Accurate planetary positions and astrological data for your apps. Perfect for astrologers, developers, and cosmic enthusiasts building magical tools.

Start with API Key (No CC Needed) View Documentation

Quick Example

# Call this URL within your site...

curl "https://cutemagick.com/api/ephemeris
      &year=1918
      &month=11
      &day=11
      &hour=3
      &minute=33
      &latitude=37.7749
      &longitude=-122.419"

// ...get back real astrology data like this!
{
  "planets": [
    {
      "name": "Sun",
      "sign": "Leo",
      "degree": 29,
      "house": 1,
      "retrograde": false,
    },
    {
      "name": "Moon",
      // ...and so on
    }
  ],
  "houses": [
    {
      "first": ["Mercury", "Pluto"]
      // second, third...
    }
  ],
  "aspects": [
    {
      "planet1": "Venus",
      "planet2": "Jupiter",
      "aspect": "Conjunct",
      "orb": 3
    },
    // more, as you can imagine
  ],
}

Powerful Features for Cosmic Developers

🎯

Precise Calculations

Swiss Ephemeris accuracy with planetary positions, signs, degrees, and retrograde status.

🌍

Global Locations

Works anywhere on Earth with latitude/longitude coordinates and timezone support.

💻

JSON Response

Clean, structured JSON output that's easy to integrate into any application.

🏠

House Systems

Support for Placidus sign house calculation systems.

⭐

Planetary Aspects

Aspect calculations between planets with orb precision.

⏰

Timezone Support

Automatically converts time parameters to your local time — based on the provided latitude and longitude.

Documentation

🎯 Base Endpoint

http

GET https://cutemagick.com/api/swisseph

Required Parameters:

year – Four-digit year, -3000 (BCE) to 3000
month – Month of events or birthdays e.g. 8 for August
day - Day of date, e.g. 14
hour – Hour of day in 24-hour format, e.g. 15 for 3PM.
minute – Minute of hour, 0–59
latitude – Location of event or birth latitude e.g. 34.234
longitude – Location of event or birth longitude e.g. -118.23401

Optional Parameters:

chartType – Natal | Synastry
compare – Object with same properties as required — for synastry

0️⃣ Leading 0s such "03" are OK but not required.

🔑 You need an API key (it's like a password) to access this service. Get yours free here.

   javascript
// Fetch a natal chart
const url =
  "https://cutemagick.com/api/swisseph?
  &year=1918
  &month=11
  &day=11
  &hour=3
  &minute=33
  &latitude=37.7749
  &longitude=-122.419";

const response = await fetch(url);
const data = await response.json();

// Example: list all planets
console.log(data.planets);

   python
import requests

# Define chart parameters
params = {
    "year": 1918,
    "month": 11,
    "day": 11,
    "hour": 3,
    "minute": 33,
    "latitude": 37.7749,
    "longitude": -122.419
}

# Send request
response = requests.get("https://cutemagick.com/api/swisseph", params=params)

# Parse response as JSON
data = response.json()

# Example: print planets
print(data["planets"])

✨ Example Response

// A real birth chart
// 📍 June 1, 1926, 9:30 AM, Los Angeles, California

{
  "planets": [
    {
      "name": "Sun",
      "sign": "Leo",
      "degree": 29,
      "house": 1,
      "retrograde": false
    },
    {
      "name": "Moon",
      "sign": "Cancer",
      "degree": 14,
      "house": 2,
      "retrograde": false
    },
    {
      "name": "Mercury",
      "sign": "Virgo",
      "degree": 5,
      "house": 1,
      "retrograde": true
    },
    {
      "name": "Venus",
      "sign": "Libra",
      "degree": 22,
      "house": 3,
      "retrograde": false
    },
    {
      "name": "Mars",
      "sign": "Scorpio",
      "degree": 10,
      "house": 4,
      "retrograde": false
    },
    {
      "name": "Jupiter",
      "sign": "Sagittarius",
      "degree": 18,
      "house": 5,
      "retrograde": false
    },
    {
      "name": "Saturn",
      "sign": "Capricorn",
      "degree": 2,
      "house": 6,
      "retrograde": true
    },
    {
      "name": "Uranus",
      "sign": "Aquarius",
      "degree": 27,
      "house": 7,
      "retrograde": false
    },
    {
      "name": "Neptune",
      "sign": "Pisces",
      "degree": 9,
      "house": 8,
      "retrograde": false
    },
    {
      "name": "Pluto",
      "sign": "Sagittarius",
      "degree": 15,
      "house": 5,
      "retrograde": true
    }
  ],
  "houses": [
    {
      "first": [
        "Sun",
        "Mercury"
      ]
    },
    {
      "second": [
        "Moon"
      ]
    },
    {
      "third": [
        "Venus"
      ]
    },
    {
      "fourth": [
        "Mars"
      ]
    },
    {
      "fifth": [
        "Jupiter",
        "Pluto"
      ]
    },
    {
      "sixth": [
        "Saturn"
      ]
    },
    {
      "seventh": [
        "Uranus"
      ]
    },
    {
      "eighth": [
        "Neptune"
      ]
    },
    {
      "ninth": []
    },
    {
      "tenth": []
    },
    {
      "eleventh": []
    },
    {
      "twelfth": []
    }
  ],
  "aspects": [
    {
      "planet1": "Sun",
      "planet2": "Moon",
      "aspect": "Square",
      "orb": 1.5
    },
    {
      "planet1": "Venus",
      "planet2": "Jupiter",
      "aspect": "Conjunct",
      "orb": 3
    },
  ]
}

Pricing

Try Cute Swiss Ephemeris free for 30 days with 111 requests/day. After that, $10/month for up to 1,111 requests/day.

Free Trial

30-Day Access

111/day

API requests

✅ 111 free requests daily
✅ All ephemeris data types
✅ No credit card needed

Start Free Today

Pro Plan

Unlimited Access

$10

per month

✨ Up to 1,111 requests daily
✨ Access to all ephemeris data
✨ Priority support

Start Free Today

Frequently Asked Questions

What's the accuracy level?

We use the Swiss Ephemeris, based on NASA’s JPL DE431 data, ensuring precision down to fractions of a degree.

Which house systems are supported?

Currently supported: Placidus

Can I get historical data?

Yes! The API supports dates from 3000 BCE to 3000 CE. Represent BCE years with a leading minus sign — for example, year=-44 gives results for 44 BCE.

What about rate limits?

The rate limit is 111 requests a day while you trying out the trial. After that, it's bumped up to 1,111 requests a day.

How do I use this?

You can call the API from any language with standard HTTP libraries. For step-by-step guides, examples, and best practices, visit the Library.

Can I cache responses?

Absolutely 😊 Planetary positions for specific times and locations never change, so caching results is safe and highly recommended.

Ready to Build Something Magical? 🪐

Join developers and astrologers using our API to create beautiful, accurate astrological applications.

Start Free Today

✨ Made with love for astrologers, developers, and cosmic enthusiasts

Thanks