Перейти до вмісту
AstroWay/api v2.325.2 · docs
усі системи в нормі

Moon Phase (public, no key)

Відкрити як Markdown Налаштування агента
GET
/public/moon-phase
Code sample: cURL
request.sh
curl 'https://api.astroway.info/v1/public/moon-phase'

Geocentric moon phase for a date (computed at noon UTC): deterministic, no AI, no birth data. _footer watermark. The English phaseName, moonSign and sunSign are the stable identifiers to match on and never change; phaseKey is the eight-phase key (new, crescent, firstQuarter, gibbous, full, disseminating, lastQuarter, balsamic). moonDegree is the degree inside moonSign, distanceKm the Earth-Moon distance, and next the UTC moments of the next four principal phases after noon UTC of date. tithi is the Vedic lunar day (1-30, 12 degrees of elongation each, geocentric), voidOfCourse the void-of-course spans that touch the UTC day (start, end, the sign the Moon enters). The moonrise-counted lunar day depends on the place and is not given. meaning and keywords are English; localized carries them with the phase and sign names in the requested language (a language whose translation has not arrived yet gets the English text).

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
date
string format: date

Calendar date YYYY-MM-DD (UTC). Defaults to today.

lang
string
Example 
en

Language for this call, overriding Accept-Language. The canonical per-call form: a page that renders in one language passes it here rather than reconfiguring its client. Unknown or inactive codes fall back to uk.

fields
string

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

Example 
planets.name,planets.longitude
precision
integer
<= 15

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Example 
4

Header Parameters

Section titled “Header Parameters ”
Accept-Language
string

BCP-47 language (e.g. uk, en, de). Set it once on your HTTP client as its default; for a single call, ?lang= overrides it. Unknown or inactive codes fall back to uk.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

Media type application/json
object
ok
boolean
data
object
date
string
nullable
phase
number
nullable
phaseName
string
nullable
phaseKey
string
nullable
majorPhase
string
nullable
illuminationPercent
number
nullable
elongationDeg
number
nullable
ageDays
number
nullable
waxing
boolean
nullable
moonSign
string
nullable
sunSign
string
nullable
moonLongitude
number
nullable
moonDegree
number
nullable
distanceKm
number
nullable
tithi
object
number
number
nullable
name
string
nullable
paksha
string
nullable
indexInPaksha
number
nullable
elongation
number
nullable
percentComplete
number
nullable
voidOfCourse
Array
nullable
next
object
newMoon
string
nullable
firstQuarter
string
nullable
fullMoon
string
nullable
lastQuarter
string
nullable
meaning
string
nullable
keywords
Array<string>
nullable
localized
object
phaseName
string
nullable
moonSign
string
nullable
sunSign
string
nullable
meaning
string
nullable
keywords
Array<string>
nullable
_footer

Free-tier watermark, present on every public response. Keys on a paid plan do not receive it.

string
Example 
{
  "ok": true,
  "data": {
    "date": "2026-10-06",
    "phase": 0.19061,
    "phaseName": "Waning Crescent",
    "phaseKey": "balsamic",
    "majorPhase": "between",
    "illuminationPercent": 19.06,
    "elongationDeg": 308.2271,
    "ageDays": 25.284,
    "waxing": false,
    "moonSign": "Leo",
    "sunSign": "Libra",
    "moonLongitude": 141.4802,
    "moonDegree": 21.4802,
    "distanceKm": 374721,
    "tithi": {
      "number": 26,
      "name": "Ekadashi",
      "paksha": "krishna",
      "indexInPaksha": 11,
      "elongation": 308.227,
      "percentComplete": 0.686
    },
    "voidOfCourse": [],
    "next": {
      "newMoon": "2026-10-10T15:50:05Z",
      "firstQuarter": "2026-10-18T16:12:41Z",
      "fullMoon": "2026-10-26T04:11:49Z",
      "lastQuarter": "2026-11-01T20:28:27Z"
    },
    "meaning": "The close of the cycle: rest, cleansing and preparing for the new.",
    "keywords": [
      "rest",
      "cleansing",
      "intuition",
      "completion"
    ],
    "localized": {
      "phaseName": "Спадний серп",
      "moonSign": "Лев",
      "sunSign": "Терези",
      "meaning": "Завершення циклу: відпочинок, очищення й підготовка до нового.",
      "keywords": [
        "відпочинок",
        "очищення",
        "інтуїція",
        "завершення"
      ]
    }
  },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

400

Section titled “400 ”

Invalid sign or date

Media type application/json
Example 
{
  "ok": false,
  "error": {
    "code": "INVALID_SIGN",
    "message": "sign must be one of the 12 zodiac signs"
  }
}
Корисно?
Запропонувати правку