# Moon Phase API

> Moon Phase API. Get current moon phase with illumination percentage, lunar age (days since new moon), zodiac sign, and distance from Earth. Returns phase

- Capability page: https://roxyapi.com/apis/moon-phase-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

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.

## Endpoints

- `GET /api/v2/astrology/moon-phase/current` Get current moon phase - Lunar phase calculator with zodiac sign
- `GET /api/v2/astrology/moon-phase/calendar/{year}/{month}` Get lunar calendar - Moon phases for entire month
- `GET /api/v2/astrology/moon-phase/upcoming` Get upcoming moon phases - Next new moon, full moon, quarters

## Example request

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

## Example response

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

## 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 `GET /astrology/moon-phase/current`: `get_astrology_moon_phase_current`. `tools/list` is free; `tools/call` bills the same as REST.

## 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.

## Full reference

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