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.
/api/v1/geo-environment/sun-times-positionExample 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"
}
JSONAn 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 operations
- List nearby NASA FIRMS fire hotspots — $0.03 USDC
- Query USGS earthquakes nearby — $0.03 USDC
- Look up US ACS demographics — $0.03 USDC
- Compute next GTFS scheduled arrivals — $0.04 USDC
Related APIs
- Building Energy & Facilities Intelligence API
- Electricity Market & Grid Intelligence API
- Electrical Engineering & Installation Intelligence API
FIRMS USGS NOAA ACS GTFS Geo Environment API APIFull docsHow it works