Name: sunrise-sunset
Price: 0.002 USDC
Availability: InStock

$ man sunrise-sunset

agentutility / locale / sunrise-sunset

PRICE / CALL

$0.002

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

locale

CATEGORY

uncategorized

STATUS

● live

NAME

sunrise-sunset — sunrise sunset times

SYNOPSIS

POST https://x402.org/v1/sunrise-sunset
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Sunrise sunset times. Returns sunrise, sunset, solar noon, day length, and civil / nautical / astronomical twilight begin and end for any latitude/longitude on any date. Also covers golden-hour and dawn / dusk. Same backend as astro-times under a more search-friendly slug. UTC ISO8601 strings.

INPUT — request schema

property	type	description	req?
latitude	number	Latitude in decimal degrees (-90 to 90, positive north) for the location to compute sun times.	required
longitude	number	Longitude in decimal degrees (-180 to 180, positive east) for the location to compute sun times.	required
date	string	Calendar date as YYYY-MM-DD for which to compute sunrise, sunset, twilight, and golden-hour times.	optional

OUTPUT — response shape

field	type	description
date	string	Echo of the requested YYYY-MM-DD date the returned solar times apply to.
times	string	Object of UTC ISO8601 timestamps: sunrise, sunset, solar noon, day length, twilight phases, golden hour, dawn, dusk.
source	string	Identifier of the solar algorithm or library used to compute the returned times.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/sunrise-sunset \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the sunrise-sunset tool to ..."

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: localesunrise-sunsetsolar-timestwilightgolden-hourday-lengthastronomygeolocation
methods: POST
cluster: locale
price: $0.002 USDC per call

ADJACENT — other endpoints in locale

endpoint	description	price
astro-times	sunrise-sunset / golden-hour / civil twilight / nautical dusk / day-length / solar-noon / dawn-dusk / astronomy times.	$0.002
country-info	Country info / ISO 3166 / country code lookup / capital city lookup / currencies by country / population / region resolver.	$0.002
earthquakes-recent	Earthquake feed / seismic activity / USGS / recent quakes / quake monitor / tremor data / fault line activity / tsunami alerts.	$0.002
holiday-lookup	Public holidays / bank holidays / national holidays / federal holidays / holiday calendar / per-country dates.	$0.002
timezone-convert	Timezone convert / IANA tz conversion / DST-aware time arithmetic / wall-clock to UTC / convert across cities.	$0.001
timezone-lookup	Timezone lookup / IANA tz / UTC offset / DST status / local time at lat-lng / which timezone.	$0.001
iata-airport-info	IATA / ICAO airport code lookup.	$0.005
satellite-tile	Satellite imagery tile / lat-lon to satellite PNG / Sentinel-2 tile API / cloud-free satellite snapshot / agent-callable satellite imagery.	$0.005

/sunrise-sunset(1)