Moon Phase

Lunar phase, illumination, age, and zodiac sign for a given date. Costs 1 credit.

GET /v1/moon-phase

Parameters

Name	Type	Required	Description
`date`	string	No	Date `YYYY-MM-DD`. Defaults to today.

Example request

curl "https://api.gitstrology.dev/v1/moon-phase?date=2026-08-02" \
  -H "X-API-Key: $GITSTROLOGY_API_KEY"

Example response

{
  "data": {
    "date": "2026-08-02",
    "phase": "waning_gibbous",
    "illumination": 0.74,
    "age": 18.3,
    "phaseAngle": 219.5,
    "zodiacSign": "aquarius",
    "name": "Waning Gibbous",
    "emoji": "🌖"
  },
  "credits": { "used": 1, "remaining": 99 }
}

Response fields

Field	Type	Description
`data.date`	string	Date queried.
`data.phase`	string	Phase key: new, waxing_crescent, first_quarter, waxing_gibbous, full, waning_gibbous, last_quarter, waning_crescent.
`data.illumination`	number	Fraction illuminated, 0–1.
`data.age`	number	Days since the last new moon.
`data.phaseAngle`	number	Moon phase angle in degrees.
`data.zodiacSign`	string	Tropical sign the moon is in.
`data.name`	string	Display name (e.g. "Waning Gibbous").
`data.emoji`	string	Phase emoji.