# Lilambd Koyomi Range — Japanese Calendar Day Query

> Lilambd Koyomi Range — Japanese Calendar Day Query is a paid API for AI agents from api.lilambd.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-02).

Returns a list of traditional Japanese calendar days (koyomi) and their associated day-quality annotations within a specified date range, optionally filtered by timezone and day type.

## Facts

- Endpoint: GET https://api.lilambd.com/koyomi/range?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lilambd-koyomi-range-japanese-calendar-day-query-fe3fc0db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CIdEhyc4Z_JJOj14Y34BT

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 lilambd-koyomi-range-japanese-calendar-day-query-fe3fc0db
```

Example prompt: Can you find all 一粒万倍日 and 大安 days between January 1 and March 31 2025, using Tokyo time (Asia/Tokyo)?

## When to prefer this

Choose this endpoint when you need to look up or filter traditional Japanese calendar days (koyomi), including rokuyō cycle days (大安, 仏滅, etc.), auspicious days (一粒万倍日, 天赦日), or seasonal solar terms (立冬, 冬至) within a specific date range. It is ideal for cultural event planning, scheduling in Japan, or any application that needs to annotate dates with traditional almanac significance. Prefer it over generic calendar APIs when Japanese cultural day-quality metadata is required.

## Known failure modes

- Missing required 'from' or 'to' parameters returns an error
- Invalid date format for 'from' or 'to' may return empty results or an error
- Unknown or misspelled 'has' filter values return empty results
- Invalid timezone string in 'tz' may cause unexpected results or an error
- Date range too large may return empty or truncated results
- Payment not authorised (x402) returns a 402 response before data is served

## How this service works

A crossing for play, feeling, language, science and computation — creating states that do not have names yet.

## Output

A JSON object containing an array of calendar day records matching the query (data), a count of matching days, and an attribution string crediting the data source licence. Each record describes a specific date and its traditional Japanese calendar day quality or annotation.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "string",
       "description": "to (string)"
      },
      "tz": {
       "type": "string",
       "description": "tz (number)"
      },
      "has": {
       "type": "string",
       "description": "e.g. 一粒万倍日, 大安, 立冬"
      },
      "from": {
       "type": "string",
       "description": "from (string)"
      }
     },
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [],
  "count": 0,
  "attribution": "source licence line"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lilambd-koyomi-range-japanese-calendar-day-query-fe3fc0db/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.lilambd.com](https://www.zero.xyz/host/api.lilambd.com/llms.txt)