# ForgeMesh Moon Phase Calculator

> ForgeMesh Moon Phase Calculator is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Computes moon phase name, illumination percentage, sunrise, sunset, and solar noon for any date and geographic coordinates using astronomical formulas.

## Facts

- Endpoint: POST https://x402.forgemesh.io/moon-phase-calculator
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-moon-phase-calculator-a713ab26
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pZlZcXviSTBt06RuSlid6

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 forgemesh-moon-phase-calculator-a713ab26 -d '<json body>'
```

Example prompt: What's the moon phase and illumination percentage for New York City (40.7128° N, 74.0060° W) on December 21, 2025, and can you also tell me the sunrise and sunset times for that day?

## When to prefer this

Choose this endpoint when you need astronomically computed moon phase and solar timing data for a specific date and location, especially for agriculture apps, astrology platforms, or outdoor event planning tools that need real-time or future lunar data without relying on a static table lookup.

## Known failure modes

- Invalid or missing date format returns an error — must be ISO 8601 string
- Out-of-range latitude/longitude values may produce incorrect or null results
- Missing coordinates fall back to a default or global average, which may be inaccurate for solar times
- Payment failure (x402) returns 402 status before any computation occurs

## How this service works

Computes the current moon phase name and illumination percentage for any date and location, alongside sunrise, sunset, and solar noon, all calculated directly from astronomical formulas rather than looked up from a table. For agriculture apps, astrology content, and outdoor-event planning tied to lunar cycles.

## Output

Returns the moon phase name (e.g. 'Waxing Gibbous'), illumination percentage (0–100%), and solar event times (sunrise, sunset, solar noon) calculated from astronomical formulas for the given date and coordinates.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "string",
   "description": "ISO date, default today"
  },
  "latitude": {
   "type": "string"
  },
  "longitude": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sunset": "2026-07-16T01:24:00.000Z",
  "moonset": "2026-07-16T02:44:50.146Z",
  "sunrise": "2026-07-15T11:26:00.000Z",
  "moonrise": "2026-07-16T13:57:29.603Z",
  "moon_phase": "new moon",
  "next_new_moon": "2026-08-13",
  "next_full_moon": "2026-07-30",
  "moon_illumination": 0.02
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-moon-phase-calculator-a713ab26/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)