# Lilambd Koyomi Sun Position API

> Lilambd Koyomi Sun Position API 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 sun position and solar event data (sunrise, sunset, solar noon, etc.) for a given latitude, longitude, date, and timezone.

## Facts

- Endpoint: GET https://api.lilambd.com/koyomi/sun?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-sun-position-api-0ccd122e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2d8NNrHv3yla2vgrnemtV

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-sun-position-api-0ccd122e
```

Example prompt: What are the sunrise and sunset times for Paris, France (lat 48.8566, lon 2.3522) on June 21st in the Europe/Paris timezone?

## When to prefer this

Choose this endpoint when you need accurate solar event times (sunrise, sunset, solar noon, twilight) or sun position data for any geographic coordinate and date. Prefer it over generic weather APIs when the specific need is solar/astronomical timing rather than atmospheric conditions. It is well-suited for scheduling outdoor activities, photography planning, agricultural applications, or any context where precise sun position relative to a location is required.

## Known failure modes

- Missing required lat or lon parameters returns an error
- Invalid or out-of-range coordinates may return empty data or an error
- Unsupported or malformed timezone string may cause incorrect results or an error
- Invalid date format may result in no data returned
- Network or service unavailability returns a non-200 response
- Payment failure via x402 protocol blocks access

## 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 solar event data (such as sunrise, sunset, solar noon, dawn, dusk times) for the specified location and date, along with a count of entries and an attribution/license line for the data source.

## 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": [
      "lat",
      "lon"
     ],
     "properties": {
      "tz": {
       "type": "string",
       "description": "tz (number)"
      },
      "lat": {
       "type": "string",
       "description": "lat (number)"
      },
      "lon": {
       "type": "string",
       "description": "lon (number)"
      },
      "date": {
       "type": "string",
       "description": "date (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-sun-position-api-0ccd122e/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)