Get moon plase by specified date

GET

/v1/moonPhaseDate

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

🟢200moonPhaseDate

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://moonwalker.world/api/v1/moonPhaseDate?utc=UTC+5&lang=ru&precision=5&latitude=51.1655&longitude=71.4272&year=2025&month=01&day=01&hour=01&minute=01&second=01&timeFormat=2006-01-02 15:04'

Response Example

{
    "BeginDay": {
        "MoonDays": 0.85568,
        "Illumination": 0.35744,
        "Phase": {
            "Name": "New Moon",
            "NameLocalized": "Новолуние",
            "Emoji": "🌑",
            "IsWaxing": true
        },
        "Zodiac": {
            "Name": "Virgo",
            "NameLocalized": "Дева",
            "Emoji": "♍"
        },
        "MoonPosition": {
            "Time": "2025-01-01T00:00:00+05:00",
            "AzimuthDegrees": 326.86255,
            "AltitudeDegrees": -62.68617,
            "Direction": "NNW",
            "DistanceKm": 382464.56722
        }
    },
    "CurrentState": {
        "MoonDays": 0.89806,
        "Illumination": 0.4137,
        "Phase": {
            "Name": "New Moon",
            "NameLocalized": "Новолуние",
            "Emoji": "🌑",
            "IsWaxing": true
        },
        "Zodiac": {
            "Name": "Virgo",
            "NameLocalized": "Дева",
            "Emoji": "♍"
        },
        "MoonPosition": {
            "Time": "2025-01-01T01:01:01+05:00",
            "AzimuthDegrees": 356.08557,
            "AltitudeDegrees": -65.49632,
            "Direction": "N",
            "DistanceKm": 382316.55173
        }
    },
    "EndDay": {
        "MoonDays": 1.85568,
        "Illumination": 2.79491,
        "Phase": {
            "Name": "New Moon",
            "NameLocalized": "Новолуние",
            "Emoji": "🌑",
            "IsWaxing": true
        },
        "Zodiac": {
            "Name": "Virgo",
            "NameLocalized": "Дева",
            "Emoji": "♍"
        },
        "MoonPosition": {
            "Time": "2025-01-02T00:00:00+05:00",
            "AzimuthDegrees": 309.21002,
            "AltitudeDegrees": -54.25535,
            "Direction": "NW",
            "DistanceKm": 379194.7976
        }
    },
    "MoonDaysDetailed": {
        "Count": 2,
        "Day": [
            {
                "Begin": "2024-12-31T09:18:42+05:00",
                "IsBeginExists": true,
                "End": "2025-01-01T09:55:21+05:00",
                "IsEndExists": true
            },
            {
                "Begin": "2025-01-01T09:55:21+05:00",
                "IsBeginExists": true,
                "End": "2025-01-02T10:21:16+05:00",
                "IsEndExists": true
            }
        ]
    },
    "ZodiacDetailed": {
        "Count": 1,
        "Zodiac": [
            {
                "Name": "Virgo",
                "NameLocalized": "Дева",
                "Emoji": "♍",
                "Begin": "2024-12-31T03:27:49+05:00",
                "End": "2025-01-02T15:27:49+05:00"
            }
        ]
    },
    "MoonRiseAndSet": {
        "IsMoonRise": true,
        "IsMoonSet": true,
        "IsMeridian": true,
        "Moonrise": {
            "Time": "2025-01-01T09:55:21+05:00",
            "AzimuthDegrees": 133.52155,
            "AltitudeDegrees": -0.56667,
            "Direction": "SE",
            "DistanceKm": 381054.53085
        },
        "Moonset": {
            "Time": "2025-01-01T17:26:16+05:00",
            "AzimuthDegrees": 228.55471,
            "AltitudeDegrees": -0.56667,
            "Direction": "SW",
            "DistanceKm": 380040.1844
        },
        "Meridian": {
            "Time": "2025-01-01T13:36:45+05:00",
            "AzimuthDegrees": 180,
            "AltitudeDegrees": 13.2,
            "Direction": "S",
            "DistanceKm": 380550.46947
        }
    }
}

Modified at 2025-11-16 19:06:35

Get moon phase by current date