lang
entrdeeshiptfrruzh-Hanszh-Hant
Moon Phase API
Lunar phase calculator with zodiac sign
GET
/astrology/moon-phase/currentGET /astrology/moon-phase/calendar/{year}/{month}GET /astrology/moon-phase/upcomingIncluded with every plan (at no extra cost)
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, optional | string enum | Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default en. |
datequery, optional | string (date) | Date in YYYY-MM-DD format. Defaults to today if omitted. |
timequery, optional | 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, optional | string | IANA name (e.g. "America/New_York", "Europe/London"), decimal hours (e.g. -5 for EST, 1 for CET), or a fixed UTC offset (e.g. "-05:00"). IANA resolved to the DST-correct offset for the given date. With `date` omitted, today is the date in this zone. Defaults to 0 (UTC). |
Response
Structured JSON with documented fields, covered by 13,957 automated tests per deploy, 3,683 of them gold-standard tests verified against NASA JPL Horizons. Not hallucinated text.
{
"date": "2026-11-03",
"phase": "Waning Crescent Moon",
"illumination": 32.27,
"age": 23.84,
"sign": "Virgo",
"degree": 1.99,
"distance": 378243,
"meaning": {
"name": "Waning Crescent Moon",
"symbol": "🌘",
"description": "This is a time for recuperation. To be fully open to the next cycle, one must completely be relieved from this one.",
"keywords": [
"surrender",
"rest",
"recuperation",
"reflection",
"closure"
],
"energy": "waning",
"illumination": "0-50% (Waning)"
}
}Response fields
| Field | Type | Description |
|---|---|---|
daterequired | string | Date of this moon phase calculation (YYYY-MM-DD). |
phaserequired | 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. |
illuminationrequired | number | Moon illumination percentage (0-100). 0 = New Moon, 100 = Full Moon. |
agerequired | number | Lunar age in days since the last New Moon. Full lunation cycle is ~29.53 days. |
signrequired | string | Tropical zodiac sign the Moon currently occupies. |
degreerequired | number | Degree of the Moon within its current zodiac sign (0-29.999). |
distancerequired | number | Distance from Earth to the Moon in kilometers. |
meaningoptional | object | Moon phase meaning and astrological interpretation. Includes energy direction, keywords, and guidance for this lunar phase. |
meaning.namerequired | string | Moon phase display name. |
meaning.symbolrequired | string | Moon phase emoji symbol. |
meaning.descriptionrequired | string | Astrological interpretation of this lunar phase and its influence on activities, emotions, and intentions. |
meaning.keywordsrequired | array of string | Key themes and activities aligned with this moon phase. |
meaning.energyrequired | string enum | Lunar energy direction: waxing (building), waning (releasing), new (beginning), or full (culmination). |
meaning.illuminationrequired | string | Illumination range description for this phase. |
Supported options
Call it in your language.
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.getCurrentMoonPhase()Install: npm install @roxyapi/sdk
from roxy_sdk import create_roxy
roxy = create_roxy("YOUR_API_KEY")
result = roxy.astrology.get_current_moon_phase()Install: pip install roxy-sdk
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
use roxyapi::{Roxy, types};
async fn call(roxy: &Roxy, params: &types::GetCurrentMoonPhaseParams) -> Result<(), roxyapi::Error> {
let result = roxy.astrology().get_current_moon_phase(params).await?;
println!("{result:?}");
Ok(())
}Install: cargo add roxyapi
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.
/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.
/astrology/moon-phase/upcomingGet upcoming moon phases - Next new moon, full moon, quarters
Get upcoming moon phase transitions (New Moon, First Quarter Moon, Full Moon, Third Quarter Moon) 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.
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 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
- Add zodiac compatibility scoring to dating apps: synastry analysis, composite charts, and compatibility scores with detailed relationship dynamics
- Ship personalized horoscope platforms: editorial daily, weekly, monthly, and yearly columns with unique content per sign, the dated events each one rests on returned beside the prose for fact-checking, active transit metadata, Moon phase data, and any past or future period on request 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 year-ahead pages built from every eclipse and every retrograde and direct station of the year with the house each one falls in for that sign
No-code widgets and drop-in UI components.
This is what your visitors see. Paste one snippet into Wix, Squarespace, or WordPress and the Moon Phase API reading appears on your site, with no code and no backend. Developers install the same components from npm for Next.js, React, Vue, Svelte, Angular, or plain HTML. MIT licensed and included in every plan.
MIT licensedFramework agnosticThemeable via CSS variablesnpm or CDN
Show all Moon Phase UI componentsShow fewer Moon Phase UI components
| Element | Renders |
|---|---|
<roxy-moon-phase> | Moon phase card and calendar |
Related capabilities
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 18+ domains, so the Moon Phase API is included at no extra cost.
Start using Moon Phase API today.
Birth charts checked cusp by cusp, and horoscopes that name the dated sky events behind each reading.
All 18+ domains included with every plan. Every endpoint, MCP server, SDK, and templates.
Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.
View Pricing & Get API Key