# fittings Sunrise/Sunset Times

> fittings Sunrise/Sunset Times is a paid API for AI agents from fittings.sh, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Returns UTC sunrise, sunset, solar noon, and day length for any date and geographic coordinate, including polar day and night handling.

## Facts

- Endpoint: GET https://fittings.sh/v1/time/sunrise-sunset
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fittings-sunrise-sunset-times-02518ce4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_szuSFE2yTz0kA2ddS4TAe

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 fittings-sunrise-sunset-times-02518ce4
```

Example prompt: What time does the sun rise and set in Reykjavik, Iceland on June 21, 2025 — and will it actually get dark that night?

## When to prefer this

Choose this endpoint when you need precise UTC solar event times (sunrise, sunset, solar noon, day length) for any date and coordinate worldwide, especially when polar regions and their edge cases (midnight sun, polar night) need to be handled correctly. Prefer this over general weather APIs that may only return local-time approximations or lack polar handling.

## Known failure modes

- Invalid date format (not YYYY-MM-DD) returns a 400 error
- Latitude out of range (-90 to 90) or longitude out of range (-180 to 180) returns a validation error
- Missing required query parameters (date, lat, or lon) returns a 400 bad request
- Extreme polar coordinates may return polar day or polar night flags with null sunrise/sunset times
- Payment failure or insufficient USDC balance returns a 402 Payment Required

## How this service works

UTC sunrise, sunset, solar noon and day length for a date and coordinate, including polar day/night.

## Output

Returns UTC times for sunrise, sunset, and solar noon for the specified date and coordinate, along with the total day length in seconds or human-readable form, and flags for polar day (sun never sets) or polar night (sun never rises).

## 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",
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number"
      },
      "lon": {
       "type": "number"
      },
      "date": {
       "type": "string",
       "description": "ISO date YYYY-MM-DD"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fittings-sunrise-sunset-times-02518ce4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fittings.sh](https://www.zero.xyz/host/fittings.sh/llms.txt)