# Vietnamese Lunar Calendar Date Lookup

> Vietnamese Lunar Calendar Date Lookup is a paid API for AI agents from lunar-api-production-cba9.up.railway.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns full Vietnamese lunar calendar data for any given solar date (1900-2100), including lunar date, Can Chi, day quality, auspicious/inauspicious activities, and auspicious hours.

## Facts

- Endpoint: GET https://lunar-api-production-cba9.up.railway.app/v1/lunar/date
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vietnamese-lunar-calendar-date-lookup-a50ebfd6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KlyPdOtQWqpTDKwsEz_r4

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 vietnamese-lunar-calendar-date-lookup-a50ebfd6
```

Example prompt: What does the Vietnamese lunar calendar say about July 15, 2025 — give me the lunar date, Can Chi, whether it's a hoang dao or hac dao day, and what activities are auspicious or inauspicious?

## When to prefer this

Use this endpoint when you need detailed Vietnamese lunar calendar metadata for a specific historical, present, or future solar date anywhere between 1900 and 2100. Prefer this over the 'today' endpoint when the target date is not today, and over the 'auspicious day finder' endpoint when you have a specific date in mind rather than searching for the best date in a range.

## Known failure modes

- Date out of supported range (1900-2100) returns an error
- Missing required 'date' query parameter returns a 400 error
- Malformed date format (not YYYY-MM-DD) returns a parsing error
- Payment not provided or insufficient USDC returns 402 Payment Required

## How this service works

Vietnamese lunar calendar for ANY solar date (1900-2100): lunar date, Can Chi in Vietnamese, hoang dao / hac dao quality, good-for and bad-for activities, auspicious hours and solar term. Use for planning events, birthdays (am lich), anniversaries and BaZi context.

## Output

Returns the lunar date equivalent of the queried solar date, Can Chi (heavenly stems and earthly branches) in Vietnamese, day quality classification (hoang dao / hac dao), a list of activities that are auspicious (good-for) and inauspicious (bad-for) on that day, auspicious hours, and the solar term period.

## 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": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "date"
     ],
     "properties": {
      "date": {
       "type": "string",
       "description": "Solar date YYYY-MM-DD"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vietnamese-lunar-calendar-date-lookup-a50ebfd6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lunar-api-production-cba9.up.railway.app](https://www.zero.xyz/host/lunar-api-production-cba9.up.railway.app/llms.txt)