Moon-API Astrology API

The Astrology API from Moon-API — 1 operation(s) for astrology.

Operations 1

GET /astrology Get astrology data (natal chart and planetary positions)

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/moon-api-astrology-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

moon-api-astrology-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Moon-API.com Advanced Astrology API
  description: API for retrieving detailed moon phase data, sun data, calendars, and astronomical information
  version: 2.0.0
  contact:
    name: Moon-API.com
    url: https://moon-api.com
servers:
- url: https://moon-phase.p.rapidapi.com
  description: Production server (via RapidAPI)
security:
- RapidAPIKey: []
tags:
- name: Astrology
paths:
  /astrology:
    get:
      summary: Get astrology data (natal chart and planetary positions)
      description: Returns natal chart data, planetary positions, house cusps, and astrological aspects. Lat/lon are optional and default to London coordinates.
      parameters:
      - $ref: '#/components/parameters/latitudeParam'
      - $ref: '#/components/parameters/longitudeParam'
      - $ref: '#/components/parameters/timestampParam'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                        example: '2026-01-14T09:39:27Z'
                      location:
                        type: object
                        properties:
                          lat:
                            type: number
                            example: 51.5074
                          lon:
                            type: number
                            example: -0.1278
                          timezone:
                            type: string
                            example: Europe/London
                          house_system:
                            type: string
                            example: equal
                      coordinate_system:
                        type: string
                        example: tropical
                      zodiac:
                        type: string
                        example: tropical
                      ephemeris:
                        type: string
                        example: pyephem
                      reference_frame:
                        type: string
                        example: geocentric
                      longitude_type:
                        type: string
                        example: apparent
                      equinox:
                        type: string
                        example: date
                      orb_rules:
                        type: object
                        properties:
                          conjunction:
                            type: number
                            example: 8
                          sextile:
                            type: number
                            example: 6
                          square:
                            type: number
                            example: 8
                          trine:
                            type: number
                            example: 8
                          opposition:
                            type: number
                            example: 8
                  points:
                    type: object
                    description: Planetary positions (longitude and latitude in degrees)
                    properties:
                      sun:
                        type: object
                        properties:
                          lon:
                            type: number
                            example: 293.86
                          lat:
                            type: number
                            example: 0.0
                          house:
                            type: number
                            example: 11
                      moon:
                        type: object
                        properties:
                          lon:
                            type: number
                            example: 244.62
                          lat:
                            type: number
                            example: -5.1
                          house:
                            type: number
                            example: 10
                      mercury:
                        type: object
                      venus:
                        type: object
                      mars:
                        type: object
                      jupiter:
                        type: object
                      saturn:
                        type: object
                      uranus:
                        type: object
                      neptune:
                        type: object
                      pluto:
                        type: object
                  houses:
                    type: object
                    properties:
                      cusps:
                        type: array
                        items:
                          type: number
                        example:
                        - 333.67
                        - 3.67
                        - 33.67
                        - 63.67
                        - 93.67
                        - 123.67
                        - 153.67
                        - 183.67
                        - 213.67
                        - 243.67
                        - 273.67
                        - 303.67
                      ascendant:
                        type: number
                        example: 333.67
                      midheaven:
                        type: number
                        example: 258.61
                  aspects:
                    type: array
                    items:
                      type: object
                      properties:
                        p1:
                          type: string
                          description: First planet
                          example: sun
                        p2:
                          type: string
                          description: Second planet
                          example: mercury
                        type:
                          type: string
                          description: Aspect type
                          example: conjunction
                        orb:
                          type: number
                          description: Orb in degrees
                          example: 4.56
              example:
                meta:
                  timestamp: '2026-01-14T09:39:27Z'
                  location:
                    lat: 51.5074
                    lon: -0.1278
                    timezone: Europe/London
                    house_system: equal
                  coordinate_system: tropical
                  zodiac: tropical
                  ephemeris: pyephem
                  reference_frame: geocentric
                  longitude_type: apparent
                  equinox: date
                  orb_rules:
                    conjunction: 8
                    sextile: 6
                    square: 8
                    trine: 8
                    opposition: 8
                points:
                  sun:
                    lon: 293.86
                    lat: 0.0
                    house: 11
                  moon:
                    lon: 244.62
                    lat: -5.1
                    house: 10
                houses:
                  cusps:
                  - 333.67
                  - 3.67
                  - 33.67
                  - 63.67
                  - 93.67
                  - 123.67
                  - 153.67
                  - 183.67
                  - 213.67
                  - 243.67
                  - 273.67
                  - 303.67
                  ascendant: 333.67
                  midheaven: 258.61
                aspects:
                - p1: sun
                  p2: mercury
                  type: conjunction
                  orb: 4.56
        '400':
          description: Bad request
        '500':
          description: Server error
      tags:
      - Astrology
components:
  parameters:
    longitudeParam:
      name: lon
      in: query
      description: Longitude coordinate (-180 to 180). Optional, defaults to -0.1278 (London, UK - west is negative)
      required: false
      schema:
        type: number
        minimum: -180
        maximum: 180
        default: -0.1278
    latitudeParam:
      name: lat
      in: query
      description: Latitude coordinate (-90 to 90). Optional, defaults to 51.5074 (London, UK)
      required: false
      schema:
        type: number
        minimum: -90
        maximum: 90
        default: 51.5074
    timestampParam:
      name: timestamp
      in: query
      description: Unix timestamp (optional, defaults to current time)
      required: false
      schema:
        type: integer
  securitySchemes:
    RapidAPIKey:
      type: apiKey
      name: x-rapidapi-key
      in: header
      description: RapidAPI authentication key