# Sun Times by Coordinates

> Sun Times by Coordinates is a paid API for AI agents from land-survey.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Returns sunrise, sunset, civil twilight times, solar noon, and day length for a given latitude/longitude and date, in both UTC and a specified local UTC offset.

## Facts

- Endpoint: GET https://land-survey.x402tookit.com/sun-times?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sun-times-by-coordinates-5b062bc8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3S_kqaF8dPigQVGOQBd15

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 sun-times-by-coordinates-5b062bc8
```

Example prompt: What time is sunrise and sunset at latitude 37.7749, longitude -122.4194 on June 21, 2025, and show me the local times at UTC-7?

## When to prefer this

Use this endpoint when you need precise astronomical sun-times (sunrise, sunset, civil twilight, solar noon, day length) for any geographic coordinate and date, especially when both UTC and local-clock-time representations are needed in the same response. It is ideal for land survey workflows, outdoor scheduling, solar energy assessments, and construction planning where the x402 micropayment model is already in use.

## Known failure modes

- Missing required lat or lon parameters returns an error
- Invalid date format (not YYYY-MM-DD) causes a parse error
- Coordinates outside valid range (-90 to 90 lat, -180 to 180 lon) may return errors
- Polar locations on dates with midnight sun or polar night may return edge-case or null sunrise/sunset values
- Network or service downtime returns a non-200 response

## How this service works

Sunrise, sunset, civil twilight and day length for a latitude/longitude and date, in UTC and a chosen UTC offset.

## Output

A JSON object containing sunrise and sunset times in UTC and local clock time, civil twilight start and end in both UTC and local time, solar noon in UTC, total day length in minutes, the requested date, coordinates, and UTC offset used. May include degraded-data flags, reasons, and a summary verdict if data quality issues exist.

## 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": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "description": "Latitude"
      },
      "lon": {
       "type": "number",
       "description": "Longitude"
      },
      "date": {
       "type": "string",
       "description": "YYYY-MM-DD, default today (UTC)"
      },
      "utc_offset_hours": {
       "type": "number",
       "description": "Show local clock times at this offset, e.g. -6"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "lat": {
       "type": [
        "null",
        "number"
       ]
      },
      "lon": {
       "type": [
        "null",
        "number"
       ]
      },
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "date": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "sunsetUtc": {
       "type": [
        "null",
        "string"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "sunriseUtc": {
       "type": [
        "null",
        "string"
       ]
      },
      "sunsetLocal": {
       "type": [
        "null",
        "string"
       ]
      },
      "solarNoonUtc": {
       "ty
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sun-times-by-coordinates-5b062bc8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from land-survey.x402tookit.com](https://www.zero.xyz/host/land-survey.x402tookit.com/llms.txt)