Get moon phase by current date

GET

/v1/moonPhaseCurrent

Detailed information:

https://github.com/prostraction/moon?tab=readme-ov-file#get-v1moonphasedate

The method returns 6 objects:

BeginDay, CurrentState, EndDay objects of the MoonStatstructure to display the position of the moon at the beginning of the day, the specified time and the end of the day, respectively;

MoonDaysDetailed (optional), a structure for determining the number of lunar days on a given day;

ZodiacDetailed (required), a structure for determining which
zodiac sign the moon is in on a given time interval, when it began and ended. It contains an array for each lunar day that falls on a given Earth day;

MoonRiseAndSet (optional), a structure for determining the moonrise, moonset and meridian on a given day. Missing if no coords specified. Parts of this struct may be missing.

Request

Query Params

Responses

🟢200moonPhaseCurrent

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://moonwalker.world/api/v1/moonPhaseCurrent?utc=UTC+5&lang=ru&precision=5&latitude=51.1655&longitude=71.4272&timeFormat=2006-01-02 15:04'

Response Example

{
    "BeginDay": {
        "MoonDays": 25.27363,
        "Illumination": 19.40433,
        "Phase": {
            "Name": "Waning Crescent",
            "NameLocalized": "Убывающий серп",
            "Emoji": "🌘",
            "IsWaxing": false
        },
        "Zodiac": {
            "Name": "Cancer",
            "NameLocalized": "Рак",
            "Emoji": "♋"
        },
        "MoonPosition": {
            "Time": "2025-11-16T00:00:00+05:00",
            "AzimuthDegrees": 56.78112,
            "AltitudeDegrees": -28.52163,
            "Direction": "ENE",
            "DistanceKm": 400130.90444
        }
    },
    "CurrentState": {
        "MoonDays": 26.24569,
        "Illumination": 12.55125,
        "Phase": {
            "Name": "Waning Crescent",
            "NameLocalized": "Убывающий серп",
            "Emoji": "🌘",
            "IsWaxing": false
        },
        "Zodiac": {
            "Name": "Cancer",
            "NameLocalized": "Рак",
            "Emoji": "♋"
        },
        "MoonPosition": {
            "Time": "2025-11-16T23:19:46+05:00",
            "AzimuthDegrees": 38.89192,
            "AltitudeDegrees": -42.30857,
            "Direction": "NE",
            "DistanceKm": 402829.6361
        }
    },
    "EndDay": {
        "MoonDays": 26.27363,
        "Illumination": 12.37382,
        "Phase": {
            "Name": "Waning Crescent",
            "NameLocalized": "Убывающий серп",
            "Emoji": "🌘",
            "IsWaxing": false
        },
        "Zodiac": {
            "Name": "Cancer",
            "NameLocalized": "Рак",
            "Emoji": "♋"
        },
        "MoonPosition": {
            "Time": "2025-11-17T00:00:00+05:00",
            "AzimuthDegrees": 50.22016,
            "AltitudeDegrees": -38.1823,
            "Direction": "NE",
            "DistanceKm": 402895.89872
        }
    },
    "MoonDaysDetailed": {
        "Count": 2,
        "Day": [
            {
                "Begin": "2025-11-15T02:05:18+05:00",
                "IsBeginExists": true,
                "End": "2025-11-16T03:16:31+05:00",
                "IsEndExists": true
            },
            {
                "Begin": "2025-11-16T03:16:31+05:00",
                "IsBeginExists": true,
                "End": "2025-11-17T04:27:24+05:00",
                "IsEndExists": true
            }
        ]
    },
    "ZodiacDetailed": {
        "Count": 1,
        "Zodiac": [
            {
                "Name": "Cancer",
                "NameLocalized": "Рак",
                "Emoji": "♋",
                "Begin": "2025-11-15T17:25:58+05:00",
                "End": "2025-11-18T05:25:58+05:00"
            }
        ]
    },
    "MoonRiseAndSet": {
        "IsMoonRise": true,
        "IsMoonSet": true,
        "IsMeridian": true,
        "Moonrise": {
            "Time": "2025-11-16T03:16:31+05:00",
            "AzimuthDegrees": 97.01341,
            "AltitudeDegrees": -0.56667,
            "Direction": "E",
            "DistanceKm": 400556.57352
        },
        "Moonset": {
            "Time": "2025-11-16T14:35:54+05:00",
            "AzimuthDegrees": 258.70682,
            "AltitudeDegrees": -0.56667,
            "Direction": "WSW",
            "DistanceKm": 401909.79218
        },
        "Meridian": {
            "Time": "2025-11-16T09:03:07+05:00",
            "AzimuthDegrees": 180,
            "AltitudeDegrees": 32.6,
            "Direction": "S",
            "DistanceKm": 401269.77889
        }
    }
}

Modified at 2025-11-16 18:53:17

Get moon plase by specified date

Get moon phase by timestamp