Name: astro-times
Price: 0.002 USDC
Availability: InStock

$ man astro-times

agentutility / locale / astro-times

PRICE / CALL

$0.002

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

locale

CATEGORY

uncategorized

STATUS

● live

NAME

astro-times — sunrise-sunset / golden-hour / civil twilight / nautical dusk / day-length / solar-noon / dawn-dusk / astronomy times

SYNOPSIS

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

     { ... }

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

DESCRIPTION

sunrise-sunset / golden-hour / civil twilight / nautical dusk / day-length / solar-noon / dawn-dusk / astronomy times. Computes sunrise, sunset, solar noon, day length (seconds), and civil / nautical / astronomical twilight begin & end for any latitude/longitude on any date. UTC ISO8601 strings. Wraps sunrise-sunset.org's public API — no auth, commercial-OK.

INPUT — request schema

property	type	description	req?
latitude	number	Decimal degrees, range [-90, 90]. Positive north.	required
longitude	number	Decimal degrees, range [-180, 180]. Positive east.	required
date	string	Date in YYYY-MM-DD. Defaults to today (UTC) if omitted.	optional

OUTPUT — response shape

field	type	description
date	string	ISO date (YYYY-MM-DD) the astronomical times were computed for, echoed from the request.
location	string	Latitude/longitude pair the times were computed for, echoed from the request.
times	string	Object mapping each event (sunrise, sunset, solar_noon, day_length, civil/nautical/astronomical twilight begin & end) to UTC ISO8601 strings.
source	string	Upstream data provider, sunrise-sunset.org's public API.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/astro-times \
  -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 astro-times tool to ..."

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

METADATA

tags: localeastronomysunrise-sunsetgolden-hourtwilightsolar-noonday-length
methods: POST
cluster: locale
price: $0.002 USDC per call

ADJACENT — other endpoints in locale

endpoint	description	price
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
sunrise-sunset	Sunrise sunset times.	$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

/astro-times(1)