Astrocartography API

Request

A real request: the demonstration chart against Lisbon.

curl -X POST https://api.natalchart.ai/v1/locations/score \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"location":{"name":"Lisbon","latitude":38.7223,"longitude":-9.1393}}'

Response

Part of the answer to that request: the main fields, with every list cut to its first three items.

{
  "relocated": {
    "ascendant": {
      "longitude": 277.7847,
      "sign": "Capricorn"
    },
    "midheaven": {
      "longitude": 210.708,
      "sign": "Scorpio"
    }
  },
  "angularPlanets": [
    {
      "planet": "Uranus",
      "angle": "ASC",
      "orb": 2.12,
      "weight": "major",
      "strength": "strong"
    },
    {
      "planet": "Neptune",
      "angle": "ASC",
      "orb": 6.31,
      "weight": "major",
      "strength": "weak"
    }
  ],
  "spheres": {
    "identity": {
      "score10": 1,
      "verdict": "challenging"
    },
    "love": {
      "score10": 6.1,
      "verdict": "slightly supportive"
    },
    "body": {
      "score10": 3.2,
      "verdict": "challenging"
    },
    "money": {
      "score10": 2.2,
      "verdict": "challenging"
    },
    "home": {
      "score10": 1.7,
      "verdict": "challenging"
    },
    "mind": {
      "score10": 4.9,
      "verdict": "neutral"
    }
  },
  "overall10": 2.2,
  "strength": "moderate"
}

What comes back

• relocated: the Ascendant and Midheaven the chart has in that place.
• angularPlanets: the planets on those angles, each with its angle, orb and strength.
• spheres: identity, love, body, money, home and mind, each from 0 to 10 with 5 as neutral; overall10 sums them up.
• strength: strong when a major planet is within 2° of an angle, moderate within 4°, faint otherwise. The rules come with the response.
• POST /v1/locations/rank returns the best cities from the catalogue, by all six spheres or the ones you choose, worldwide or in one region.

Limits

• API Pro only. On the free key both endpoints answer 403 with a link to upgrade.
• A birth time is required: relocation moves the angles, and the angles need the time.
• The ranking compares 61 major cities, not every place on Earth; any other place can be scored with POST /v1/locations/score.
• Birth data is read, used and forgotten: request bodies are never stored.

In an AI assistant

Through the MCP server at https://www.natalchart.ai/mcp, assistants call location_score for one place and best_cities for the best cities.

The rest of the API

The same key opens the whole astrology API: natal charts, daily transits, synastry, transits for a period, solar returns, best days and astrocartography. Every endpoint, field and error is in the documentation, and the pricing page says what counts as a request.

Questions