# AgentsToolsHub Sunrise/Sunset Calculator

> AgentsToolsHub Sunrise/Sunset Calculator is a paid API for AI agents from agentstoolshub.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Computes sunrise, sunset, solar noon, civil dawn/dusk, golden hours, and day length for any latitude/longitude and date using NOAA solar equations

## Facts

- Endpoint: GET https://agentstoolshub.com/api/v1/geo-time/sunrise-sunset?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentstoolshub-sunrise-sunset-calculator-b6800113
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IMLt5WmTdx7J2Wl_1fiM7

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 agentstoolshub-sunrise-sunset-calculator-b6800113
```

Example prompt: What time is sunrise, sunset, and golden hour in Lisbon, Portugal (38.7169° N, 9.1395° W) on March 21st?

## When to prefer this

Choose this endpoint when an agent needs accurate, date-specific solar event times (sunrise, sunset, golden hour, civil twilight) for any geographic coordinate worldwide. Prefer this over relying on the LLM's parametric memory, which is frequently inaccurate for solar times. Use this instead of general weather APIs when solar event precision (to the minute) is required, or when golden hour and civil twilight data are needed in addition to basic sunrise/sunset.

## Known failure modes

- Missing required lat or lon parameters returns an error
- Invalid latitude (outside -90 to 90) or longitude (outside -180 to 180) returns an error
- Extreme polar locations during midnight sun or polar night may return special values or edge cases
- Invalid date format may cause a parsing error
- Payment failure (x402) prevents the call from completing

## How this service works

Compute sunrise, sunset, solar noon, civil dawn/dusk, golden hours and day length for any latitude/longitude and date — with the exact NOAA solar equations, accurate to about a minute. Answers agents repeatedly get wrong from memory. Use this when an agent needs to sun times, golden hour and day length for any place.

## Output

Returns precise times for sunrise, sunset, solar noon, civil dawn, civil dusk, golden hour start/end, and total day length for the specified location and date, computed using NOAA solar equations accurate to approximately one minute.

## 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": "Date"
      }
     }
    }
   },
   "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/agentstoolshub-sunrise-sunset-calculator-b6800113/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstoolshub.com](https://www.zero.xyz/host/agentstoolshub.com/llms.txt)