Quick Start Playground SDK MCP Setup Free Templates AGENTS.md

Moon Phase API

Lunar phase calculator with zodiac sign

GET/astrology/moon-phase/currentGET/astrology/moon-phase/calendar/{year}/{month}GET/astrology/moon-phase/upcoming

Get API Key Try it live

Remote MCP server OpenAPI schema

Rated 4.5 by 127 developers

Includedwith every plan(at no extra cost)

Vedic Numerology Tarot Human Design Forecast Biorhythm I-Ching Crystals Dreams Angel Numbers Location

828 gold-standard tests, NASA JPL verified

12 domains, 1 API key

llms.txt for AI agents

Get current moon phase with illumination percentage, lunar age (days since new moon), zodiac sign, and distance from Earth. Returns phase name (New Moon, Waxing Crescent Moon, First Quarter Moon, Waxing Gibbous Moon, Full Moon, Waning Gibbous Moon, Last Quarter Moon, Waning Crescent Moon) plus exact lunar position. Perfect for moon tracking apps, lunar calendars, astrology widgets, and gardening by moon phase tools.

Request

GET /api/v2/astrology/moon-phase/current

Parameters

Parameter	Type	Description
langquery	string enum	Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English. Default `en`.
datequery	string (date)	Date in YYYY-MM-DD format. Defaults to today if omitted.
timequery	string (time)	Time in 24-hour HH:MM:SS format. Defaults to 12:00:00 (noon). Moon moves ~13 degrees per day so time affects phase precision.
timezonequery	number or string or value	IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours (e.g. -5 for EST, 1 for CET). IANA resolved to the DST-correct offset for the given date. Defaults to 0 (UTC). Default `0`.

Response

Structured JSON with documented fields, verified against NASA JPL Horizons across 828 gold-standard tests. Not hallucinated text.

200 OK

{
  "date": "2025-12-18",
  "phase": "Waxing Gibbous Moon",
  "illumination": 78.5,
  "age": 10.25,
  "sign": "Pisces",
  "degree": 15.42,
  "distance": 384400
}

Response fields

Field	Type	Description
date*	string	Date of this moon phase calculation (YYYY-MM-DD).
phase*	string	Current lunar phase name. One of: New Moon, Waxing Crescent Moon, First Quarter Moon, Waxing Gibbous Moon, Full Moon, Waning Gibbous Moon, Last Quarter Moon, Waning Crescent Moon.
illumination*	number	Moon illumination percentage (0-100). 0 = New Moon, 100 = Full Moon.
age*	number	Lunar age in days since the last New Moon. Full lunation cycle is ~29.53 days.
sign*	string	Tropical zodiac sign the Moon currently occupies.
degree*	number	Degree of the Moon within its current zodiac sign (0-29.999).
distance*	number	Distance from Earth to the Moon in kilometers.
meaning	object	Moon phase meaning and astrological interpretation. Includes energy direction, keywords, and guidance for this lunar phase.
meaning.name*	string	Moon phase display name.
meaning.symbol*	string	Moon phase emoji symbol.
meaning.description*	string	Astrological interpretation of this lunar phase and its influence on activities, emotions, and intentions.
meaning.keywords*	array of string	Key themes and activities aligned with this moon phase.
meaning.energy*	string enum	Lunar energy direction: waxing (building), waning (releasing), new (beginning), or full (culmination).
meaning.illumination*	string	Illumination range description for this phase.

Supported options

lang

entrdeeshiptfrru

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.

TypeScript

import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.astrology.getCurrentMoonPhase()

Install: npm install @roxyapi/sdk

Python

from roxy_sdk import create_roxy

roxy = create_roxy("YOUR_API_KEY")
result = roxy.astrology.get_current_moon_phase()

Install: pip install roxy-sdk

PHP

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->astrology->getCurrentMoonPhase();

Install: composer require roxyapi/sdk

using RoxyApi;

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Astrology.MoonPhase.Current.GetAsync();

Install: dotnet add package RoxyApi.Sdk

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

roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Astrology.GetCurrentMoonPhase(ctx, nil)

Install: go get github.com/RoxyAPI/sdk-go

cURL

curl "https://roxyapi.com/api/v2/astrology/moon-phase/current" \
  -H "X-API-Key: YOUR_KEY"

Prefer to try before you write code? Run this Western Astrology endpoint live in the API playground and inspect a real production response.

More Moon Phase endpoints

The Moon Phase API bundles these related endpoints under one key.

GET/astrology/moon-phase/calendar/{year}/{month}

Get lunar calendar - Moon phases for entire month

Get complete lunar calendar showing moon phase and illumination for every day of a specific month. Perfect for creating moon phase calendars, lunar planners, and astrology event schedules.

Try it live

GET/astrology/moon-phase/upcoming

Get upcoming moon phases - Next new moon, full moon, quarters

Get upcoming moon phase transitions (New Moon, First Quarter, Full Moon, Last Quarter) for the next weeks/months. Returns dates and phase names for each lunar quarter. Perfect for lunar event calendars, moon phase widgets, and astrology planning tools.

Try it live

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 Code / Cursor

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

Tool name for GET /astrology/moon-phase/current: get_astrology_moon_phase_current. Full MCP setup guide

What you can build

Launch natal chart apps with professional-grade accuracy: birth charts, planet positions, house placements, aspects, and element analysis ready for your UI in days

Add zodiac compatibility scoring to dating apps: synastry analysis, composite charts, and compatibility scores with detailed relationship dynamics

Ship personalized horoscope platforms: publisher-grade daily, weekly, and monthly forecasts with unique content per sign, active transit metadata, Moon phase data, and date scheduling for editorial pre-publishing

Build AI astrology chatbots with MCP: your OpenAI, Claude, or Gemini agent auto-discovers and calls every astrology endpoint with zero integration code

Power wellness and lifestyle apps with real-time transits, moon phase calendars, solar returns, and planetary movement alerts for self-discovery features

Create astrology content engines: automated zodiac content with house-based uniqueness per sign, horoscope newsletters with real lunar event dates, transit alerts, and seasonal forecasts at scale

Drop-in UI components

Render Moon Phase API responses without building charts yourself. These open source, framework-agnostic web components take the typed response and draw it, in React, Vue, Svelte, Angular, plain HTML, and WordPress.

<roxy-moon-phase>

See them live on Roxy UI

Related capabilities

Astrology Transits API

All of Western Astrology API

Moon Phase API FAQ

What does the Moon Phase API return?

Get current moon phase with illumination percentage, lunar age (days since new moon), zodiac sign, and distance from Earth. 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 Moon Phase 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 Moon Phase 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.

Is the Moon Phase 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 Moon Phase 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 Moon Phase API is included at no extra cost.

What lang values does the Moon Phase API accept?

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

Start using Moon Phase API today.

Ship your astrology app this weekend. Not this quarter.

All 12 domains included with every plan. Every endpoint, MCP server, SDK, and starters.

Plans from $39/mo, starting at $2.70 per domain on annual billing. No credit card required for testing.

View Pricing & Get API Key