Get moon phase by timestamp

GET

/v1/moonPhaseTimestamp

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

🟢200moonPhaseTimestamp

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

{
    "BeginDay": {
        "MoonDays": 23.53674,
        "Illumination": 38.2726,
        "Phase": {
            "Name": "Waning Crescent",
            "NameLocalized": "Убывающий серп",
            "Emoji": "🌘",
            "IsWaxing": false
        },
        "Zodiac": {
            "Name": "Gemini",
            "NameLocalized": "Близнецы",
            "Emoji": "♊"
        },
        "MoonPosition": {
            "Time": "2025-09-16T00:00:00+05:00",
            "AzimuthDegrees": 57.08873,
            "AltitudeDegrees": 8.79646,
            "Direction": "ENE",
            "DistanceKm": 376559.88437
        }
    },
    "CurrentState": {
        "MoonDays": 24.28786,
        "Illumination": 30.38659,
        "Phase": {
            "Name": "Waning Crescent",
            "NameLocalized": "Убывающий серп",
            "Emoji": "🌘",
            "IsWaxing": false
        },
        "Zodiac": {
            "Name": "Gemini",
            "NameLocalized": "Близнецы",
            "Emoji": "♊"
        },
        "MoonPosition": {
            "Time": "2025-09-16T18:01:37+05:00",
            "AzimuthDegrees": 332.40261,
            "AltitudeDegrees": -8.94892,
            "Direction": "NNW",
            "DistanceKm": 379152.9693
        }
    },
    "EndDay": {
        "MoonDays": 24.53674,
        "Illumination": 27.90729,
        "Phase": {
            "Name": "Waning Crescent",
            "NameLocalized": "Убывающий серп",
            "Emoji": "🌘",
            "IsWaxing": false
        },
        "Zodiac": {
            "Name": "Gemini",
            "NameLocalized": "Близнецы",
            "Emoji": "♊"
        },
        "MoonPosition": {
            "Time": "2025-09-17T00:00:00+05:00",
            "AzimuthDegrees": 48.0345,
            "AltitudeDegrees": -0.14735,
            "Direction": "NE",
            "DistanceKm": 380020.57994
        }
    },
    "MoonDaysDetailed": {
        "Count": 2,
        "Day": [
            {
                "Begin": "2025-09-15T22:37:45+05:00",
                "IsBeginExists": true,
                "End": "2025-09-16T23:56:10+05:00",
                "IsEndExists": true
            },
            {
                "Begin": "2025-09-16T23:56:10+05:00",
                "IsBeginExists": true,
                "IsEndExists": false
            }
        ]
    },
    "ZodiacDetailed": {
        "Count": 1,
        "Zodiac": [
            {
                "Name": "Gemini",
                "NameLocalized": "Близнецы",
                "Emoji": "♊",
                "Begin": "2025-09-14T23:07:06+05:00",
                "End": "2025-09-17T11:07:06+05:00"
            }
        ]
    },
    "MoonRiseAndSet": {
        "IsMoonRise": true,
        "IsMoonSet": true,
        "IsMeridian": true,
        "Moonrise": {
            "Time": "2025-09-16T23:56:10+05:00",
            "AzimuthDegrees": 47.31764,
            "AltitudeDegrees": -0.56667,
            "Direction": "NE",
            "DistanceKm": 380011.3104
        },
        "Moonset": {
            "Time": "2025-09-16T16:29:52+05:00",
            "AzimuthDegrees": 314.4689,
            "AltitudeDegrees": -0.56667,
            "Direction": "NW",
            "DistanceKm": 378931.34559
        },
        "Meridian": {
            "Time": "2025-09-16T07:40:36+05:00",
            "AzimuthDegrees": 180,
            "AltitudeDegrees": 65.7,
            "Direction": "S",
            "DistanceKm": 377658.15629
        }
    }
}

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

Get moon phase by current date

Get moon phases table by specified year