# x402.forgemesh.io Sun & Moon Times

> x402.forgemesh.io Sun & Moon Times 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-15).

Returns sunrise, sunset, solar noon, golden hour, moon phase, illumination fraction, moonrise, moonset, next full moon, and next new moon for any lat/lon and date — computed locally with no upstream dependency.

## Facts

- Endpoint: POST https://x402.forgemesh.io/sun-moon-times
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-forgemesh-io-sun-moon-times-8cba79de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QO0QAV-dMRNWjIdDfAgyZ

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 x402-forgemesh-io-sun-moon-times-8cba79de -d '<json body>'
```

Example prompt: What are the sunrise, sunset, golden hour, and moon phase details for latitude 47.6062, longitude -122.3321 on July 4th?

## When to prefer this

Prefer this endpoint when you need comprehensive solar and lunar data in a single call — especially sunrise/sunset, golden hour, and moon phase together — without relying on third-party astronomy APIs. Ideal for photography scheduling, agricultural planning, or outdoor event coordination when low latency and no upstream dependency are priorities.

## Known failure modes

- Missing latitude or longitude returns a validation error
- Invalid date format (non-ISO) returns a parsing error
- Coordinates out of valid range (-90 to 90 lat, -180 to 180 lon) may return an error
- Payment not included or insufficient USDC results in 402 Payment Required

## How this service works

Sun & moon API: sunrise, sunset, solar noon, evening golden hour, moon phase name, and moon illumination fraction for any latitude/longitude and date — computed locally, instant, no upstream. For photography scheduling, agriculture, solar estimation, astronomy content, and outdoor-event agents.

## Output

A JSON object containing: sunrise and sunset times, solar noon, evening golden hour window, moon phase name (e.g. 'Waxing Gibbous'), moon illumination fraction (0–1), moonrise and moonset times, date of next full moon, and date of next new moon — all computed for the given coordinates and date.

## 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/x402-forgemesh-io-sun-moon-times-8cba79de/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)