# Natal Chart API

> Natal Chart API. Calculate complete Western astrology natal chart (birth chart) with tropical zodiac. Returns all 14 celestial bodies (the 10 classical

- Capability page: https://roxyapi.com/apis/natal-chart-api
- Full domain: https://roxyapi.com/products/astrology-api
- OpenAPI spec: https://roxyapi.com/api/v2/astrology/openapi.json
- Remote MCP server: https://roxyapi.com/mcp/astrology

## Overview

Calculate complete Western astrology natal chart (birth chart) with tropical zodiac. Returns all 14 celestial bodies (the 10 classical planets Sun through Pluto, the lunar nodes, Chiron, and Black Moon Lilith), 12 house cusps with customizable house systems (Placidus, Whole Sign, Equal, Koch), major and minor aspects, Ascendant, Midheaven, dominant elements and modalities. Perfect for astrology apps, birth chart generators, horoscope websites, and astrological consultation tools. Verified against NASA JPL Horizons.

## Endpoints

- `POST /api/v2/astrology/natal-chart` Generate natal chart - Birth chart calculator API with houses and aspects

## Example request

```bash
curl -X POST "https://roxyapi.com/api/v2/astrology/natal-chart" \
  -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}'
```

## Example response

```json
{
  "birthDetails": {
    "date": "1990-07-15",
    "time": "14:30:00",
    "latitude": 40.7128,
    "longitude": -74.006,
    "timezone": -5
  },
  "planets": [
    {
      "name": "Sun",
      "longitude": 112.45,
      "latitude": 0.01,
      "sign": "Cancer",
      "degree": 22.45,
      "house": 7,
      "speed": 0.9571,
      "isRetrograde": false
    }
  ],
  "houses": [
    {
      "number": 1,
      "longitude": 45.32,
      "sign": "Taurus",
      "degree": 15.32
    }
  ],
  "houseSystem": "placidus",
  "aspects": [
    {
      "planet1": "Sun",
      "planet2": "Moon",
      "type": "TRINE",
      "angle": 120,
      "orb": 2.5,
      "isApplying": true,
      "strength": 75,
      "interpretation": "harmonious"
    }
  ],
  "aspectsInterpretation": {
    "summary": "Your chart contains 15 aspects: 8 harmonious, 5 challenging, and 2 neutral. This creates a harmonious overall pattern.",
    "dominant": "harmonious",
    "harmonious": 8,
    "challenging": 5,
    "neutral": 2
  },
  "ascendant": {
    "sign": "Taurus",
    "degree": 15.32,
    "longitude": 45.32
  },
  "midheaven": {
    "sign": "Aquarius",
    "degree": 8.76,
    "longitude": 308.76
  },
  "partOfFortune": {
    "sign": "Aries",
    "degree": 27.24,
    "longitude": 27.24,
    "sect": "night"
  },
  "vertex": {
    "sign": "Virgo",
    "degree": 12.9,
    "longitude": 162.9
  },
  "summary": {
    "dominantElement": "Water",
    "dominantModality": "Cardinal",
    "retrogradePlanets": [
      "Mercury",
      "Saturn"
    ],
    "elementDistribution": {
      "Fire": 2,
      "Earth": 3,
      "Air": 1,
      "Water": 4
    },
    "modalityDistribution": {
      "Cardinal": 4,
      "Fixed": 3,
      "Mutable": 3
    }
  }
}
```

## Remote MCP

Every endpoint is a callable tool on the Remote MCP server at https://roxyapi.com/mcp/astrology over Streamable HTTP. Tool name for `POST /astrology/natal-chart`: `post_astrology_natal_chart`. `tools/list` is free; `tools/call` bills the same as REST.

## FAQ

### What does the Natal Chart API return?

Calculate complete Western astrology natal chart (birth chart) with tropical zodiac. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.

### How do I authenticate with the Natal Chart API?

Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.

### Does the Natal Chart API support multiple languages?

Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.

### Do I need coordinates to call the Natal Chart API?

No. Call GET /location/search with a city name first, then pass latitude, longitude, and timezone from the first result into the request. Never ask users to type coordinates. Timezone accepts a decimal offset or an IANA name.

### Is the Natal Chart API available over Remote MCP for AI agents?

Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/astrology over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.

### How is the Natal Chart API billed?

Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 12 domains, so the Natal Chart API is included at no extra cost.

### What lang values does the Natal Chart API accept?

The lang parameter accepts en, tr, de, es, hi, pt, fr, ru. Case-insensitive where it is a path value.

## Full reference

Fetch the OpenAPI spec at https://roxyapi.com/api/v2/astrology/openapi.json. Master agent manifest at https://roxyapi.com/llms.txt.