Moon

Provide moonrise time, moonset time, and moon phase data.

API

curl "https://singer.caiyunhub.com/v3/astro/moon/?longitude=-74&latitude=40.7&lang=en&days=15&token={token}"

Query Parameters:

Parameter	Type	Optional	Default Value	Description
longitude	float	✅	0.0	Longitude
latitude	float	✅	0.0	Latitude
lang	enum	✅	en	Language parameter, see Multilingual Support for details
days	int	✅	3	Number of days, support range [1, 15]

Response

{
  "moon": [
    {
      "date": "2024-04-09",
      "rise": "06:53",
      "set": "20:54",
      "phase": 5.7,
      "phase_name": "New Moon"
    },
    // ...
    {
      "date": "2024-04-23",
      "rise": "19:48",
      "set": "05:42",
      "phase": 170.78,
      "phase_name": "Full Moon"
    }
  ]
}

Field	Type	Description
date	string	Date
rise	string	Rise time, - if not applicable
set	string	Set time, - if not applicable
phase	float
phase_name	enum	Name of the moon phase

Supported moon phase values in English environment:

Emoji	Phase
🌑	New Moon
🌒	Waxing crescent
🌓	First quarter
🌔	Waxing gibbous
🌕	Full Moon
🌖	Waning gibbous
🌗	Last quarter
🌘	Waning crescent