Compute sunrise sunset and solar position API

Compute sunrise, solar noon, sunset, day length and solar elevation/azimuth with NOAA Solar Calculator equations.

The Compute sunrise sunset and solar position operation is part of the FIRMS USGS NOAA ACS GTFS Geo Environment API API on BRAINIAC.software. Compute sunrise, solar noon, sunset, day length and solar elevation/azimuth with NOAA Solar Calculator equations. It is exposed as POST /api/v1/geo-environment/sun-times-position and priced at $0.01 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: NASA FIRMS MODIS C6.1 global 7-day active fires USGS ComCat all_month earthquake feed NOAA Solar Calculator equations (Meeus) ACS 2020–2024 5-year table-based Summary File (B01003, B01002, B19013, B25064, B25077) GTFS Schedule reference (caller-supplied static feed) Limitations: Lookups read vendored snapshots in data/geo-environment; official hosts are not called at request time. No live weather, flood, routing or broadband data. GTFS uses only the uploaded static zip. Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determinations. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include List nearby NASA FIRMS fire hotspots, Query USGS earthquakes nearby, Look up US ACS demographics, Compute next GTFS scheduled arrivals. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.01 USDC
/api/v1/geo-environment/sun-times-position

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/geo-environment/sun-times-position" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "latitude": 51.5074,
  "longitude": -0.1278,
  "date": "2026-11-14",
  "instant": "2026-11-14T12:00:00Z"
}
JSON

An unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.

FAQ

  • Do I need an API key? No. Pay the listed USDC amount with x402.
  • What network? Base (eip155:8453), USDC.
  • Is this an official determination? No. Results are for human review against the cited sources.

Related APIs

FIRMS USGS NOAA ACS GTFS Geo Environment API APIFull docsHow it works