# fittings Lunar Moon Times

> fittings Lunar Moon Times is a paid API for AI agents from fittings.sh, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-15).

Returns moon phase, illuminated fraction, distance, and UTC moonrise/moonset times for a given date and geographic coordinate.

## Facts

- Endpoint: GET https://fittings.sh/v1/lunar/moon-times
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fittings-lunar-moon-times-2135fe2e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RvXsY-zWc8mHdow8HrHLT

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fittings-lunar-moon-times-2135fe2e
```

Example prompt: What's the moon phase, how much of it is illuminated, and when does it rise and set on July 4th 2025 at latitude 40.7128, longitude -74.0060?

## When to prefer this

Choose this endpoint when you need precise lunar data (phase, illumination, distance, rise/set times) for a specific geographic location and date — especially useful for astrophotography planning, outdoor event scheduling, fishing/hunting trip optimization, or any application requiring accurate moonrise/moonset times correlated with a coordinate. It combines multiple lunar metrics in one call, avoiding the need to query separate astronomy APIs.

## Known failure modes

- Missing required query parameters (date, lat, or lon) returns a 400 error
- Date not in ISO YYYY-MM-DD format returns a parsing error
- Latitude outside -90 to 90 or longitude outside -180 to 180 returns a validation error
- Payment not provided or insufficient funds returns a 402 Payment Required response
- Dates far in the past or future may return no moonrise/moonset if the moon doesn't rise or set at polar coordinates on that date

## How this service works

Moon phase, illuminated fraction, distance and UTC moonrise/moonset for a date and coordinate.

## Output

Returns the moon's current phase name, the illuminated fraction (0–1), the Earth–Moon distance in kilometers, and the UTC times of moonrise and moonset for the specified date and geographic coordinate.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "date",
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "description": "Latitude, -90 to 90"
      },
      "lon": {
       "type": "number",
       "description": "Longitude, -180 to 180"
      },
      "date": {
       "type": "string",
       "description": "ISO date YYYY-MM-DD, interpreted in UTC"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fittings-lunar-moon-times-2135fe2e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fittings.sh](https://www.zero.xyz/host/fittings.sh/llms.txt)