Try Astrologer API

Subscribe to support and grow the project.

v5 Astrologer API Documentation
Get API Key

Moon Phase Context Example #

Endpoint: /api/v5/moon-phase/context

Request Body #

{
  "year": 1993,
  "month": 10,
  "day": 10,
  "hour": 12,
  "minute": 12,
  "second": 0,
  "latitude": 51.5074,
  "longitude": -0.1278,
  "timezone": "Europe/London"
}

Response Body #

{
  "status": "OK",
  "context": "<moon_phase_overview timestamp=\"750251520\" datestamp=\"Sun, 10 Oct 1993 11:12:00 +0000\">\n  <moon>\n    <phase>0.807</phase>\n    <phase_name>Waning Crescent</phase_name>\n    <major_phase>Last Quarter</major_phase>\n    <stage>waning</stage>\n    <illumination>32%</illumination>\n    <age_days>10</age_days>\n    <lunar_cycle>80.736%</lunar_cycle>\n    <emoji>\ud83c\udf18</emoji>\n    <zodiac sun_sign=\"Lib\" moon_sign=\"Leo\" />\n    <next_lunar_eclipse timestamp=\"754554366\" datestamp=\"Mon, 29 Nov 1993 06:26:06 +0000\" type=\"Total Lunar Eclipse\" />\n    <detailed>\n      <upcoming_phases>\n        <new_moon>\n          <last timestamp=\"749415231\" datestamp=\"Thu, 30 Sep 1993 18:53:51 +0000\" days_ago=\"10\" />\n          <next timestamp=\"750684955\" datestamp=\"Fri, 15 Oct 1993 11:35:55 +0000\" days_ahead=\"5\" />\n        </new_moon>\n        <first_quarter>\n          <last timestamp=\"750108919\" datestamp=\"Fri, 08 Oct 1993 19:35:19 +0000\" days_ago=\"2\" />\n          <next timestamp=\"751279921\" datestamp=\"Fri, 22 Oct 1993 08:52:01 +0000\" days_ahead=\"12\" />\n        </first_quarter>\n        <full_moon>\n          <last timestamp=\"748149015\" datestamp=\"Thu, 16 Sep 1993 03:10:15 +0000\" days_ago=\"24\" />\n          <next timestamp=\"751984658\" datestamp=\"Sat, 30 Oct 1993 12:37:38 +0000\" days_ahead=\"20\" />\n        </full_moon>\n        <last_quarter>\n          <last timestamp=\"748726326\" datestamp=\"Wed, 22 Sep 1993 19:32:06 +0000\" days_ago=\"18\" />\n          <next timestamp=\"752654150\" datestamp=\"Sun, 07 Nov 1993 06:35:50 +0000\" days_ahead=\"28\" />\n        </last_quarter>\n      </upcoming_phases>\n      <illumination_details percentage=\"32.0\" visible_fraction=\"0.3237\" phase_angle=\"290.65\" />\n    </detailed>\n  </moon>\n  <sun>\n    <sunrise>750233758</sunrise>\n    <sunrise_timestamp>07:15</sunrise_timestamp>\n    <sunset>750273488</sunset>\n    <sunset_timestamp>18:18</sunset_timestamp>\n    <solar_noon>12:47</solar_noon>\n    <day_length>11:02</day_length>\n    <position altitude=\"31.25\" azimuth=\"169.67\" distance=\"149364727.19\" />\n    <next_solar_eclipse timestamp=\"753227093\" datestamp=\"Sat, 13 Nov 1993 21:44:53 +0000\" type=\"Partial Solar Eclipse\" />\n  </sun>\n  <location latitude=\"51.5074\" longitude=\"-0.1278\" precision=\"0\" using_default_location=\"false\" />\n</moon_phase_overview>",
  "moon_phase_overview": {
    "timestamp": 750251520,
    "datestamp": "Sun, 10 Oct 1993 11:12:00 +0000",
    "sun": {
      "sunrise": 750233758,
      "sunrise_timestamp": "07:15",
      "sunset": 750273488,
      "sunset_timestamp": "18:18",
      "solar_noon": "12:47",
      "day_length": "11:02",
      "position": {
        "altitude": 31.25357648244777,
        "azimuth": 169.66688621906792,
        "distance": 149364727.19422686
      },
      "next_solar_eclipse": {
        "timestamp": 753227093,
        "datestamp": "Sat, 13 Nov 1993 21:44:53 +0000",
        "type": "Partial Solar Eclipse",
        "visibility_regions": null
      }
    },
    "moon": {
      "phase": 0.8073589069399721,
      "phase_name": "Waning Crescent",
      "major_phase": "Last Quarter",
      "stage": "waning",
      "illumination": "32%",
      "age_days": 10,
      "lunar_cycle": "80.736%",
      "emoji": "\ud83c\udf18",
      "zodiac": {
        "sun_sign": "Lib",
        "moon_sign": "Leo"
      },
      "moonrise": null,
      "moonrise_timestamp": null,
      "moonset": null,
      "moonset_timestamp": null,
      "next_lunar_eclipse": {
        "timestamp": 754554366,
        "datestamp": "Mon, 29 Nov 1993 06:26:06 +0000",
        "type": "Total Lunar Eclipse",
        "visibility_regions": null
      },
      "detailed": {
        "position": null,
        "visibility": null,
        "upcoming_phases": {
          "new_moon": {
            "last": {
              "timestamp": 749415231,
              "datestamp": "Thu, 30 Sep 1993 18:53:51 +0000",
              "days_ago": 10,
              "days_ahead": null,
              "name": null,
              "description": null
            },
            "next": {
              "timestamp": 750684955,
              "datestamp": "Fri, 15 Oct 1993 11:35:55 +0000",
              "days_ago": null,
              "days_ahead": 5,
              "name": null,
              "description": null
            }
          },
          "first_quarter": {
            "last": {
              "timestamp": 750108919,
              "datestamp": "Fri, 08 Oct 1993 19:35:19 +0000",
              "days_ago": 2,
              "days_ahead": null,
              "name": null,
              "description": null
            },
            "next": {
              "timestamp": 751279921,
              "datestamp": "Fri, 22 Oct 1993 08:52:01 +0000",
              "days_ago": null,
              "days_ahead": 12,
              "name": null,
              "description": null
            }
          },
          "full_moon": {
            "last": {
              "timestamp": 748149015,
              "datestamp": "Thu, 16 Sep 1993 03:10:15 +0000",
              "days_ago": 24,
              "days_ahead": null,
              "name": null,
              "description": null
            },
            "next": {
              "timestamp": 751984658,
              "datestamp": "Sat, 30 Oct 1993 12:37:38 +0000",
              "days_ago": null,
              "days_ahead": 20,
              "name": null,
              "description": null
            }
          },
          "last_quarter": {
            "last": {
              "timestamp": 748726326,
              "datestamp": "Wed, 22 Sep 1993 19:32:06 +0000",
              "days_ago": 18,
              "days_ahead": null,
              "name": null,
              "description": null
            },
            "next": {
              "timestamp": 752654150,
              "datestamp": "Sun, 07 Nov 1993 06:35:50 +0000",
              "days_ago": null,
              "days_ahead": 28,
              "name": null,
              "description": null
            }
          }
        },
        "illumination_details": {
          "percentage": 32.0,
          "visible_fraction": 0.3236772895463642,
          "phase_angle": 290.64920649838996
        }
      },
      "events": null
    },
    "location": {
      "latitude": "52",
      "longitude": "0",
      "precision": 0,
      "using_default_location": false,
      "note": null
    }
  }
}