Astrocartography API

Generate an astrocartography map of Midheaven, Imum Coeli, Ascendant, and Descendant planetary lines for any birth moment. Each line marks where a planet turns angular across the world, the core of relocation astrology and astro mapping. Returns right ascension, declination, the two meridian line longitudes, and sampled rising and setting curves ready to plot, with a short interpretation per line.

Request

POST /api/v2/astrology/astrocartography

{
  "date": "1990-07-15",
  "time": "14:30:00",
  "latitude": 40.7128,
  "longitude": -74.006,
  "timezone": -5
}

Response

Structured JSON with documented fields, covered by 6,905 automated tests per deploy, 1,491 of them gold-standard tests verified against NASA JPL Horizons. Not hallucinated text.

{
  "birthDetails": {
    "date": "1990-07-15",
    "time": "14:30:00",
    "latitude": 40.7128,
    "longitude": -74.006,
    "timezone": -5
  },
  "lines": [
    {
      "planet": "Sun",
      "rightAscension": 90.66,
      "declination": 23.44,
      "mc": {
        "longitude": -111.0142,
        "interpretation": "Your Sun Midheaven line runs through places where Self-awareness and ego comes forward in your public life, career, and reputation. Living or working along this line tends to push this part of you into the spotlight."
      },
      "ic": {
        "longitude": 68.9858,
        "interpretation": "Your Sun Imum Coeli line runs through places where Self-awareness and ego settles into your home, family, and inner foundations. This line deepens your sense of roots and private life."
      },
      "ascendant": {
        "points": [
          {
            "latitude": 40,
            "longitude": 139.7118
          }
        ],
        "circumpolarBeyond": 68.5262,
        "interpretation": "Your Sun Ascendant line runs through places where Self-awareness and ego colors your identity, vitality, and how you first come across to others. This part of you feels switched on here."
      },
      "descendant": {
        "points": [
          {
            "latitude": 40,
            "longitude": -1.7402
          }
        ],
        "circumpolarBeyond": 68.5262,
        "interpretation": "Your Sun Descendant line runs through places where Self-awareness and ego shapes your close relationships, partnerships, and the people you attract. Connection themes stand out along this line."
      }
    }
  ],
  "summary": "Astrocartography lines for 1990-07-15. 10 bodies, each with Midheaven, Imum Coeli, Ascendant, and Descendant lines mapping where their themes turn angular worldwide for relocation planning."
}

Supported options

Call it in your language in seconds.

Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.

import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.astrology.generateAstrocartography({ body: { date: '1990-07-15', time: '14:30:00', latitude: 40.7128, longitude: -74.006, timezone: -5 } })

from roxy_sdk import create_roxy

roxy = create_roxy("YOUR_API_KEY")
result = roxy.astrology.generate_astrocartography(date='1990-07-15', time='14:30:00', latitude=40.7128, longitude=-74.006, timezone='America/New_York')

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->astrology->generateAstrocartography(date: '1990-07-15', time: '14:30:00', latitude: 40.7128, longitude: -74.006, timezone: -5);

using RoxyApi;

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Astrology.Astrocartography.PostAsync(new() { /* request fields above */ });

import roxyapi "github.com/RoxyAPI/sdk-go"

roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Astrology.GenerateAstrocartography(ctx, nil, roxyapi.GenerateAstrocartographyJSONRequestBody{ /* request fields above */ })

curl -X POST "https://roxyapi.com/api/v2/astrology/astrocartography" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-07-15","time":"14:30:00","latitude":40.7128,"longitude":-74.006,"timezone":-5}'

More Astrocartography endpoints

The Astrocartography API bundles these related endpoints under one key.

Remote MCP for AI agents

Every Western Astrology endpoint is a callable tool on the Remote MCP server over Streamable HTTP. No local setup, no Docker. Claude, ChatGPT, Cursor, and any MCP client auto-discover the tools and ground their answers in verified data.

claude mcp add --transport http \
  roxy-astrology https://roxyapi.com/mcp/astrology \
  --header "X-API-Key: YOUR_KEY"

Tool name for POST /astrology/astrocartography: post_astrology_astrocartography. Full MCP setup guide

What you can build

Drop-in UI components & widgets

Render Astrocartography API responses without building charts yourself. Install the npm package and drop these into Next.js, React, Vue, Svelte, Angular, or plain HTML, or embed the very same component on Squarespace, Wix, or WordPress by pasting one snippet, with no backend and no build step. They belong to one library that covers the entire spiritual stack rather than astrology alone, MIT licensed and included in every plan at no extra cost, never a separate product and never an upsell. The Astrocartography API calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.

Astrocartography map widget snippetLocal space compass widget snippetRelocation wheel widget snippetThe complete UI libraryExplore Roxy UI

Related capabilities

Astrocartography API FAQ