# Geo & Environment Lookups API > NASA FIRMS fire hotspots, USGS earthquakes, NOAA solar times/position, US ACS demographics, and next GTFS scheduled arrivals from vendored official data or pure computation. Each paid operation uses a fixed USDC price on Base with the x402 exact scheme. Unpaid GET, HEAD, and POST return 402 payment terms (POST validates the body only after payment terms are satisfied). A request that carries payment-signature is not yet charged: settlement happens only after a successful (2xx) result. HTTP 4xx/5xx are not charged. Coverage bodies with status complete, partial, or failed all return HTTP 200 and are charged at the full listed price. Settled 2xx responses include a payment-response header; 4xx/5xx do not. Follow https://www.brainiac.software/agent-instructions.txt for install, payment pins, idempotency, and billing rules. - Product: https://www.brainiac.software/api/geo-environment - Docs: https://www.brainiac.software/api/geo-environment/docs - OpenAPI: https://www.brainiac.software/api/geo-environment/openapi.json - Contact: support@brainiac.software (https://www.brainiac.software/contact) ## Operations ### POST /api/v1/geo-environment/fire-hotspots-nearby $0.03 USDC. List MODIS C6.1 active-fire detections within a radius from the vendored 7-day FIRMS snapshot. Inputs: latitude, longitude, radiusKm, from?, to?, minConfidence?, limit? Docs: https://www.brainiac.software/api/geo-environment/docs#geo-environment-fire-hotspots-nearby Example request: ```json { "latitude": 33.2613, "longitude": 131.64961, "radiusKm": 10 } ``` Example response: ```json { "count": 1, "detections": [ { "latitude": 33.2613, "longitude": 131.64961, "distanceKm": 0, "acquiredAt": "2026-11-08T00:28:00Z", "satellite": "Terra", "confidence": 0, "brightnessK": 307.73, "brightT31K": 289.01, "frpMw": 15.28, "dayNight": "D", "version": "6.1NRT" } ], "window": { "from": "2026-11-08", "to": "2026-11-15" }, "snapshotAt": "2026-11-15", "sources": [ { "source": "NASA FIRMS MODIS C6.1 Global 7-day active fires", "url": "https://firms.modaps.eosdis.nasa.gov/data/active_fire/modis-c6.1/csv/MODIS_C6_1_Global_7d.csv", "retrievedAt": "2026-11-15", "status": "ok" } ], "limitations": [ "Detections are NASA FIRMS MODIS C6.1 active-fire hotspots in the vendored 7-day window, not a confirmation of wildfire …" ] } ``` ### POST /api/v1/geo-environment/earthquake-query $0.03 USDC. Find earthquakes within a radius and time window from the vendored USGS all_month feed. Inputs: latitude, longitude, radiusKm, minMagnitude?, from?, to?, eventType?, sort?, limit? Docs: https://www.brainiac.software/api/geo-environment/docs#geo-environment-earthquake-query Example request: ```json { "latitude": 32.3376, "longitude": 93.7837, "radiusKm": 100, "minMagnitude": 4.5 } ``` Example response: ```json { "count": 1, "events": [ { "id": "us6000u43g", "time": "2026-10-22T14:33:40.289Z", "latitude": 32.3376, "longitude": 93.7837, "depthKm": 18, "magnitude": 7, "magType": "mww", "place": "189 km ENE of Nagqu, China", "type": "earthquake", "status": "reviewed", "network": "us", "distanceKm": 0, "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000u43g" } ], "window": { "from": "2026-10-16T10:15:38.430Z", "to": "2026-11-15T09:39:57.110Z" }, "snapshotAt": "2026-11-15", "sources": [ { "source": "USGS Earthquake Hazards Program ComCat all_month CSV", "url": "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_month.csv", "retrievedAt": "2026-11-15", "status": "ok" } ], "limitations": [ "Events come from the vendored USGS ComCat all_month feed; updated or deleted events reflect the snapshot only." ] } ``` ### POST /api/v1/geo-environment/sun-times-position $0.01 USDC. Compute sunrise, solar noon, sunset, day length and solar elevation/azimuth with NOAA Solar Calculator equations. Inputs: latitude, longitude, date?, instant?, timeZone? Docs: https://www.brainiac.software/api/geo-environment/docs#geo-environment-sun-times-position Example request: ```json { "latitude": 51.5074, "longitude": -0.1278, "date": "2026-11-14", "instant": "2026-11-14T12:00:00Z" } ``` Example response: ```json { "date": "2026-11-14", "sunrise": "2026-11-14T07:17:02Z", "solarNoon": "2026-11-14T11:44:54Z", "sunset": "2026-11-14T16:12:46Z", "dayLengthMinutes": 535.7, "polar": null, "position": { "elevationDeg": 20.12, "azimuthDeg": 183.82, "declinationDeg": -18.299 }, "accuracy": "±1 min within ±72° latitude, ±10 min outside", "method": "NOAA Solar Calculator equations (Meeus); geometric elevation without refraction correction", "sources": [ { "source": "NOAA Global Monitoring Laboratory Solar Calculator", "url": "https://gml.noaa.gov/grad/solcalc/calcdetails.html", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Times are computed, not observed. Polar day/night returns null sunrise/sunset." ] } ``` ### POST /api/v1/geo-environment/us-acs-demographics $0.03 USDC. Return selected ACS 2020–2024 5-year estimates and margins of error for a US state, county or ZCTA. Inputs: geography, code Docs: https://www.brainiac.software/api/geo-environment/docs#geo-environment-us-acs-demographics Example request: ```json { "geography": "zcta", "code": "10001" } ``` Example response: ```json { "geoId": "860Z200US10001", "geography": "zcta", "vintage": "ACS 2020-2024 5-year", "values": { "totalPopulation": { "estimate": 30511, "moe": 1797 }, "medianAge": { "total": { "estimate": 35.8, "moe": 1.1 }, "male": { "estimate": 36.3, "moe": 2 }, "female": { "estimate": 35.2, "moe": 1.9 } }, "medianHouseholdIncome": { "estimate": 129852, "moe": 25244 }, "medianGrossRent": { "estimate": 3361, "moe": 268 }, "medianHomeValue": { "estimate": 561100, "moe": 361292 } }, "sources": [ { "source": "ACS 2020–2024 5-year table-based Summary File (B01003, B01002, B19013, B25064, B25077)", "url": "https://www2.census.gov/programs-surveys/acs/summary_file/2024/table-based-SF/data/5YRData/", "retrievedAt": "2026-11-15", "status": "ok" } ], "limitations": [ "Vendored subset covers states, counties, and ZCTAs only; tracts and places are not included." ] } ``` ### POST /api/v1/geo-environment/gtfs-next-arrivals $0.04 USDC. Compute next scheduled arrivals at a stop from a caller-supplied static GTFS zip. No feeds are fetched. Inputs: gtfsZipBase64, stopId, at, limit?, includeChildStops? Docs: https://www.brainiac.software/api/geo-environment/docs#geo-environment-gtfs-next-arrivals Example request: ```json { "gtfsZipBase64": "UEsDBBQAAAAIALFSb127LvAxTgAAAF0AAAAKAAAAYWdlbmN5LnR4dEtMT81LrozPTNFJhLDyEnNTYezSohwYsyQzN7UqPy+Vy1HHJTU3XyejpKSg2EpfP7UiMbcgJ1UvOT9XxzE3tSgzOVHfL7U8PjK/KJsLAFBLAwQUAAAACACxUm9dagz5Sx0AAAAfAAAACQAAAHN0b3BzLnR4dCsuyS+Iz0zRKQbReYm5qVzBhjouqbn5CsFAES4AUEsDBBQAAAAIALFSb10nN74dLwAAADgAAAAKAAAAcm91dGVzLnR4dCvKLy1Jjc9M0UlMT81LrgSxisBCxRn5RSXxeYm5qVCBksqCVK4gQx1HHUMdYy4AUEsDBBQAAAAIALFSb11FdLkkOAAAAEwAAAAJAAAAdHJpcHMudHh0K8ovLUmNz0zRKU4tKstMBjNLijIL4HRGamJKcWZ6HleQoU64i06IoY5LfnleCRDDRIx0QgvAfABQSwMEFAAAAAgAsVJvXUTDtAROAAAAbgAAAA4AAABzdG9wX3RpbWVzLnR4dCspyiyIz0zRSSwqyixLzIkvycxN1UlJLUgsKiktSoVwi0vywWrAdHFqYWlqXnIqV4ihjoGFlYEBECEYwYY6hlwhRjpGplaGYAE4AywDAFBLAwQUAAAACACxUm9ddvAAwFkAAAB7AAAADAAAAGNhbGVuZGFyLnR4dD3LMQqAMAyF4b1nydBU8ATewbEUE7GDFdJU8fbaCPIP71teZTnzwjET7EehdIM2rn0vpvJJtyaGVXKfmrSJodmjahKNlJSBCxncPAH++bfgw+jRowHDgO4BUEsDBBQAAAAIALFSb13OfSiGLwAAAC0AAAASAAAAY2FsZW5kYXJfZGF0ZXMudHh0K04tKstMTo3PTNFJSSxJ1UmtSE4tKMnMz4svqSxI5Qp30TEyMDIzNDQy0zHiAgBQSwECFAMUAAAACACxUm9duy7wMU4AAABdAAAACgAAAAAAAAAAAAAApIEAAAAAYWdlbmN5LnR4dFBLAQIUAxQAAAAIALFSb11qDPlLHQAAAB8AAAAJAAAAAAAAAAAAAACkgXYAAABzdG9wcy50eHRQSwECFAMUAAAACACxUm9dJze+HS8AAAA4AAAACgAAAAAAAAAAAAAApIG6AAAAcm91dGVzLnR4dFBLAQIUAxQAAAAIALFSb11FdLkkOAAAAEwAAAAJAAAAAAAAAAAAAACkgREBAAB0cmlwcy50eHRQSwECFAMUAAAACACxUm9dRMO0BE4AAABuAAAADgAAAAAAAAAAAAAApIFwAQAAc3RvcF90aW1lcy50eHRQSwECFAMUAAAACACxUm9ddvAAwFkAAAB7AAAADAAAAAAAAAAAAAAApIHqAQAAY2FsZW5kYXIudHh0UEsBAhQDFAAAAAgAsVJvXc59KIYvAAAALQAAABIAAAAAAAAAAAAAAKSBbQIAAGNhbGVuZGFyX2RhdGVzLnR4dFBLBQYAAAAABwAHAJQBAADMAgAAAAA=", "stopId": "S1", "at": "2026-11-25T23:30:00-05:00", "limit": 2 } ``` Example response: ```json { "stop": { "id": "S1", "name": "Demo Stop" }, "timeZone": "America/New_York", "arrivals": [ { "tripId": "T2", "routeId": "R1", "routeShortName": "1", "headsign": "Uptown", "serviceDate": "2026-11-25", "scheduledArrival": "2026-11-26T01:10:00-05:00", "stopSequence": 1 }, { "tripId": "T1", "routeId": "R1", "routeShortName": "1", "headsign": "Downtown", "serviceDate": "2026-11-27", "scheduledArrival": "2026-11-27T08:00:00-05:00", "stopSequence": 1 } ], "warnings": [], "sources": [ { "source": "Caller-supplied GTFS Schedule feed (static)", "url": "https://gtfs.org/documentation/schedule/reference/", "retrievedAt": "2026-11-25", "status": "ok" } ], "limitations": [ "Pure computation on the uploaded static GTFS zip; no realtime trip updates are used." ] } ```