Monthly moon-phase calendar API

Enumerate every principal lunar phase (new, first-quarter, full, last-quarter) falling within a given year + month, each with its exact UTC date/time and illumination fraction — the value-add being the full-month phase computation (vs a single-date phase). Differs from data/sun-moon which returns one date's phase plus sun rise/set. Answers 'when is the full moon this month', 'list all moon phases in January 2024', 'next new moon date'.

Price$0.01per request

MethodPOST

Route/v1/data/moon-calendar

StatusLive

MIME typeapplication/json

Rate limit60/minute

CacheNo cache

datamoonlunarphasecalendarfullmoonnewmoonastronomy

API URLhttps://x402.hexl.dev/v1/data/moon-calendar

Integration docs

Example request

{
  "year": 2024,
  "month": 1
}

Example response

{
  "year": 2024,
  "month": 1,
  "phaseCount": 4,
  "phases": [
    {
      "phase": "last-quarter",
      "date": "2024-01-03T19:15:13.719Z",
      "illumination": 0.5
    },
    {
      "phase": "new",
      "date": "2024-01-11T04:26:14.439Z",
      "illumination": 0
    },
    {
      "phase": "first-quarter",
      "date": "2024-01-18T13:37:15.158Z",
      "illumination": 0.5
    },
    {
      "phase": "full",
      "date": "2024-01-25T22:48:15.877Z",
      "illumination": 1
    }
  ],
  "synodicMonthDays": 29.530588853
}

Input schema

{
  "type": "object",
  "required": [
    "year",
    "month"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "examples": [
        2024
      ]
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "examples": [
        1
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}