# MoneyTools Lunar Date Converter

> MoneyTools Lunar Date Converter is a paid API for AI agents from tools.moneytools.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-05).

Converts dates between Gregorian (solar) and Chinese lunar calendar (農曆), including leap months, 干支 year, and zodiac sign

## Facts

- Endpoint: GET https://tools.moneytools.dev/v1/lunar?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-05
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/moneytools-lunar-date-converter-f42ad753
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BinUCFNSZvxBc7WZ6ggTy

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 moneytools-lunar-date-converter-f42ad753
```

Example prompt: What is the Gregorian date for the 15th day of the 8th lunar month in 2026? I want to know when Mid-Autumn Festival (中秋節) falls that year.

## When to prefer this

Use this endpoint when you need authoritative Gregorian ↔ Chinese lunar calendar conversion with full support for leap months (閏月), 干支 year names, and zodiac signs. It is especially suited for finding exact solar dates of traditional Chinese holidays like 中秋節 or 春節, or annotating dates with Chinese calendar metadata. Prefer this over generic date libraries that lack leap month handling or 干支 support.

## Known failure modes

- Invalid date format returns an error (date must be YYYY-MM-DD)
- Lunar date out of supported range returns an error
- Leap month flag set for a non-leap month returns an error
- Missing required parameters (no date and no lunar year/month/day combo) defaults to today in Taipei timezone
- Free tier exhausted (10/day) requires x402 payment or API key; without payment returns HTTP 402

## How this service works

Lunar (農曆) date converter: Gregorian ↔ Chinese lunar date (incl. leap months) with 干支 year and zodiac; e.g. find the solar date of 中秋 (8/15). Free tier 10/day; then $0.001 via x402 (HTTP 402 + PAYMENT-REQUIRED) or X-API-Key credits. Not charged on failure. $0.001 USDC per call via x402 on Base. Run by MoneyTools.

## Output

A JSON object containing the converted date in both Gregorian and Chinese lunar formats, the 干支 (sexagenary) year name, Chinese zodiac animal, leap month status, and payment metadata including whether the free tier was used or a $0.001 USDC charge was made.

## 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": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "date": {
       "type": "string",
       "examples": [
        "2026-11-04"
       ],
       "description": "YYYY-MM-DD (default today, Taipei)"
      },
      "leap": {
       "type": "boolean",
       "examples": [
        "false"
       ],
       "description": "leap month"
      },
      "lunarDay": {
       "type": "string",
       "description": "1-30"
      },
      "lunarYear": {
       "type": "string",
       "description": "for lunar→solar"
      },
      "lunarMonth": {
       "type": "string",
       "description": "1-12"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "properties": {
      "payment": {
       "type": "object",
       "properties": {
        "charged": {
         "type": "boolean"
        },
        "network": {
         "type": "string"
        },
        "amountUsd": {
         "type": "string"
        },
        "transaction": {
         "type": [
          "string",
          "null"
         ]
        }
       }
      },
      "freeTier": {
       "type": "object"
      },
      "_moneytools": {
       "type": "object",
       "description": "optional plan / partner hints"
      }
     },
     "description": "Tool-specific JSON result (see llms.txt / openapi.json). Always includes payment info.",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/moneytools-lunar-date-converter-f42ad753/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.moneytools.dev](https://www.zero.xyz/host/tools.moneytools.dev/llms.txt)