# Vextorium Moon Phase API

> Vextorium Moon Phase API is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-16).

Returns the moon phase name, illumination percentage, lunar age in days, and next new/full moon dates for a given date using local astronomical calculation.

## Facts

- Endpoint: POST https://api.vextorium.com/fase-lunar-pago?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-moon-phase-api-a7655f62
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZfO-bME3Nem24wrwkR2x5

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 vextorium-moon-phase-api-a7655f62 -d '<json body>'
```

Example prompt: What's the moon phase on July 4th, 2025 — is it a full moon, how illuminated is it, and when are the next new and full moons after that?

## When to prefer this

Choose this endpoint when you need fast, low-cost lunar phase data for a specific date including illumination percentage and upcoming phase dates, without needing real-time telescope or observatory data. Ideal for agents handling event planning, nature, astronomy queries, or calendar enrichment where ±1 day accuracy is acceptable.

## Known failure modes

- Invalid or missing date format returns an error — must be YYYY-MM-DD
- Dates far outside supported range may produce inaccurate or undefined results
- Network timeout if the service is temporarily unavailable
- Payment failure if insufficient USDC balance for x402 micropayment

## How this service works

Moon phase on a date: name, illuminated percentage, lunar age and the next new and full moon dates. Local astronomical calculation.

## Output

Returns a JSON object with the moon phase name (e.g. 'cuarto menguante'), illumination percentage, lunar age in days, the queried date, the date of the next full moon, the date of the next new moon, and a precision note indicating calculations are accurate to approximately ±1 day.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "fecha": {
   "type": "string",
   "description": "YYYY-MM-DD (default today)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fase": "cuarto menguante",
  "nota": "Cálculo medio (±1 día en las fechas de las fases).",
  "fecha": "2026-10-02",
  "edad_dias": 20.97,
  "iluminacion_pct": 62.4,
  "proxima_luna_llena": "2026-10-26",
  "proxima_luna_nueva": "2026-10-11"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-moon-phase-api-a7655f62/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)