# Moon Phase & Illumination Lookup

> Moon Phase & Illumination Lookup is a paid API for AI agents from time.memoryapi.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns current and upcoming moon phases (New Moon, First Quarter, Full Moon, Last Quarter) plus current lunar illumination percentage, sourced from the US Naval Observatory.

## Facts

- Endpoint: GET https://time.memoryapi.org/x402/time/moon
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/time-memoryapi-org-74c97688
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6Kno6nnibDy_Pa9swUwSq

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 time-memoryapi-org-74c97688
```

Example prompt: What phase is the moon in right now, and when are the next New Moon, First Quarter, Full Moon, and Last Quarter dates? Also tell me the current illumination percentage.

## When to prefer this

Choose this endpoint when you need authoritative moon phase dates and current lunar illumination from the US Naval Observatory. Ideal for calendar apps, astronomy tools, gardening or farming planners, photography planners, or any use case requiring lunar cycle data without a full ephemeris service.

## Known failure modes

- Network or upstream US Naval Observatory data unavailability returning a 5xx error
- Invalid or malformed date parameter returning a 4xx error
- Payment not processed (402 Payment Required) if x402 micropayment fails

## How this service works

Time, astronomy, and moon phase data via x402 micropayments. Powered by TimeAPI.io and US Naval Observatory.

## Output

Returns the four key lunar phase dates (New Moon, First Quarter, Full Moon, Last Quarter) in the current lunar cycle, plus the moon's current illumination as a percentage. Data is sourced from the US Naval Observatory.

## Example request

```json
{
 "date": "2024-01-15",
 "count": 4
}
```

## Response schema (JSON Schema)

```json
{
 "example": {
  "date": "2025-05-29",
  "phases": [
   {
    "date": "2025-06-11",
    "phase": "Full Moon",
    "time_utc": "07:44"
   }
  ],
  "source": "US Naval Observatory",
  "success": true,
  "next_phase": {
   "date": "2025-06-11",
   "name": "Full Moon",
   "time_utc": "07:44",
   "days_away": 13
  },
  "illumination_percent": 72
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/time-memoryapi-org-74c97688/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from time.memoryapi.org](https://www.zero.xyz/host/time.memoryapi.org/llms.txt)